Conventional commits
Skill openagentskills/betterskills/skills/engineering/conventional-commits
Portable, open catalogue of agent skills for Cursor, Claude Code, Windsurf, Copilot, and other AI coding assistants.
npx -y skills add openagentskills/betterskills --skill conventional-commitsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Drafts Conventional Commits messages from staged or unstaged diffs. Use when the user asks for a commit message, conventional commit, or help summarizing git changes before commit.
SKILL.md
1.6 KB, as published. Nobody here has run it
Conventional Commits
Format
<type>(<optional scope>): <subject>
<optional body>
<optional footer(s)>
- Subject: imperative mood, ≤72 chars, no trailing period
- Body: explain why, not only what
- Breaking:
BREAKING CHANGE: descriptionin footer ortype!:
Types
| Type | Use |
|---|---|
feat | New user-facing capability |
fix | Bug fix |
docs | Documentation only |
style | Formatting, no logic change |
refactor | Code change, no feat/fix |
perf | Performance improvement |
test | Tests only |
build | Build system or deps |
ci | CI config |
chore | Maintenance, tooling |
Workflow
- Run
git statusandgit diff(staged + unstaged). - Group changes into one or more logical commits if needed.
- Pick type and scope from the diff paths.
- Write subject from the user impact, not file names.
Examples
Input: Added JWT login endpoint and middleware
feat(auth): add JWT login and validation middleware
Enable stateless sessions for API clients.
Input: Fixed timezone bug in report dates
fix(reports): use UTC for report timestamps
Fixes incorrect local display for cross-region users.
Rules
- Do not mention tool names in the subject
- Avoid vague subjects: "update stuff", "fix bug"
- One concern per commit when possible