Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and well-structured with clear version-bump logic and one-level-deep sibling links, but it carries some redundancy and generic definitions Claude does not need. Tightening the overlapping scope sections and trimming obvious commit-type glosses would lift conciseness.
Suggestions
Consolidate 'When to Use Scope' and 'When NOT to Use Scope' into the 'Scope Guidelines' section to remove overlapping restatements.
Trim generic glosses on common commit types (e.g. 'refactor: Code changes that neither fix bugs nor add features') down to a bare list, since Claude already knows conventional-commits semantics.
Replace the verbose good-vs-bad commit narrative with a single compact example showing the body explaining the 'why', to save tokens without losing the lesson.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and actionable, but it re-explains concepts Claude already knows (generic commit-type definitions like 'refactor: Code changes that neither fix bugs nor add features') and restates scope guidance across three overlapping sections, so it could be tightened further. | 2 / 3 |
Actionability | Provides concrete, copy-paste-ready examples ('feat(transcription): add model selection for OpenAI providers'), precise rules (lowercase, imperative mood, <50-72 chars), and exact version-scheme mechanics ('8.Y.Z', 'feat(api)!: ...', 'BREAKING CHANGE:' footer). | 3 / 3 |
Workflow Clarity | The breaking-change/version-bump section is a clear sequenced decision flow (Patch default → '!' for Minor → manual Major → footer), and there are no destructive batch operations requiring validate-retry loops that would cap the score at 2. | 3 / 3 |
Progressive Disclosure | Keeps rules inline in a single well-organized file and links sibling skills one level deep with clearly signaled paths ([standalone-commits], [pull-request]); no nested references, fitting the simple-skill allowance. | 3 / 3 |
Total | 11 / 12 Passed |