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-architected meta-skill: excellent annotated reference structure, concrete commands and config keys, and strong safety guidance in the Do Not section. Its two real defects are two referenced bundle files that do not exist, and noticeable cross-section repetition of the v0.6 surfaces that inflates token cost without adding guidance.
Suggestions
Add the missing reference files 'references/local-architecture/multi-agent-channel.md' and 'references/local-architecture/bundled-skills.md' to the bundle (or remove their entries from How To Use and References), since both the routing and the reference index currently point to files that are absent.
Trim the redundancy: the channel event log path, bundled .trellis/agents/ definitions, trellis mem sources, and getBundledSkillTemplates() are each stated in the intro paragraph and again in References and/or Current Rules — state each fact once and cross-reference it.
Break the ~180-word single-sentence v0.6 overview paragraph into short bullets (channel runtime / cross-session memory / dual-package release) so the opening section is scannable and cheaper to read.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and almost entirely Trellis-specific with no filler explanations of concepts Claude already knows, but the same facts are restated across sections: the channel event log path appears three times, '.trellis/agents/{check,implement}.md' in six places, and the trellis mem sources and getBundledSkillTemplates() twice each — the ~180-word v0.6 overview sentence alone re-describes what References and Current Rules repeat. This is more than 'minor instances that could be trimmed', placing it below the efficient anchor. | 3 / 5 |
Actionability | Guidance is highly concrete throughout — executable commands ('task.py create --parent <slug>', 'trellis workflow --template <id>', 'trellis mem list | search | context | extract | projects'), exact config keys (channel.worker_guard.idle_timeout, hooks.after_create), and specific file paths. The gap is that 'references/local-architecture/multi-agent-channel.md' and 'references/local-architecture/bundled-skills.md' are referenced in How To Use and References but absent from the bundle, leaving those navigation steps unexecutable. | 4 / 5 |
Workflow Clarity | The 'How To Use' section gives a clear, conditionally routed 5-step sequence with explicit validation ('Before editing, read the actual files in the user project and treat local content as authoritative' and 'cross-check against the local .trellis/config.yaml and the installed CLI's trellis --help'). It falls short of the top anchor because there are no error-recovery feedback loops and step 3 directs the reader to a reference file that does not exist in the bundle. | 4 / 5 |
Progressive Disclosure | The structure is exemplary — a lean overview body, a routing section, and ~20 one-level-deep references each annotated with a one-line description. Scored against the actual bundle, however, two of the referenced paths (references/local-architecture/multi-agent-channel.md and references/local-architecture/bundled-skills.md) are missing, which breaks navigation for the multi-agent channel and bundled-skills topics and drops it below the clear-and-complete top anchor. | 4 / 5 |
Total | 15 / 20 Passed |