commit-helper
Helps write Git commit messages following the Conventional Commits specification. Use this skill when the user asks to commit changes, write commit messages, format commits, or mentions git commits.
By zhaono1 · 687 installs
npx skills add zhaono1/agent-playbook --skill commit-helper
Source repository · Upstream listing
Commit Message Helper
A skill for creating properly formatted Git commit messages following the [Conventional Commits](https://www.conventionalcommits.org/) specification.
When This Skill Activates
This skill activates when you:
Ask to commit changes
Mention commit messages
Request git commit formatting
Say "commit" or "git commit"
Commit Message Format
Types
Type Description
feat A new feature
fix A bug fix
docs Documentation only changes
style Changes that do not affect the meaning of the code (formatting, etc.)
refactor A code change that neither fixes a bug nor adds a feature
perf A code change that improves performance
test Adding missing tests or correcting existing tests
chore Changes to the build process or auxiliary tools
ci Changes to CI configuration files and scripts
build Changes that affect the build system or external dependencies
Scope
The scope should indicate the area of the codebase affected:
For frontend: components , hooks , store , styles , utils
For backend: api , models , services , database , auth
For devops: ci , deploy , docker
Project specific scopes are also acceptable
Guidelines
Subject Line
Use imperative mood ("add feature" not "added feature" or "adds feature")
No period at the end
Maximum 50 characters
Be specific and concise
Body
Separate subject from body with a blank line
Use the body to explain what and why , not how
Wrap at 72 characters per line
Mention any breaking changes
Footer
Reference issues: Closes 123 , Fixes 456 , Refs 789
Multiple issues: Closes 123, 456, 789
Breaking changes: Start with BREAKING CHANGE: followed by description
Examples
Good Examples
Bad Examples
Breaking Changes
When introducing breaking changes, add BREAKING CHANGE: to the footer:
Workflow
When writing a commit message:
1. Review changes Run git diff to understand what changed
2. Identify type Determine the type of change
3. Identify scope Determine which area is affected
4. Write subject Create a clear, concise subject line
5. Write body Explain what and why (if needed)
6. Add footer Reference issues or note breaking changes
Validation
Use the validation script to check commit message format:
Reference Documents
See references/conventional commits.md for full specification
See references/examples.md for more examples
See references/scopes.md for recommended scope naming