Content
65%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 lean delegation stub that defers all substance to an external shared skill file. While nothing is wasted token-wise, the skill as bundled provides no local overview, workflow, or fallback guidance, and its sole reference points outside the bundle, leaving it unverifiable and fragile if that path is missing.
Suggestions
Add a 2-3 line local overview of what graphify does and its core workflow (build → query → explain) so the skill is not a bare redirect if the shared file is unavailable.
Include a fallback instruction for when ~/.agents/skills/graphify/SKILL.md does not exist (e.g., how to proceed or where to install it), since the current body is unusable without that path.
Remove or fix the dangling reference to scripts/agent-harnesses.py, which is not present in this bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The entire body is two lines — a provenance comment and 'Load and follow the shared skill at `~/.agents/skills/graphify/SKILL.md`' — with zero padding and no explanation of concepts Claude already knows, matching the lean anchor 5. | 5 / 5 |
Actionability | The single instruction names a concrete, readable path, but the body contains no guidance on the actual task — everything actionable lives in an external file outside the bundle — fitting anchor 3 (concrete but incomplete) rather than 4, since no task-relevant detail exists locally. | 3 / 5 |
Workflow Clarity | The delegation step itself is unambiguous, but no sequencing, validation, or fallback (e.g., if the target path is absent) is given, and the multi-step graph-build workflow is entirely unrepresented; the simple-skill exception does not apply because the underlying capability is multi-step and wholly delegated. | 3 / 5 |
Progressive Disclosure | The reference is clearly signaled and one level deep, but the body is a bare redirect with no overview of the skill's content, the target sits outside the bundle (unverifiable here), and the comment cites 'scripts/agent-harnesses.py' which does not exist in this bundle — anchor 3 rather than 4. | 3 / 5 |
Total | 14 / 20 Passed |