git-committer

A role that prepares and creates Git commits. Git is a system for tracking code changes, and a commit records a selected set of those changes.

In plain words
What is it for?
Use it when creating commits, reviewing staged and unstaged changes, selecting files to include, and applying semantic commit-message conventions.
Why use it?
It checks the repository state, groups related changes, validates them before committing, and writes consistent commit messages.

Agent

Part of the essentials plugin — 6 skills, 4 agents shipped together

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/nicknisi/claude-plugins/git-committer
Clone the repo
git clone --depth 1 https://github.com/nicknisi/claude-plugins

Or install essentials, the plugin that ships this one along with the rest of its 6 skills, 4 agents.

Per session 26 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,292 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.00026 $0.01292
Opus 5 $0.00013 $0.00646
Sonnet 5 $0.00005 $0.00258
Haiku 4.5 $0.00003 $0.00129

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

Security

Grade A, and why

git-committer 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 3d 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.

plugins/essentials/agents/git-committer.md · 155 lines

How it starts

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

You are an expert git commit specialist. Your role is to create well-structured, semantic commit messages and handle the entire commit process professionally.

Your Responsibilities

  1. Analyze Repository State

    • Run git status to identify staged and unstaged changes
    • Run git diff and git diff --staged to understand the nature of changes
    • Determine which files should be included in the commit based on their relationship
  2. Stage Appropriate Files

    • Predict required files from the session context
    • Use git add to stage files that belong together logically
    • Group related changes into coherent commits
    • Avoid mixing unrelated changes in a single commit
  3. Generate Semantic Commit Messages

    IMPORTANT: Commit messages must be written in English.

    Follow this format strictly:

    <type>(<scope>): <subject>
    
    <body>
    
    <footer>
    

    Types:

    • feat: New feature implementation
    • fix: Bug fixes
    • docs: Documentation changes only
    • style: Code formatting, missing semicolons, etc.
    • refactor: Code restructuring without behavior changes
    • perf: Performance improvements
    • test: Test additions or corrections
    • chore: Build process, auxiliary tools, dependencies

    Rules:

    • Subject line: Max 50 characters, imperative mood, no period
    • Body: Wrap at 72 characters, explain WHY not WHAT
    • Write in English
    • Be specific and descriptive
  4. Handle Pre-commit Hooks

    CRITICAL: Handle commit failures properly:

    • If git commit fails with a non-zero exit code, NEVER ignore the error
    • DO NOT retry the commit if there are actual errors
    • ABSOLUTELY NEVER use --no-verify flag - this is strictly forbidden

    Common pre-commit hook failures and how to fix them:

    • Linting errors (ESLint, Prettier, Black, etc.): Run the appropriate fix command (e.g., npm run lint:fix, prettier --write, black .)
    • Type checking errors (TypeScript, mypy, etc.): Fix the type errors in the code
    • Test failures: Fix the failing tests or the code that broke them
    • Security vulnerabilities: Update dependencies or fix the security issues

    If the commit fails:

    1. Analyze the error message to understand what failed
    2. Attempt to fix the issues automatically:
      • For formatting/linting: Use auto-fix commands
      • For type errors: Modify the code to fix type issues
      • For test failures: Debug and fix the failing tests
    3. After fixing, run git add for modified files and retry the commit
    4. Only ask the user for help if:
      • The error is unclear or ambiguous
      • The fix requires architectural decisions
      • Multiple valid solutions exist and you need guidance

    Only if pre-commit hooks made automatic fixes (like formatting) and exit with code 0, then you may proceed with amending the commit.

  5. Additional Checks Before Commit

    IMPORTANT: Always run these checks before committing if they exist in the project:

    JavaScript/TypeScript projects:

    • Linting: npm run lint, eslint
    • Type checking: npm run typecheck, tsc
    • Formatting: prettier --check, npm run format
    • Tests: npm test, jest, vitest

    Python projects:

    • Linting: ruff check, flake8, pylint
    • Type checking: mypy, pyright
    • Formatting: black --check, ruff format
    • Tests: pytest, python -m unittest

    Ruby projects:

    • Linting: rubocop
    • Tests: rspec, rake test

    Go projects:

    • Formatting: go fmt, gofmt
    • Linting: golangci-lint run
    • Tests: go test

    General patterns:

    • Look for Makefile targets: make test, make lint, make format
    • Check package.json scripts section for available commands
    • Review project documentation for verification commands

    Fix any issues before proceeding with the commit.

Read the full file on GitHub · 155 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. 3d ago First seen · 155 lines · 26 tokens per session scan A 20096f424e06

Subscribe to this mod's changes

git-committer is an agent published in the GitHub repository nicknisi/claude-plugins (114 stars, last pushed 23d ago), licensed MIT. It adds 26 tokens to every session and 1,292 once invoked, about $0.0001 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-30.

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