skills/commit/SKILL.md
Analyze Git diff and generate Conventional Commits format messages.
npx skillsauth add thkt/dotclaude commitInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
$ARGUMENTS (optional)$ARGUMENTS is empty → analyze staged changes only| Step | Action |
| ---- | ------------------------------------------------------------------------ |
| 1 | Read staged: git status, git diff --staged (parallel) |
| 2 | Generate 3 candidates (varied scope/wording, see Type Detection + Rules) |
| 3 | Present via AskUserQuestion → user selects or customizes (Other) |
| 4 | Execute selected commit (sandbox-compatible) |
Infer type from diff context:
| Type | When to use | | -------- | ------------------------------------------ | | feat | New functionality or capability | | fix | Bug fix or error correction | | refactor | Code restructuring without behavior change | | docs | Documentation only changes | | test | Adding or updating tests | | chore | Config, dependencies, maintenance | | perf | Performance optimization | | style | Formatting, whitespace, linting | | ci | CI/CD configuration changes |
Default to feat if unclear.
| Rule | Guideline |
| ------- | ---------------------------------------------------- |
| Subject | ≤72 chars, imperative, lowercase, no period |
| Footer | BREAKING CHANGE:, Closes #123, Co-authored-by: |
feat(auth): add OAuth2 authentication support
feat(api)!: remove deprecated endpoints # BREAKING CHANGE
# Multi-line: file-based
cat > /tmp/claude/commit-msg.txt << 'EOF'
<message>
EOF
git commit -F /tmp/claude/commit-msg.txt
mv /tmp/claude/commit-msg.txt ~/.Trash/ 2>/dev/null || true
# Single-line: multiple -m flags
git commit -m "subject" -m "body"
| Error | Action | | ----------------- | ----------------------- | | No staged files | Report "Nothing staged" | | Empty diff | Return minimal message | | No git repository | Report "Not a git repo" | | Pre-commit failed | Report hook error |
## Commit Preview
> <type>(<scope>): <description>
<body>
`<footer>`
Committed: [short-hash] <type>(<scope>): <description>
tools
Internal helper for /think Step 11. Renders SOW.md + Spec.md as an integrated Astro view and returns a dev server URL.
development
Extract repository spec while detecting bugs, spec gaps, and consistency drift via dual-purpose documentation. OUTCOME.md-axis question-driven exploration with ephemeral output. Do NOT use for code review (use /audit or /polish), feature implementation (use /code), planning only (use /think), or single-bug fix (use /fix).
development
Discover undocumented design decisions and challenge each candidate via critic-design before promotion. Rank by impact and reversibility, produce ADR promotion candidates. Treat each candidate as a position arguing for ADR status, not a fact to be filed. Pairs with audit-adr-drift, which scans existing ADRs for drift against code.
development
Scan ADR Decision sections against current code and report drift with modification direction and priority. Do NOT use for repos without ADRs (use audit-adr-gaps instead).