# Conventional Commit Batcher > Auto-split mixed changes into logical commit batches with validated Conventional Commit messages. MUST BE USED for ANY git add, git commit, or git push operation. - **Type:** Skill - **Install:** `agentstack add skill-cnkang-conventional-commit-batcher-conventional-commit-batcher` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [cnkang](https://agentstack.voostack.com/s/cnkang) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [cnkang](https://github.com/cnkang) - **Source:** https://github.com/cnkang/conventional-commit-batcher ## Install ```sh agentstack add skill-cnkang-conventional-commit-batcher-conventional-commit-batcher ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Conventional Commit Batcher Use this skill to turn a messy working tree into clean, reviewable Conventional Commit history. ## Commit Interception (MANDATORY) This skill MUST be activated for ANY commit-related operation, including: - user asks to commit, stage, or push changes - user asks to "save" or "check in" code - any workflow that would result in `git add`, `git commit`, or `git push` Do NOT run `git add` or `git commit` directly without going through this skill's workflow. ## Use This Skill When - any commit operation is performed through an agent (automatic interception) - changes from different intents are mixed in one branch - you want a plan-first commit process before opening a PR - you need reliable Conventional Commit messages across team and agents ## Skip This Skill When - the change is tiny and clearly single-intent - you only need one quick commit without batching Note: even when the skill could be skipped, if it is installed, the agent will still run the workflow and safety gates. The result may be a single batch, which is fine. ## Default Behavior: Auto-Execute By default, the skill inspects changes, splits into logical batches, runs safety gates, and commits directly — without waiting for user confirmation. To see the plan before execution, explicitly ask: ```text Show me the commit plan first before executing. ``` ## High-Success Prompt (Plan-First Mode) Use this prompt only when you want to review the plan before execution: ```text Inspect my current git changes and split them into logical Conventional Commit batches. Output a full Commit Plan first. Do not run git add or git commit until I confirm the plan. After confirmation, execute each batch one by one. ``` ## Output Contract In auto-execute mode (default), the agent outputs a brief per-batch summary as each batch is committed. In plan-first mode (user requested), the agent outputs the full plan before any staging/commit: ```text Commit Plan Batch #1: Intent: Files/Hunks: - (...) Staging commands: - git add ... Commit command: - git commit -m "..." ``` ## Required Behavior - Always load `references/core-rules.md` first. - Treat `references/core-rules.md` as the single source of truth. - Run `python3 scripts/precommit_safety_gate.py` before every commit attempt when Python is available; otherwise run the equivalent manual gate checks from `references/core-rules.md`. - Run the sensitive-data gate before every commit and require explicit user confirmation if risky files/hunks are detected. - When any gate reports risk, include triggered file paths and brief evidence in user-facing output, plus a concrete "please review" suggestion. - Run the `.gitignore`/local-artifact gate before every commit and require explicit user confirmation if suspicious files are present. - Run branch/conflict/large-file/empty-stage safety checks before every commit. - Never skip commit-time checks with `--no-verify`. - If check/hook fails, stop and report concise diagnostics. ## Entrypoints - Codex skill: `SKILL.md` - Codex repo loader: `AGENTS.md` - Claude: `CLAUDE.md`, `.claude/agents/conventional-commit-batcher.md`, `.claude/commands/commit-batch.md` - Kiro: `.kiro/agents/conventional-commit-batcher.json`, `.kiro/steering/commit-batching.md` - Shared skill (Kimi / Qwen / Gemini): `.agents/skills/conventional-commit-batcher/SKILL.md` - Shared subagent (Qwen / Gemini): `.agents/agents/conventional-commit-batcher.md` - OpenAI: `agents/openai.yaml` ## References - Canonical rules: `references/core-rules.md` - Commit plan examples: `references/plan-examples.md` - Commit batching guidance: `references/commit-batching-guide.md` - commit-msg hook example: `references/commit-msg-hook-example.md` - Agent setup docs: - `references/codex-setup.md` - `references/claude-setup.md` - `references/kiro-setup.md` - `references/kimi-setup.md` - `references/qwen-setup.md` - `references/gemini-setup.md` - Validator script: `scripts/validate_conventional_commit.py` - Safety gate script: `scripts/precommit_safety_gate.py` - Validator tests: `scripts/test_validate_conventional_commit.py` - Safety gate tests: `scripts/test_precommit_safety_gate.py` ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [cnkang](https://github.com/cnkang) - **Source:** [cnkang/conventional-commit-batcher](https://github.com/cnkang/conventional-commit-batcher) - **License:** Apache-2.0 Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-cnkang-conventional-commit-batcher-conventional-commit-batcher - Seller: https://agentstack.voostack.com/s/cnkang - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.