Agent-Skills.md

Agent Skills: Git Commit

Use when user asks to commit changes, create a git commit

UncategorizedID: catch6/ai-toolkits/git-commit

Repository

catch6/ai-toolkits
catch6License: MIT

Install this agent skill to your local

pnpm dlx add-skill https://github.com/catch6/ai-toolkits/tree/HEAD/skills/git-commit

Skill Files

Browse the full folder contents for git-commit.

Download Skill

Loading file tree…

skills/git-commit/SKILL.md

Skill Metadata

Name
git-commit
Description
'Use when user asks to commit changes, create a git commit'

Git Commit

Context

Git Status

<git-status> !`git status --porcelain --branch` </git-status>

Git Diff

<git-diff-stat> !`git diff --stat HEAD 2>/dev/null || echo "(no commits yet — all files are new)"` </git-diff-stat>

Git Log

<git-log> !`git log --oneline -5 2>/dev/null || echo "(no commits yet)"` </git-log>

Diff strategy

Read the last line of <git-diff-stat> for total insertions/deletions. Then:

  • ≤ 800 lines changed → git diff HEAD — read full diff
  • > 800 lines changed → Stat + status is enough. Only git diff HEAD -- <file> on ambiguous files
  • No commits yet (git-diff-stat shows "no commits yet") → Treat all files as new; use git diff --cached --stat after staging to assess size
  • All deletions (status shows only D or D ) → No diff needed — file names tell the story
  • Only untracked files (not in stat) → Only cat small/ambiguous ones; clear names need no reading
  • Binary files → Skip diff, note in commit message

When splitting into multiple commits and total > 800 lines, git diff HEAD -- <group-of-files> per logical group instead of full diff.

Stage and commit

  1. Nothing to commit → inform user, stop
  2. Single logical unit → one commit
  3. Multiple logical units → split into multiple commits with semantic grouping
  4. Untracked files / No commits yet → proactively group logically, directly git add <group> + git commit, no need to wait for user confirmation

Commit message

  • Conventional Commits: feat:, fix:, chore:, refactor:, test:, docs:, etc.

  • Type/scope in English, description in Chinese: feat(auth): 添加用户登录功能

  • 10+ files → add body listing key changes

  • Every commit MUST end with a Co-Authored-By trailer — match current agent:

    | Agent | Trailer | | ----------- | -------------------------------------------------- | | Claude Code | Co-Authored-By: ClaudeCode noreply@anthropic.com | | OpenCode | Co-Authored-By: OpenCode noreply@opencode.ai | | KiloCode | Co-Authored-By: KiloCode noreply@kilo.ai |

  • Always HEREDOC (trailer is inside the heredoc, not outside):

    git commit -m "$(cat <<'EOF'
type(scope): 描述

- 变更说明

Co-Authored-By: OpenCode noreply@opencode.ai
EOF
)"

Safety

  • NEVER force push, skip hooks, run destructive commands, or update git config without explicit request
  • Hook failure → fix issue, create NEW commit (never amend)