brevix-commit
Installation
SKILL.md
Brevix Commit Generator
Produce a Conventional Commit message that strips noise while preserving intent.
Format
<type>(<scope>): <subject>
<body — only if non-obvious why>
Rules
- Subject: ≤50 chars, lowercase, imperative mood, no trailing period
- Type: feat, fix, refactor, perf, docs, test, chore, build, ci, style
- Scope: optional — module or file area
- Body: 2–4 lines max. Only when why isn't obvious from the diff. Skip "what" — the diff shows that.
- Footer: only for breaking changes or issue refs
Examples
feat(auth): add JWT refresh endpoint
Token rotation needed for mobile clients with offline windows.
Refresh expires after 30d to limit blast radius if leaked.
fix(parser): handle empty input
refactor(api): extract retry logic into helper
Skip
- "Update X file" — useless
- "Various improvements" — vague
- Long prose — the PR description is the right place
Workflow
- Run
git diff --cachedto see staged changes - Identify the dominant change type
- Pick scope from the affected file/module
- Draft subject ≤50 chars
- Add body only if a reviewer would ask "why?"