Content
68%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.
This is an ultra-lean redirect stub: perfectly token-efficient with a clearly signaled one-level pointer, but it delegates 100% of the skill's substance to an external shared-skill path that is not in the bundle and does not exist in this environment. Actionability and workflow clarity are therefore unverifiable from the skill itself, not demonstrably strong.
Suggestions
Inline a minimal summary of the shared skill's core procedure (or bundle it under references/) so the skill remains actionable when the external path is unavailable, as is the case here.
Add a brief overview line stating what the plan format covers (steps, owners, validation) so the SKILL.md functions as an overview rather than a bare pointer.
Use a bundle-relative path (e.g. references/writing-plans.md) instead of an absolute home-directory path, and confirm the referenced file ships with the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two sentences plus a generation comment ("Load and follow the shared skill at ~/.agents/skills/writing-plans/SKILL.md") — nothing is over-explained and every token earns its place. It cannot exceed 5, and score 4 ('minor instances of over-explanation') does not apply since there is no padding at all. | 5 / 5 |
Actionability | The single directive is concrete in form (exact path, unambiguous 'Load and follow' instruction), but all substantive guidance for the skill's actual purpose is delegated to a file that is not part of the bundle and does not resolve in this environment — the key details are missing. This fits anchor 3 ('some concrete guidance but incomplete; missing key details') better than 4, whose gaps are only minor. | 3 / 5 |
Workflow Clarity | What is written is one unambiguous step (load the shared skill), but the skill's stated purpose — planning a multi-step task — has no visible sequence, steps, or validation checkpoints in this file; the entire workflow lives behind an unresolvable external pointer. Score 5 under the simple-skill exception does not apply because this is a front for a multi-step process, and anchor 2's 'rough sequence' is also not present — the written directive is clear while the real workflow has implicit, externalized checkpoints. | 3 / 5 |
Progressive Disclosure | The body is a well-signaled, exactly-one-level-deep reference ('Load and follow the shared skill at `~/.agents/skills/writing-plans/SKILL.md`') with nothing buried or nested. It falls short of anchor 5 because there is no overview content at all and the reference points to an absolute path outside the skill bundle rather than co-located files; it is above anchor 3 because the reference is clearly signaled and nothing is inlined that belongs elsewhere. | 4 / 5 |
Total | 15 / 20 Passed |