Content
47%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 a well-organized, token-efficient skeleton that points to real bundle files, but it delegates virtually all substance to a reference guide that contains no actual instructions. Claude invoking this skill would learn the directory layout but not what to do.
Suggestions
Replace the delegation-only Usage section with 2-3 concrete, executable steps (e.g. exact commands to run, what validate.sh should be run against, and what success looks like).
Flesh out references/guide.md with actual setup steps, or inline the steps in SKILL.md and drop the stub reference.
Add a validation checkpoint describing what to do when scripts/validate.sh fails (fix -> re-run loop), which would also lift workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean (under 30 lines), assumes Claude's competence, and contains no concept explanations Claude already knows. The only trimmable material is the slight repetition between the intro ('development artifacts that require --allow-dirs') and the Notes section ('Neither is part of the standard skill structure'), which keeps it just below the 'every token earns its place' anchor 5. | 4 / 5 |
Actionability | Concrete guidance is minimal: 'Follow the instructions in the [reference guide](references/guide.md)' is pure delegation with no stated steps, and 'Run scripts/validate.sh to check your work' is a command with no arguments, expected inputs, or expected output. This matches anchor 2 ('high-level hints but missing the specific steps to execute'); it is above anchor 1 only because a real script path is named. | 2 / 5 |
Workflow Clarity | A rough two-step sequence is implied (read the guide, then run validate.sh), but the steps are poorly defined, the guide contains no actual steps to follow, and there is no indication of what validation checks or what to do on failure. This matches anchor 2 ('rough sequence present but many gaps; validation absent'). | 2 / 5 |
Progressive Disclosure | Structure is good: short overview, clear '## Usage' section, and a clearly signaled one-level-deep reference (references/guide.md, verified to exist) plus a named script (scripts/validate.sh, verified to exist). It falls short of anchor 5 because the referenced guide is itself a contentless stub ('Follow these steps to set up the skill') and the Notes section duplicates inline material that adds little navigational value. | 4 / 5 |
Total | 12 / 20 Passed |