How this skill is triggered — by the user, by Claude, or both
Slash command
/harness-kit:commitThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Create conventional commits with automatic validation and quality gates.
Create conventional commits with automatic validation and quality gates.
Commit changes reliably with validation checks and consistent messaging.
git diff --cached before committing. No hardcoded API keys, passwords, credentials, or tokens.type(scope): description. Malformed messages create merge and CI problems downstream.git add -A or git add . blindly. Review git status and stage intentionally.feat, fix, refactor, docs, chore, testReview and stage files intentionally:
git status # See what changed
git add <file1> <file2> ... # Stage specific files
git diff --cached # Review staged changes
Never: git add -A or git add . — stage intentionally.
Discover and run the verification command:
cmd=$(${CLAUDE_PLUGIN_ROOT}/skills/shared/discover-verification-cmd.sh)
eval "$cmd"
ALL checks must pass. No commits that break validation.
Format: type(scope): description
Example:
feat(auth): add OAuth2 login flow
See DETAIL: Message Format for all types and examples.
git commit -m "type(scope): description
Optional detailed explanation here.
Mention related issues: #123, closes #456."
For complex messages, use HEREDOC:
git commit -m "$(cat <<'EOF'
feat(scope): brief description
- Detailed explanation line 1
- Detailed explanation line 2
Closes #NNN
EOF
)"
| Type | Use Case | Example |
|---|---|---|
feat | New feature or capability | feat(auth): add two-factor authentication |
fix | Bug fix | fix(api): handle null responses from upstream |
refactor | Code restructuring (no behavior change) | refactor: extract validation into utility |
docs | Documentation updates | docs: clarify API rate limits in README |
chore | Maintenance, dependencies, build | chore: upgrade prettier to latest |
test | Test additions or fixes | test: add edge case coverage for date parsing |
style | Formatting, missing semicolons (rarely used) | N/A |
perf | Performance improvements (rarely used) | perf: use memoization for expensive calculation |
Optional, indicates area of change:
auth, api, ui, database, etc.feat(keyboard): add macro support, fix: resolve memory leakCloses #NNN, Fixes #NNN, Relates to #MMMfeat(keyboard): add macro recording and playback
Users can now record key sequences and replay them with a hotkey.
This addresses frequent requests for repetitive key patterns.
Macro storage uses ~/.config/daskeyboard/macros.json for
persistence across sessions.
Testing: Added 12 test cases covering:
- Basic record/playback
- Edge cases (empty macros, special keys)
- Storage persistence
Closes #234
fix stuff ← Too vague
feat: add oauth ← Missing scope, too brief
docs: update ← What did you update?
refactor(everything): big cleanup ← Scope "everything" is suspicious
When committing changes across many files:
git status | grep -E "modified|new" # See all changes
git diff --stat # Summary by file
# Stage by category
git add programs/zsh.nix programs/vim.nix # Shell config
git add docs/*.md # Documentation
git diff --cached # Review staged
git commit -m "..."
Each commit should be coherent:
❌ Bad: Single commit with shell config, docs, and bug fix ✅ Good: Three separate commits, one for each type of change
This makes history clearer and simplifies reverting if needed.
Commit part of a file (not all changes):
git add --patch <file> # Interactive hunk selection
# Review each hunk, stage with 'y', skip with 'n'
git diff --cached # Review staged hunks
git commit -m "feat: related change"
Use when:
git reset --soft HEAD~1 # Undo commit, keep staged
git reset HEAD # Unstage all
# Now fix and re-commit
git add <fixed-files>
git commit --amend # Amend with new changes
# Or: git commit --amend --no-edit (keep message)
Never amend commits already pushed. Use a new commit instead.
git reset --hard HEAD~1 # Discard all changes in last commit
Use with caution — this is destructive.
/review-pr — Review pull requests/open-pr — Open PR with validation/rollback — Recover from failed changesGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub dougborg/harness-kit --plugin harness-kit