Content
77%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 maximally concise, unambiguous redirect stub: perfect token efficiency and clear single-step workflow, but it contains none of the skill's actual guidance — everything is delegated to an external shared path that is not part of the bundle and does not resolve in this environment. As a standalone SKILL.md it is not self-contained, which hurts actionability and progressive disclosure.
Suggestions
Inline a minimal quick-start (e.g., the core documentation-retrieval workflow or a representative command/example) in the body so the skill provides actionable guidance even when the shared file cannot be resolved.
Move or vendor the shared skill content into the skill's own bundle (e.g., a references/ directory with a relative path) so the reference is verifiable and one level deep within the skill.
Add a fallback instruction for when `~/.agents/skills/find-docs/SKILL.md` is absent, since the external path does not exist in this environment and the skill currently dead-ends without it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — a generator comment and one instruction ("Load and follow the shared skill at `~/.agents/skills/find-docs/SKILL.md`.") — with zero explanation of concepts Claude already knows, matching anchor 5 ('lean and efficient; every token earns its place'). Nothing can be trimmed; there is no over-explanation to penalize. | 5 / 5 |
Actionability | The single directive is concrete (an exact file path, unambiguous action), but it delegates 100% of the actual guidance to an external file outside the skill bundle, so no steps, commands, or examples for the skill's core task exist in the skill itself — matching anchor 3 ('some concrete guidance but incomplete; missing key details'). Not a 2 because the pointer is specific rather than a high-level hint; not a 4 because there is no executable content for the task itself. | 3 / 5 |
Workflow Clarity | This is a single-action skill and the action is unambiguous: load and follow the named file. Per the simple-skill guideline ('single task... can score 5 if the single action is unambiguous'), it matches anchor 5. No destructive or batch operations are involved, so no validation checkpoints are required. | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/ directories), and the body's sole reference points outside the skill to `~/.agents/skills/find-docs/SKILL.md`, which does not exist in this environment and cannot be verified as one-level-deep navigable content; the comment's `scripts/agent-harnesses.py` also does not exist. The pointer itself is clearly signaled, but the skill is a pure redirect stub with no in-bundle structure or content, landing at anchor 3. Not a 4: 'most content is appropriately placed' fails when all content is external and unverifiable. | 3 / 5 |
Total | 16 / 20 Passed |