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 exemplary router-style skill body: a conditional, validation-checkpointed workflow; concrete commands and config keys throughout; and a fully verified, well-organized one-level-deep reference catalog. The only improvement space is trimming the redundancy between the v0.6 overview paragraph and the Current Rules section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — exact config keys (channel.worker_guard.idle_timeout, codex.dispatch_mode), CLI flags, and file paths with no basic-concept padding. However, the v0.6 overview paragraph ("Trellis v0.6 adds three architectural surfaces...") substantially restates details that reappear in the 'Current Rules' bullets and reference descriptions, so some tightening is possible — the 4 anchor rather than the lean 5 anchor. | 4 / 5 |
Actionability | Fully executable guidance throughout: a conditional routing workflow ('If the request involves a specific AI tool, read references/platform-files/platform-map.md'), copy-paste-ready commands (trellis workflow --template <id>, task.py create --parent <slug>, trellis channel spawn --agent <name>), and exact knobs with their values (codex.dispatch_mode: inline | sub-agent). For a navigation/meta skill this covers the common cases completely. | 5 / 5 |
Workflow Clarity | The 5-step 'How To Use' is clearly sequenced with conditionals, and includes explicit validation checkpoints: step 5 'Before editing, read the actual files in the user project and treat local content as authoritative', plus Do-Not guards against destructive overwrites ('check .trellis/.template-hashes.json first and prefer .new sidecar files') and a verify-before-claim loop ('cross-check against the local .trellis/config.yaml and the installed CLI's trellis --help before claiming a knob exists'). | 5 / 5 |
Progressive Disclosure | A clear overview that routes to 22 well-signaled, one-level-deep reference files organized into three labeled groups, each with a one-line description, and every referenced path verified to exist on disk (references/local-architecture/, platform-files/, customize-local/). The 'How To Use' section doubles as a navigation index; content is appropriately split between the inline core rules and the reference files. | 5 / 5 |
Total | 19 / 20 Passed |