Content
58%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.
The body is maximally lean but is a pure redirect: all actual guidance lives in an external file that is not part of the skill bundle, leaving no workflow, examples, or validation steps in the skill itself. Conciseness is perfect, yet actionability, workflow clarity, and navigation all suffer because the content is not shipped with the skill.
Suggestions
Ship the shared skill's content inside the bundle (e.g., copy the seven-pass workflow into references/) and reference it with a bundle-relative path, so the skill is self-contained instead of depending on ~/.agents/skills/plan-design-review/SKILL.md.
Add a brief overview of the workflow to the body — the seven named passes, the 0-10 rating with an explicit 'what would make it a 10', and the edit loop — so Claude has a sequenced process with checkpoints before loading any details.
Verify the external path exists at runtime or provide an inline fallback; a pointer to a home-directory file that may not be present leaves the skill unusable as a standalone bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — a generator comment and 'Load and follow the shared skill at `~/.agents/skills/plan-design-review/SKILL.md`' — with zero padding and no explanation of concepts Claude already knows. Every token earns its place, matching the 5 anchor ('lean and efficient; assumes Claude's competence'). | 5 / 5 |
Actionability | The single instruction is concrete and executable (an exact file path to load), but the body contains no task-level guidance — none of the seven passes, the 0-10 rating scale, or the editing steps the description promises. This fits anchor 3 ('some concrete guidance but incomplete; missing key details') rather than 4, where the gaps would be minor. | 3 / 5 |
Workflow Clarity | The multi-step process the description advertises ('seven passes', rating, editing) is entirely absent from the body — only a single delegating 'Load and follow' directive is present, with no sequence and no validation for the actual work. It sits between anchor 1 (steps missing) and anchor 2 (rough sequence, many gaps); the lone directive is coherent and well-defined, so 2 rather than 1. | 2 / 5 |
Progressive Disclosure | The body is a clearly signaled, one-level-deep pointer, but it targets an absolute path outside the skill bundle (`~/.agents/skills/plan-design-review/SKILL.md`) and no references/, scripts/, or assets/ files exist, so the body provides no overview and the skill ships none of its content. Fits anchor 3 ('some structure but could be better organized') rather than 4, since the organization gap is not minor. | 3 / 5 |
Total | 13 / 20 Passed |