commit-conventions

Installation
SKILL.md

Commit Conventions

Overview

Plan and execute commits that follow Conventional Commits plus any repository rules in AGENTS.md. Default to multiple commits when changes span more than one logical unit.

Workflow

  1. Read AGENTS.md (repo root or nearest) and apply any git/commit rules.
  2. Inspect the working tree: git status -sb, git diff --stat, and focused git diff as needed.
  3. Group changes by logical unit (feature, fix, refactor, docs, build/CI, etc.).
  4. If more than one logical unit exists, create multiple commits. Propose a brief commit plan before committing.
  5. Message heuristic: if draft subject wants and, list separators, or >1 scope/target, split before committing.
  6. Stage per group (git add -p or specific paths), then commit with a Conventional Commit message.
  7. If the user asks for a single commit but changes are multiple logical units, warn and ask for confirmation before combining.

Hook Rewrite Recovery

  • If git commit fails because pre-commit hooks rewrote files (formatter/linter), do not change the commit plan.
Related skills

More from derklinke/codex-config

Installs
21
GitHub Stars
8
First Seen
Jan 27, 2026