Content
92%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 tight, well-structured instruction-only skill: a concrete command, an explicit output format, a complete type-decision table, and clear edge-case and safety guidance, with zero padding. Its single gap is the absence of a worked input/output example commit message to anchor the subject-line rules.
Suggestions
Add one short worked example under 'Subject line rules' showing a staged change and the resulting message, e.g. Input: token-refresh fix in api/ → Output: "fix(api): drop expired token from cache key", to reach fully copy-paste-ready guidance.
Optionally mirror one full message example including a body case (breaking change) so the conditional body rule in step 4 is demonstrated, not just described.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient: no explanation of what git, commits, or Conventional Commits are — it only supplies what Claude would not already know (the type table with decision criteria like "Empty files and stubs don't count", the 72-char rule, scope guidance). Every section and line earns its place; nothing is padded. Not 4: there are no instances of over-explanation to trim. | 5 / 5 |
Actionability | Concrete and executable: exact command "git diff --cached", explicit format template "<type>(<optional scope>): <subject>", measurable rules (imperative mood, lowercase, no trailing period, 72 chars), and a full decision table. Not 5: there is no worked example of an input change and its resulting commit message (e.g., "fix(api): drop trailing slash on redirect"), which the format rules would otherwise leave unshown; not 3: the guidance is fully concrete and directly executable, with only that minor gap. | 4 / 5 |
Workflow Clarity | The 5-step numbered sequence is unambiguous, includes decision guidance for the ambiguous case ("If changes are mixed, pick the type that covers all of them, not the largest file"), and an explicit safety boundary ("Do not commit, just suggest it to the user"). The operation is non-destructive (suggestion-only), so the validation-cap guideline does not apply; no feedback loop is needed since nothing is modified. Not 4: there are no gaps — edge cases and the stopping point are both explicit. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references (none exist in the bundle), and per the rubric's simple-skill guideline it qualifies for 5 with well-organized sections. Sections ("When you're triggered", "What to do", "Type table", "Subject line rules") are clear, appropriately sized, and nothing that belongs in a separate file is inlined. Not 4: structure and placement are fully appropriate at this scale. | 5 / 5 |
Total | 19 / 20 Passed |