| name | Commit Helper |
| description | Generate clear conventional commit messages from git diffs. Use when writing commit messages, reviewing staged changes, or after completing TDD cycles. |
Commit Helper
This skill invokes the commit-helper agent to generate commit messages.
Quick Reference
Invoke: /commit-helper [options]
Options:
- No argument = analyse staged changes, return message
--commit= generate message AND create commit
Conventional Commit Format
<type>: <summary>
[optional body]
[optional footer]
Types
| Type | Use For |
|---|---|
feat |
New feature |
fix |
Bug fix |
refactor |
Code restructuring (no behaviour change) |
test |
Adding/updating tests |
docs |
Documentation only |
chore |
Build, tooling, dependencies |
Summary Rules
- Under 50 characters
- Imperative mood ("add" not "added")
- No period at end
Examples
Simple:
Add user authentication endpoint
With body:
Extract validation logic to separate module
Moved input validation from UserController to ValidationService
to improve testability and reuse across endpoints.
Breaking change:
Change API response format
BREAKING CHANGE: responses now wrap data in `result` key
Agent Behaviour
The commit-helper agent:
- Checks git status for staged changes
- Reads staged diff
- Checks recent commits for style consistency
- Analyses change type and scope
- Generates conventional commit message
Runs autonomously without user interaction.
Rules
- NEVER add contributors unless explicitly requested
- NEVER commit files containing secrets