Content
92%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.
An excellent meta-skill body: concrete commands, paths, and config keys throughout, a well-sequenced conditional workflow with explicit pre-edit validation and destructive-overwrite guards, and clean one-level-deep progressive disclosure verified against the actual bundle. The only weakness is mild verbosity where overview paragraphs duplicate detail already covered in reference files.
Suggestions
Compress the 'Trellis v0.6 adds three architectural surfaces' paragraph to a one-line summary per surface and defer the detail to references/local-architecture/multi-agent-channel.md, workspace-memory.md, and bundled-skills.md.
Move the per-platform detail (Pi's trellis_subagent dispatch modes, Reasonix's runAs frontmatter, Kimi Code's shared skill layer) out of the platform-directory bullet and into references/platform-files/platform-map.md, keeping only the directory list inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is Trellis-specific with no explanations of concepts Claude already knows, but the ~170-word 'Trellis v0.6 adds three architectural surfaces' paragraph and the platform-directory bullet's per-platform detail (Pi trellis_subagent modes, Reasonix frontmatter, Kimi Code layout) partially duplicate dedicated reference files and could be tightened. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact commands ('trellis workflow --template <id>', 'task.py create --parent <slug>', 'trellis channel spawn --agent <name>'), exact config keys ('codex.dispatch_mode: inline | sub-agent', 'channel.worker_guard.idle_timeout'), exact paths, and specific Do/Don't rules — fully actionable for an instruction-only skill. | 5 / 5 |
Workflow Clarity | The 'How To Use' section gives a clear 5-step conditional read sequence with an explicit pre-edit validation checkpoint ('read the actual files in the user project and treat local content as authoritative'), a destructive-overwrite guard ('check `.trellis/.template-hashes.json` first and prefer `.new` sidecar files'), and a fact-check guard (cross-check `trellis --help` before claiming a knob exists). | 5 / 5 |
Progressive Disclosure | A genuine overview body pointing to 22 one-level-deep reference files, all verified to exist on disk, each with a clear one-line description organized into three grouped sections; navigation is easy and content is appropriately split. | 5 / 5 |
Total | 19 / 20 Passed |