Content
86%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-executed index-style skill: lean, dense with non-obvious operational gotchas, and structured for progressive disclosure with a routing table and verified one-level-deep references. The only weakness is that key workflow commands (create/spawn) live entirely in the reference files rather than having a minimal inline example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean index with no padding: every line carries Trellis-specific knowledge Claude cannot already know (scope semantics, deprecated --linked-context-* terminology, the --kind done vs --tag dispatcher gotcha, --raw for audit). It never explains generic concepts, matching the 'lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | First Commands are copy-paste-ready bash commands and the intent table maps user phrasings directly to specific reference files. Score is 4 rather than 5 because the common creation/spawn workflows (e.g. channel create, channel spawn) are only delegated to references rather than shown, leaving minor gaps in executable coverage. | 4 / 5 |
Workflow Clarity | A clear sequence is present: run --version/--help, list channels, 'inspect it before asking for background' as an explicit checkpoint, then route by intent table into core rules. No validation loops are required since destructive operations (kill, interrupt) are delegated to workers.md rather than instructed inline, but the checkpoint coverage is implicit rather than exhaustive, fitting anchor 4. | 4 / 5 |
Progressive Disclosure | The body explicitly declares itself an index ('This skill is an index. Load only the reference file for the current job'), provides a Route By User Intent table, and lists all five reference files with one-line summaries. All five referenced files exist on disk and contain no nested references, so navigation is one level deep and unambiguous. | 5 / 5 |
Total | 18 / 20 Passed |