Content
63%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 skill body is well-organized, concise, and sequence-clear with useful error-recovery guidance, but its actionability is undermined by a dangling reference to a nonexistent classification script and vague semantic-matching direction. Bundle hygiene is the weakest area: one referenced resource is missing, another is an unreferenced truncated stub, and the taxonomy is not linked by path.
Suggestions
Resolve the dangling "bundled classification script" reference in Step 2 — either add the actual script under scripts/ or inline the concrete classification rules (e.g., the living-thing criteria from references/taxonomy.md) so the filtering step is executable as written.
Reference bundle files explicitly by path (e.g., "See [references/taxonomy.md](references/taxonomy.md)") instead of vague phrases like "bundled resources", and complete or remove the truncated references/action_patterns.md stub.
Replace "Use semantic similarity matching" with a concrete procedure (e.g., specific heuristics or the exact taxonomy categories to match against) so generic target descriptions are handled executably.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and domain-specific (observation parsing cues, prioritization rules, environment rules like "All containers are open"), with no explanation of concepts Claude already knows. Minor trimmable padding exists — the Purpose section restates the frontmatter description, and phrases like "for your current task" add little — keeping it just below anchor 5. | 4 / 5 |
Actionability | There is genuinely concrete guidance (exact observation markers "Here you see:", "a substance called", exact-name rules, and a worked example ending in `focus on turtle egg` → `pick up turtle egg` → `teleport to bathroom`), but the core Step 2 defers to "the bundled classification script", which does not exist in the bundle (no scripts/ directory), and "Use semantic similarity matching" is unspecified. A missing central executable resource is a key-detail gap, matching anchor 3 rather than anchor 4's "minor gaps". | 3 / 5 |
Workflow Clarity | Steps 1–4 are clearly sequenced, and the Error Handling section provides recovery loops ("If no matches found: Teleport to another room and repeat", "If ambiguous matches: Use `examine OBJ`", "If classification uncertain: Check reference taxonomy"), approaching anchor 5. It stays at 4 because checkpoints are a separate section rather than embedded validation steps in the workflow, and the fallback path relies on a taxonomy reference and script that are poorly wired up. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned, but reference signaling is weak: the taxonomy is referenced only vaguely as "reference taxonomy in bundled resources" with no path or link, the "bundled classification script" points to a nonexistent file, and references/action_patterns.md is a truncated stub (ends mid-outline at "### Pattern 1: Simple Pickup") that is never referenced at all. This matches anchor 3 — references present but not clearly signaled — rather than anchor 4's "references mostly clear". | 3 / 5 |
Total | 14 / 20 Passed |