Agent-Skills.md

Agent Skills: Git Commit

Create well-organized git commits for all staged and unstaged changes. NEVER push.

UncategorizedID: mitch-mitchel/claude-starter/commit

Repository

mitch-mitchel/claude-starter
mitch-mitchel
1

Install this agent skill to your local

pnpm dlx add-skill https://github.com/mitch-mitchel/claude-starter/tree/HEAD/skills/commit

Skill Files

Browse the full folder contents for commit.

Download Skill

Loading file tree…

skills/commit/SKILL.md

Skill Metadata

Name
commit
Description
Create well-organized git commits for all staged and unstaged changes. NEVER push.

Git Commit

Create well-organized git commits for all staged and unstaged changes. NEVER push.

Process

  1. Run lint/format first using this priority:

    a. Local CLAUDE.md - Check for pre-commit-command: in repo's CLAUDE.md

    pre-commit-command: make lint

    b. Task runners - Check for and use if available:

    • make lint or make format (check Makefile for targets)
    • npm run lint or npm run format (check package.json scripts)
    • yarn lint / pnpm lint

    c. Pre-commit - If .pre-commit-config.yaml exists:

    pre-commit run --all-files

    d. Direct tools (fallback) - Run if config exists: | Config file | Command | |-------------|---------| | pyproject.toml with ruff | ruff check --fix . && ruff format . | | .eslintrc* or eslint.config.* | npx eslint --fix . | | .prettierrc* or prettier.config.* | npx prettier --write . | | .djlintrc or pyproject with djlint | djlint --reformat . | | biome.json | npx biome check --apply . |

  2. Stage any auto-fixed files before proceeding

  3. Understand all changes

    • Run git status (never use -uall flag)
    • Run git diff to understand modifications

  4. Group related changes into logical commits (by feature, fix, or concern)

  5. For each group:

    • Stage the relevant files with git add <files>
    • Commit with conventional commit format: type(scope?): description
    • Valid types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

  6. Show summary of commits created

Rules

  • Keep commits atomic - one logical change per commit
  • Write clear, concise commit messages (imperative mood)
  • Include scope when it adds clarity (e.g., feat(chat):, fix(docker):)
  • NEVER run git push - only stage and commit locally
  • If unsure how to group changes, ask the user
  • If lint/format fails after auto-fix, re-stage and retry

Known issues

macOS sandbox noise: You may see errors like zsh:1: operation not permitted: /tmp/claude-501/cwd-*. These are harmless - commands still execute correctly. This is a known Claude Code bug (see GitHub issues #22109, #21654). Ignore these warnings.

Example output

Created 3 commits:
a1b2c3d feat(auth): add login endpoint
d4e5f6g fix(api): handle null response
g7h8i9j docs: update README with setup instructions