Content
88%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 well-crafted instruction skill: concrete executable commands, a clearly sequenced workflow with explicit validation checkpoints, and disciplined conciseness with no filler. The only notable gap is that the referenced guideline files (AGENTS.md, STYLE.md, etc.) are not present in the bundle and their path context is not clarified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no padding, no explaining concepts Claude already knows, concrete before/after examples like '"perform an evaluation of" becomes "evaluate"'. Anchor 4 ('efficient; minor instances that could be trimmed') fits better than 5 because a few lines (e.g., the Notes on vendored paths, the rationale sentence about reviewers) carry slightly more context than strictly necessary, though nothing is wasted enough to drop to 3. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: `git checkout -b fix/issue-<number>-<short-desc> main`, `scripts/lint.sh <changed-markdown-files>`, the complete commit heredoc with mandatory body, and `git log --all --full-history -- "**/filename.md"` for renames. This matches anchor 5 — specific commands cover the common cases, including validation of staged files via `git diff --cached --name-only`. | 5 / 5 |
Workflow Clarity | The numbered workflow (branch → read then edit → front matter check → validate → self-review → commit) is clearly sequenced with explicit validation checkpoints: automated rumdl after each edit via the PostToolUse hook, manual lint after all edits, re-reading changed files, `git diff` verification of intended changes, and staged-file verification before commit. This matches anchor 5's 'clear sequence with explicit validation steps; feedback loops' — including fixing lint errors before proceeding. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and the body stays lean (~105 lines), pushing style detail to referenced files (AGENTS.md, STYLE.md, CLAUDE.md, COMPONENTS.md) one level deep. However, the actual bundle contains only scripts/post-edit.sh — none of the referenced guideline files exist in the bundle, and their location (bundle vs. repo) is not clearly signaled, matching anchor 4 ('good structure; references mostly clear; minor organization gaps') rather than anchor 5's well-signaled, verifiable references. | 4 / 5 |
Total | 18 / 20 Passed |