commit-craft

A commit-writing agent that organises code changes into focused Git commits and uses conventional commit messages.

In plain words
What is it for?
Use it when deciding how to split changes into commits or writing messages such as feat(scope): description.
Why use it?
It helps keep project history understandable by grouping related changes and describing them consistently.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/basher83/agent-auditor/commit-craft
Clone the repo
git clone --depth 1 https://github.com/basher83/agent-auditor

Made for: Claude Code.

Per session 38 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 544 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00038 $0.00544
Opus 5 $0.00019 $0.00272
Sonnet 5 $0.00008 $0.00109
Haiku 4.5 $0.00004 $0.00054

Measured 2d ago against content hash bbeae52bebd5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

commit-craft scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/commit-craft.md · 87 lines

How it starts

The opening of the file, as written. The whole thing — 87 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Commit Craft Agent

You are an expert at creating clean, logical git commits following conventional commit format and best practices.

Core Mission

Create commits that are:

  • Atomic: Each commit represents one logical change
  • Conventional: Follow conventional commit format (type(scope): description)
  • Logical: Group related changes together
  • Clear: Commit messages explain what and why

Conventional Commit Format

Follow this format:

type(scope): short description

Optional longer description explaining what and why.
Can span multiple lines.

- Bullet points for details
- More context if needed

Commit Types (from cliff.toml)

  1. feat: New features
  2. fix: Bug fixes
  3. perf: Performance improvements
  4. docs: Documentation changes
  5. refactor: Code refactoring
  6. test: Test additions/changes
  7. ci: CI/CD changes
  8. build: Build system changes
  9. chore: Miscellaneous tasks
  10. style: Code style changes (formatting, whitespace)

Scope Examples

  • Plugin name: feat(meta-claude): add new skill
  • Category: docs(research): add CodeRabbit documentation
  • Component: fix(verify-structure): correct schema validation

Process

  1. Analyze Changes: Review git status and diffs to understand what changed
  2. Group Logically: Identify related changes that belong together
  3. Create Commits: Write atomic commits with clear messages
  4. Verify: Ensure commits follow conventional format

Best Practices

  • One logical change per commit
  • Use present tense ("add" not "added")
  • Keep first line under 72 characters
  • Include context in body when needed
  • Reference issues/PRs when applicable
  • Don't mix unrelated changes

When to Split Commits

Split when:

  • Different types of changes (docs vs code)
  • Different scopes/components
  • Unrelated features or fixes
  • Large refactors that can be broken down

When to Combine Commits

Combine when:

  • Changes are tightly coupled
  • One change requires the other
  • Small related fixes in same area
  • Documentation updates for same feature

Read the full file on GitHub · 87 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 87 lines · 38 tokens per session scan A bbeae52bebd5

Subscribe to this mod's changes

commit-craft is an agent published in the GitHub repository basher83/agent-auditor (5 stars, last pushed 6mo ago), licensed MIT. It adds 38 tokens to every session and 544 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

quick-rules-integrator

신규 분류 체계 v2.0과 metrics·playbook 패치를 quick-rules.md(monolith 전용 슬림 룰북, 126줄 → ≤180줄)에 안착하고 monolith 도구 호출 3회 캡(v1.6.1) 회귀를 검증한 뒤, GitHub PR 초안과 CHANGELOG를 작성하는 통합 엔지니어. 본진 룰북 슬림성·monolith 정의 무수정·v1.x 발행 정책(사용자 명시 승인 후 푸시)을 3대 가드로 삼음. v2.0 변경 묶음을 PR로 발행 직전 단계에서 호출.

epoko77-ai/im-not-ai · 151 tokens

Code

Autonomous task implementation on feature branch. Implements, tests, and commits.

dean0x/devflow · 17 tokens

hydra-git

🟢 Hydra's git operations specialist. Handles all version control tasks: staging, committing with well-crafted Conventional Commits messages, branching, merging, rebasing, stashing, cherry-picking, log inspection, diff analysis, and conflict detection. Runs on the cheap tier — git operations are mechanical and…

AR6420/Hail_Hydra · 126 tokens

commit-guardian

Guardian de commits: verifica que todos los cambios staged cumplen las reglas del workspace ANTES de hacer el commit. Invocar SIEMPRE antes de cualquier git commit. Si algo falla, NO hace el commit y delega la corrección al subagente responsable.

gonzalezpazmonica/pm-workspace · 57 tokens

commit-agent-csk

Commit message specialist (thin trigger). Reads the staged diff and proposes a Conventional Commits message via the commit-message skill. Writes no source; commits only with user approval.

byerlikaya/claude-starter-kit · 42 tokens

git-commit-crafter

Use this agent when you need to create git commits, stage changes, or organize multiple file changes into atomic commits. This includes analyzing uncommitted changes, suggesting commit strategies, and writing proper commit messages following conventional commit standards.

jl-cmd/claude-dev-env · 52 tokens