About writing-commits
writing-commits is a skill for developers writing commit messages and pull request titles and bodies according to Conventional Commits. It also provides branch naming rules and examples.
Key features
- 01Follows Conventional Commits
- 02Defines subject and type rules
- 03Provides PR title and body templates
- 04Sets branch naming formats
Use cases
- 01Writing a feature commit message
- 02Marking a breaking change in a commit
- 03Preparing a PR title and body
- 04Naming a development branch by type
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/writing-commitsin Claude Code to confirm it loaded.
Details
From the project READMEWriting Commits
Follow Conventional Commits: <type>(<scope>): <subject>
Types
| Type | Use For |
|---|---|
feat | New user-facing feature |
fix | Bug fix |
docs | Documentation only |
refactor | Code change, no behavior change |
test | Adding/fixing tests |
chore | Build, deps, tooling |
Rules
- Subject: imperative mood, no period, ≤50 chars
- Scope: optional area indicator (auth, api, ui)
- Breaking changes: add
!after type
Examples
feat(auth): add Google OAuth login
fix(api): handle null user in profile endpoint
feat(api)!: change auth response format
chore(deps): upgrade Next.js to 15
Anti-patterns
# ❌ Avoid
"fix stuff"
"updates"
"WIP"
# ✅ Prefer
"fix(auth): resolve token refresh race condition"
PR Titles
Same format as commits. PR title becomes the squash commit message.
PR Body
## What
[Brief description]
## Why
[Context/motivation]
## Testing
[How verified]
Branch Naming
# Format: type/short-description
feat/oauth-login
fix/token-refresh
chore/upgrade-deps
# With ticket numbers
feat/PROJ-123-oauth-login
fix/PROJ-456-token-refresh
Keep branches short-lived. Delete after merge.
Comments
Markdown supported