bakeoff/live/v4/commit-message/commit-message/SKILL.md
Assists developers with writing high-quality commit messages for version control. Use when committing changes, summarizing staged diffs, or preparing changelog entries. Supports conventional commits and descriptive subject lines.
npx skillsauth add bjg4/bgskillz commit-messageInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Good commit messages document what changed and why. Future readers (including future you) rely on history to understand decisions. This skill guides message writing so commits are searchable and meaningful.
Standard prefixes (feat, fix, docs, etc.) make history scannable and enable automated tooling. They are not mandatory for every repo but are a strong default when the team adopts them.
Write in imperative mood ("Add feature" not "Added feature") because each commit is a instruction to the repository: "if applied, this commit will..."
Keep the subject line concise — many teams aim for 50–72 characters. Add a body when the why is not obvious from the subject.
Reference issue trackers when the team uses them (e.g., Fixes #123).
| Type | Purpose | |------|---------| | feat | New user-facing capability | | fix | Bug fix | | docs | Documentation only | | refactor | Code change without behavior change | | test | Tests only | | chore | Maintenance, deps, tooling |
If no diff or summary is provided, ask for git diff --staged or a short description of changes.
Subject: feat(auth): add JWT login endpoint
Subject: fix(api): handle null user in profile lookup
Weak: update stuff — too vague for history search.
development
Create S-tier portable skills and agents with comprehensive quality guidance. Use when creating or improving skills, designing multi-agent orchestration workflows, auditing agent quality, running evals, or learning agent-building best practices. Covers the full lifecycle from use case definition through automated evaluation, review, and iteration. Do NOT use for general coding tasks, writing documentation unrelated to agents/skills, or building applications.
development
Create S-tier portable skills and agents with comprehensive quality guidance. Use when creating or improving skills, designing multi-agent orchestration workflows, auditing agent quality, running evals, or learning agent-building best practices. Covers the full lifecycle from use case definition through automated evaluation, review, and iteration. Do NOT use for general coding tasks, writing documentation unrelated to agents/skills, or building applications.
development
Create S-tier portable skills and agents with comprehensive quality guidance. Use when creating or improving skills, designing multi-agent orchestration workflows, auditing agent quality, running evals, or learning agent-building best practices. Covers the full lifecycle from use case definition through automated evaluation, review, and iteration. Do NOT use for general coding tasks, writing documentation unrelated to agents/skills, or building applications.
development
Stress-test a plan or design through Socratic questioning until shared understanding. Use when the user says "grill me", wants to stress-test a plan, or review a design. Do NOT use for implementation or code generation.