Content
57%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 generated stub that delegates entirely to an external shared skill file. While maximally lean, it offers no actionable guidance, no workflow, and no overview on its own — and its single reference targets an absolute home-directory path that is not part of the skill bundle (and does not exist in this environment), making the skill unusable as written.
Suggestions
Inline a minimal quick-start section (e.g., the core documentation-retrieval command or workflow) so the skill remains actionable when the shared file at ~/.agents/skills/find-docs/SKILL.md is unavailable.
Replace the environment-dependent absolute path with a bundle-relative reference (e.g., files under references/) so the skill is self-contained and portable.
Add a brief overview of what the shared skill covers so SKILL.md functions as an index/entry point rather than a bare redirect.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — a generator comment and one directive — with zero padding and no explanation of concepts Claude already knows. Every token present is doing work, matching the lean 5 anchor. | 5 / 5 |
Actionability | The single instruction "Load and follow the shared skill at ~/.agents/skills/find-docs/SKILL.md" names an exact path and an unambiguous action, so it is not vague (not 1), but it contains no substantive guidance for the skill's actual task — everything actionable lives in a file outside this bundle. It provides only a high-level hint with the actual steps missing, matching the 2 anchor. | 2 / 5 |
Workflow Clarity | The one directive given is unambiguous, but the real workflow (how to retrieve and verify library documentation) is entirely externalized with no visible sequencing or checkpoints. This sits between the 2 anchor (steps poorly defined) and the simple-skill 5 exception (single unambiguous action) — the delegation hides a multi-step process, so 3 fits best. | 3 / 5 |
Progressive Disclosure | The sole reference is clearly signaled and exactly one level deep with no nesting (better than the 3 anchor's buried references), but the body contains no overview content whatsoever and the reference points to an environment-dependent absolute path outside the bundle rather than a bundled file. It is not a well-structured overview with appropriately split content, so it does not reach 4. | 3 / 5 |
Total | 13 / 20 Passed |