skills/developer/git-mastery/commit-message-crafter/SKILL.md
Use this skill when writing Git commit messages. Activate when the user asks about commit message format, conventional commits, how to write good commit messages, commit message best practices, or when they're about to commit changes and need help crafting the message.
npx skillsauth add latestaiagents/agent-skills commit-message-crafterInstall 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.
Write clear, consistent, and meaningful commit messages.
<type>(<scope>): <subject>
<body>
<footer>
| Type | When to Use |
|------|-------------|
| feat | New feature for the user |
| fix | Bug fix for the user |
| docs | Documentation only changes |
| style | Formatting, missing semicolons, etc. (no code change) |
| refactor | Code change that neither fixes a bug nor adds a feature |
| perf | Performance improvement |
| test | Adding or fixing tests |
| chore | Maintenance tasks, dependencies, build changes |
| ci | CI/CD configuration changes |
| revert | Reverting a previous commit |
The part of the codebase affected:
auth, api, ui, db, config, deps, etc.feat(auth): add password reset functionality
fix(api): handle null response from payment gateway
The payment gateway occasionally returns null instead of an error
object when the service is degraded. This caused uncaught exceptions
in the checkout flow.
Fixes #1234
feat(api)!: change user endpoint response format
BREAKING CHANGE: The /api/users endpoint now returns paginated
results. Clients must update to handle the new response structure:
{ data: [], meta: { page, total } }
refactor(utils): extract date formatting into separate module
Moved date formatting logic from multiple components into a
centralized dateUtils module for better maintainability.
feat(dashboard): redesign analytics widgets
- Add new chart component for user growth
- Implement date range picker
- Add export to CSV functionality
- Update color scheme to match brand guidelines
Co-authored-by: Jane Doe <[email protected]>
# See what's staged
git diff --staged
# See files changed
git diff --staged --name-only
Ask: What is the PRIMARY purpose of these changes?
featfixrefactorLook at the files changed. What's the common area?
/src/auth/? → scope is authComplete this sentence with your changes: "If applied, this commit will _______________"
Good: "add user avatar upload" Bad: "added user avatar upload functionality to the system"
Include body when:
Fixes #123
Closes #456
BREAKING CHANGE: description
Co-authored-by: Name <email>
feat(<scope>): <what you added>
<why you added it, if not obvious>
Relates to #<issue>
fix(<scope>): <what you fixed>
<what was broken and why>
Fixes #<issue>
chore(deps): update <package> to <version>
<any breaking changes or notes>
Consider documenting your team's conventions:
## Commit Message Convention
- Use conventional commits format
- Scope is required for features and fixes
- Reference issue numbers in footer
- Breaking changes must include BREAKING CHANGE footer
# Set up commit template
git config --global commit.template ~/.gitmessage
# Use commitizen for interactive commits
npx cz
# Validate commits with commitlint
npm install -D @commitlint/{cli,config-conventional}
development
Test skills for correct activation, content quality, and regression — both automated checks (frontmatter validity, lint) and manual verification (query-suite activation testing). Covers CI integration and how to catch skill regressions before users do. Use this skill when adding skills to a repo, setting up CI for a skill library, or debugging "the skill exists but doesn't work". Activate when: test skills, validate skills, skill CI, skill linting, skill activation test, skill regression.
documentation
Write the YAML frontmatter for a SKILL.md file so it activates reliably — name, description, and activation keywords that the model matches against. Covers length, tone, and the most common frontmatter mistakes. Use this skill when authoring a new skill, fixing a skill that isn't auto-activating, or reviewing skills for publication. Activate when: SKILL.md frontmatter, skill description, skill activation, skill YAML, write a skill, author a skill.
development
Design skills that fire at the right moment — neither over-eager (noise) nor under-eager (silent). Covers activation specificity, trigger phrases, disambiguation between overlapping skills, and debugging activation. Use this skill when multiple skills could fire on the same query, a skill never fires, or a skill fires too often. Activate when: skill won't activate, skill over-activates, overlapping skills, skill triggers, skill selection, skill disambiguation.
development
Structure SKILL.md content so the model reads just enough — concise summary up front, progressively deeper detail, examples on demand. Covers section ordering, length budgets, when to split into multiple skills. Use this skill when writing or refactoring a skill body, one skill has grown too long, or a skill is wordy but not useful. Activate when: SKILL.md structure, skill content, skill too long, split skill, progressive disclosure, skill body.