Content
67%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.
A well-structured, concise overview with clear sequencing and a useful commands table. Its main weakness is actionability: the skill tells the agent what outcomes to produce ('go ham', auto-detect, generate files) without any executable mechanism — no scripts, install steps, or content templates — so Claude cannot fully execute setup from the body alone.
Suggestions
Add concrete execution details for setup: either reference bundled scripts/templates or show the exact CLAUDE.md content and file-creation steps the agent should perform.
Include a post-setup validation checkpoint (e.g., run 'ham audit' or verify the routing section resolves to real files) with a fix-and-retry loop.
Move the two example dialogues into a references/examples.md to keep SKILL.md a leaner overview with one-level-deep pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: no explanations of concepts Claude already knows, tight section structure, and a commands table instead of prose. Example 1's eight-file listing and the sample agent dialogues are mildly padded and could be trimmed, which keeps it below the lean 5 anchor but well above the verbose 2-3 anchors. | 4 / 5 |
Actionability | Concrete elements exist (trigger commands like 'go ham', the .memory/ file structure, the routing markdown snippet, expected outputs), but the actual execution path is missing: no scripts are referenced, no install/setup commands, no templates for the CLAUDE.md contents the agent should write, and 'auto-detects your project platform' is unexplained. This matches the 3 anchor — concrete guidance that is incomplete with key details missing — rather than 4's mostly-executable guidance. | 3 / 5 |
Workflow Clarity | Setup → Context Routing → Dashboard is clearly sequenced, with a commands table and maintenance checkpoints in Best Practices ('run ham audit every 2 weeks', 'review .memory/inbox.md periodically'). It falls short of 5 because there is no explicit post-setup validation (e.g., verify routing entries exist or files parse) and no error-recovery loop. | 4 / 5 |
Progressive Disclosure | The body is well organized into clearly signaled sections (When to Use, How It Works, Commands, Examples, Best Practices, Limitations) with all content appropriately inline for a skill of this size and no nested or buried references. It does not reach 5 because there are no one-level-deep reference files at all (Examples or dashboard details could live in references/), and the ~120-line body slightly exceeds a lean overview. | 4 / 5 |
Total | 15 / 20 Passed |