Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, actionable reference for a single-purpose skill: concrete rules, executable workflow, and well-chosen good/bad examples. The main gaps are the soft, conditional validation step and minor redundancy between the body's opening, Usage section, and frontmatter.
Suggestions
Give the pre-commit validation a fallback when `make checks` is unavailable (e.g., run the project's test/lint command or proceed with a warning) so the workflow's checkpoint is unconditional — this would lift workflow_clarity.
Trim the opening paragraph and Usage section, which restate the frontmatter description and argument-hint, and condense the Types list to only non-obvious mappings (e.g., fold `style`, `perf`, `ci` into one line) to tighten conciseness.
Add a short post-commit verification step (e.g., confirm with `git log -1 --stat`) so the workflow ends with an explicit success checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is tight and operational — terse message rules, compact examples, no explanation of git or conventional-commit concepts beyond a 9-line type table. It sits at the score-4 anchor (efficient, minor trimming possible): the Types list largely restates knowledge Claude already has, the opening paragraph repeats the frontmatter description, and the verbose counterexample block is slightly long for the point it makes. | 4 / 5 |
Actionability | Guidance is concrete and executable: a message template, hard rules ("under 60 characters", "no trailing period", "cap it at two short sentences or three bullets"), specific commands ("run `make checks`", "inspect staged files and `git diff`"), and good/with-body/bad examples that cover the common cases. This matches the score-5 anchor for an instruction-only skill with fully actionable, example-backed guidance. | 5 / 5 |
Workflow Clarity | The three-step workflow is clearly sequenced, the pre-commit check acts as an explicit validation step, and the Notes section defines the failure path ("ask whether to fix or proceed") — matching the score-4 anchor's 'clear sequence with most checkpoints'. It falls short of score 5 because validation is conditional ("if available") with no fallback, and there is no post-commit verification (e.g., confirming the commit landed via `git log`). | 4 / 5 |
Progressive Disclosure | The body is well-sectioned (Workflow, Message Rules, Types, Splitting Criteria, Examples, Options, Notes) and nothing that belongs in a separate file is inlined, matching the score-4 anchor (good structure, content appropriately placed, minor gaps). The skill exceeds the 50-line threshold where well-organized sections alone warrant a 5, and there is minor redundancy between the opening paragraph, the Usage section, and the frontmatter. | 4 / 5 |
Total | 17 / 20 Passed |