commit-like-pro

Install a token-efficient AI skill that reviews your pending changes and writes senior-grade git commits — group, message, and commit like a pro.

Most AI commit helpers do one expensive thing: they shove your entire git diff into the model and ask for a message. That burns tokens and still produces updated files. commit-like-pro teaches your agent to commit the way a senior engineer does — and to do it cheaply.

What it does

When you tell your AI agent "commit like a pro", the skill makes it:

1. Survey cheaply first — git status, git diff --stat, git log. It reads full diffs only for files whose intent it can't infer from the path + stat. That's the trick that keeps token cost down.
2. Group unrelated changes into separate, logical commits — one concern each. Refactors stay apart from behavior changes; tests ride with the code they cover.
3. Write Conventional Commits messages that explain the why, not a restatement of the diff — matching your repo's existing style.
4. Guard against mistakes — never git add . blindly, stops on detected secrets / conflict markers / debug leftovers, respects your git hooks.
5. Show a plan, confirm, then commit.

Install

npx commit-like-pro

The installer asks where to put the skill:

• This project → ./.claude/skills/commit-like-pro/ (versioned with the repo, shared with your team), and optionally an AGENTS.md pointer.
• Global → ~/.claude/skills/commit-like-pro/ (available in every repo).

Non-interactive

npx commit-like-pro --project --with-agents   # into the current repo + AGENTS.md
npx commit-like-pro --global --yes            # everywhere, no prompts

| Flag | Effect | |---|---| | --project | Install into ./.claude/skills (default) | | --global | Install into ~/.claude/skills | | --with-agents | Also add/refresh an AGENTS.md pointer (project installs) | | --no-agents | Skip the AGENTS.md pointer | | --yes, -y | Run non-interactively | | --help, -h | Show help |

Usage

Claude Code — the skill loads on demand. Just say:

commit like a pro

Cursor / Copilot / other agents — with --with-agents, the workflow is added to your project's AGENTS.md, which these tools read automatically. Or point your agent at .claude/skills/commit-like-pro/SKILL.md directly.

Why "token-efficient"?

A bare git diff of a busy branch can be tens of thousands of tokens. The skill's first rule is don't load that by default — survey with --stat and filenames, and pull line-level diffs only for the handful of files where intent is genuinely ambiguous. On a typical change the whole task costs a few hundred tokens.

Contributing

See CONTRIBUTING.md. The skill itself (skill/commit-like-pro/SKILL.md) is the product — keep it short, imperative, and faithful to the token-discipline and guardrails.

License

MIT © Jeffrey Rios