skills/commit/SKILL.md
Analyze Git diff and generate Conventional Commits format messages.
npx skillsauth add thkt/claude-config 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>
documentation
Generates and updates .claude/OUTCOME.md interactively. When the file is absent or empty (no Behavior / all sections TBD), collects content via AskUserQuestion and writes the stub; when present, shows the current state and applies updates.
development
Judge a SKILL.md against craft axes (single responsibility, description distinctiveness, imperative voice, verifiable completion, calibration, progressive disclosure) and apply the fixes the audit surfaces. Do not use for format-presence-only checks (use reviewer-prompt) or reproducibility loops (use /tuning).
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).