Content
82%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 dense, highly actionable meta-skill with excellent reference navigation and concrete commands, paths, and config keys throughout. Its weaknesses are moderate cross-section redundancy and a bundle containing stale/unreferenced directories that SKILL.md navigation never surfaces.
Suggestions
Deduplicate the v0.6 surface descriptions: the opening paragraph, References descriptions, and Current Rules repeat the same facts about workflow templates, the channel runtime, and trellis mem; state each once and let the reference file carry detail.
Remove or fold in the orphaned reference directories (claude-code/, core/, how-to-modify/, meta/) that no SKILL.md path reaches — how-to-modify/ duplicates customize-local/ from a pre-v0.6 layout and risks an AI reading stale guidance.
Make the error-recovery path explicit for template conflicts: spell out the full validate loop (check `.trellis/.template-hashes.json` → detect 'modified by user' conflict → write `.new` sidecar instead of overwriting).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and fact-per-line (Current Rules bullets give exact paths, config keys, and commands) with almost no explanation of concepts Claude already knows. Not 5 because there is notable redundancy: the v0.6 surfaces (workflow templates, channel runtime, trellis mem, bundled agents) are described in the opening paragraph and again across the References and Current Rules sections. | 4 / 5 |
Actionability | Copy-paste-ready commands appear throughout (`trellis channel spawn --agent <name>`, `task.py create --parent <slug>`, `trellis workflow --template <id>`, `trellis mem list | search | context | extract | projects`) alongside exact config keys (`channel.worker_guard.idle_timeout`, `registry.spec.source`) and exact file paths. As an instruction-only skill the guidance is fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | "How To Use" gives a clear sequenced navigation workflow with conditional branching and a pre-edit checkpoint ("Before editing, read the actual files in the user project and treat local content as authoritative"), plus a cross-check rule ("cross-check against the local `.trellis/config.yaml` and the installed CLI's `trellis --help` before claiming a knob exists"). Not 5 because error-recovery feedback loops are implicit — e.g., what to do when `.trellis/.template-hashes.json` reports user-modified conflicts is only partially covered by the `.new` sidecar rule. | 4 / 5 |
Progressive Disclosure | All 23 referenced files exist, are one level deep, grouped into three clear sections, and each carries a one-line description — strong overview navigation. However, 17 of the 40 bundle files under references/ (claude-code/, core/, how-to-modify/, meta/) are not reachable from any navigation in SKILL.md, and how-to-modify/ appears to be a stale pre-v0.6 duplicate of customize-local/, which is a real organization gap that keeps this below anchor 5. | 4 / 5 |
Total | 17 / 20 Passed |