caveman-commit
Terse, conventional commit messages that prioritize reasoning over description
by juliusbrusseeFree
Description
caveman-commit is an agent skill from the caveman project that writes Git commit messages in a terse, conventional form, compressed to the intent of the change. It enforces the Conventional Commits format: a type such as feat, fix, refactor, perf, docs, test, chore, build, ci, style or revert, an optional scope, and an imperative subject line, such as add, fix or remove. The subject should be 50 characters or fewer when possible, with a hard cap of 72, and it has no trailing period. The skill asks the agent to match the project's convention for capitalization after the colon. The body is optional. It is left out when the subject is self-explanatory, and it is added only for a non-obvious reason, a breaking change, a migration note or a linked issue, wrapped at 72 characters. Bullets use hyphens, and issues or pull requests are referenced at the end, such as Closes #42 or Refs #17. The skill is triggered by requests to write a commit or a commit message, and by the /commit and /caveman-commit commands. Its guiding idea is to explain why a change was made, since the diff already shows what changed, which suits developers who want a short, consistent commit history.…
Highlights
- Conventional Commits types and scopes
- Subject lines of 50 characters where possible
- Body only when the why needs it
- Issue references at the end of the message
Ratings & Reviews
No ratings yet
Be the first to rate caveman-commit.
People also visit
caveman-commit FAQ
What does the caveman-commit skill do?
It writes Git commit messages in the Conventional Commits format, focused on the intent of the change.
How do I install it?
Run: npx skills add https://github.com/juliusbrussee/caveman --skill caveman-commit
How long should the subject line be?
50 characters when possible, with a hard cap of 72, and no trailing period.
When does it add a body?
Only for a non-obvious reason, a breaking change, a migration note or a linked issue. Otherwise it leaves the body out.
What security checks has it passed?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best caveman-commit alternatives?
Popular alternatives to caveman-commit include github, conventional-commit and mcporter. See all caveman-commit alternatives