git commit skill

Generate precise git commit messages following Conventional Commits with auto language detection, scope inference, and multi-module support.

Security Scan

The skill's requests and instructions are coherent with a git commit message generator, but it has a couple of unexpected defaults (always-fall-back-to-Chinese language and a forced Co-Authored-By line) that you should review before use.

Purpose & Capability

Name/description line up with the runtime instructions: the skill inspects git status/diff/log and generates Conventional Commit messages. The requirement to analyze repo files and git history is expected. Unusual but not breaking: it defaults to Chinese when language cannot be detected and mandates including a Co-Authored-By line (Claude code <[e-mail]>) in every commit message by example — this is not necessary for core functionality and is unexpected.

Instruction Scope

SKILL.md limits actions to git commands (git status, git diff --staged, git log) and message generation, and instructs to present results for user approval before committing. It does not ask to read unrelated system files or environment variables. The notable scope creep is the built-in policy to always use a HEREDOC and to include a Co-Authored-By attribution in the commit message by default; that is a behavioral choice (affects commit content) rather than an external data exfiltration step, but you should verify you want that attribution inserted.

Install Mechanism

Instruction-only skill with no install spec and no code files — lowest-risk installation footprint (nothing is written to disk by an installer).

Credentials

The skill requests no environment variables, no credentials, and no config paths. It only reads repository-local git state (diffs/logs) which is appropriate for commit message generation.

Persistence & Privilege

Skill is not always-enabled and does not request system-wide persistence. It does, however, include instructions to create new commits (and a sample commit command that injects a Co-Authored-By line). If the agent is allowed to invoke skills autonomously, it could create commits; ensure autonomy settings and the SKILL.md's 'await user approval' step are enforced to avoid unexpected commits.

Assessment

This skill appears to do what it says: inspect the repository and generate Conventional Commit messages. Before installing or using it: (1) Confirm you are OK with the default language behavior — the skill falls back to Chinese if it can't detect language. (2) Remove or change the example Co-Authored-By line if you do not want an automatic attribution added to your commits. (3) Test the skill in a disposable/local repo first to verify the exact commit commands it runs. (4) If you do not want automatic commits, keep agent autonomous invocation disabled or ensure the skill respects the 'await user approval' step.

Git Commit Message Generator

Generate conventional commit messages with automatic language style detection.

Commit Format

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Types: feat fix docs style refactor perf test build ci chore revert

Rules:

• Type: lowercase English
• Description: <72 chars, imperative mood, no period
• Body: explain what/why, not how

Content Requirements:

• Concise: Summarize clearly, no redundant words
• Complete: Don't omit important changes
• Numbered: Multiple changes use 1. 2. 3. format
• Specific: Must clearly indicate which modules/files were modified

Module Reference Format:

• For each change, specify the affected module or file
• Format: <Action> <module/file>
• Example: Fix bug in UserService, Update Button component

Language Detection

Auto-detect by checking recent commits:

git log -10 --oneline

Detection Logic:

1. If recent commits contain Chinese characters → Use Chinese
2. If unable to determine → Default to Chinese

Style	Format Example
English	feat(api): add user authentication endpoint
Chinese	feat(用户管理): 添加登录功能

Language Rules:

• Type: Always English (feat, fix, refactor)
• Scope: Follow project style (English/Chinese)
• Description/Body: Chinese by default, or match project language

Workflow

1. Parallel Analysis (single response)

git status
git diff --staged
git log -10 --oneline

2. Smart Type Inference

Pattern	Type
*.test.*, *.spec.*, __tests__/	test
package.json, *.lock	build
.github/, *.yml (CI)	ci
*.md, docs/, README*	docs
Only whitespace changes	style
Keywords: fix/bug/resolve	fix
Keywords: add/implement/create	feat
Keywords: refactor/extract	refactor
Keywords: optimize/cache/performance	perf

3. Scope Inference

Extract from file paths:

• src/api/user/* → (api) or (user)
• src/components/Button/* → (Button)
• src/views/目标管理/* → (目标管理)

4. Present & Confirm

Show the generated message and await user approval before committing.

Examples

English

feat(api): add user authentication endpoint

1. Implement JWT-based authentication in AuthService for login/logout.
2. Add token refresh mechanism and session management in TokenManager.
3. Update routes/auth.ts with authentication middleware.

Closes #123

Chinese

feat(用户管理): 添加登录功能

1. AuthService实现基于JWT的用户认证，支持登录和登出。
2. TokenManager添加令牌刷新机制和会话管理。
3. routes/auth.ts更新API路由增加认证中间件。

关联 #123

Multi-Module Example

fix: resolve null pointer and update UI

1. UserService修复空指针异常，添加用户数据验证。
2. components/UserList.vue更新列表渲染逻辑。
3. utils/validator.ts添加空值检查工具函数。

关联 #456

Git Safety

• NEVER use --no-verify unless explicitly requested
• NEVER amend commits - create NEW commits
• NEVER force push without explicit request
• ALWAYS use HEREDOC for commit messages
• Prefer git add <files> over git add .

Commit Command

git commit -m "$(cat <<'EOF'
<commit message>

Co-Authored-By: Claude code <[e-mail]>
EOF
)"