What problem does it solve?
This Skill helps create git commits following the Conventional Commits specification v1.0.0. It ensures commits have a consistent format, proper scope, and clear breaking-change indicators.
Core Features & Use Cases
- Commit type determination: feat, fix, docs, style, refactor, perf, test, build, ci, chore
- Optional scope: include a scope like api, parser, ui for clarity
- Breaking change indicator: add "!" and a BREAKING CHANGE footer when needed
- Structured commit creation: commit message formatted as per Conventional Commits
- Reproducible workflow: use a heredoc to craft the final message
Quick Start
Stage your changes (e.g., git add -A) and create a conventional commit with a prepared body, for example:
git commit -m "$(cat <<'EOF'
feat(api)!: add OAuth2 login support
This introduces OAuth2-based authentication and updates the API surface.
BREAKING CHANGE: The authentication flow now requires OAuth2 tokens for all clients.
Refs: #123
EOF
)"