Agent skill
Commit Helper
Generate clear conventional commit messages from git diffs. Use when writing commit messages, reviewing staged changes, or after completing TDD cycles.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/testing/commit-helper-channingwalton-dotfiles
SKILL.md
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
Didn't find tool you were looking for?