Content
78%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-structured, information-dense skill body that treats the context window seriously and routes detail to an excellent, verified one-level-deep reference bundle. The main gaps are minor: duplicated warnings, one overloaded paragraph, no worked edit example, and no explicit error-recovery loop in the workflow.
Suggestions
Deduplicate the npm/node_modules warning: it appears both in prose ("Do not default to modifying the global npm install directory or node_modules") and in the Do Not section ("Do not modify the global npm install directory or node_modules/@mindfoldhq/trellis..."); keep only the Do Not version and tighten the prose paragraph accordingly.
Split the overloaded v0.6 paragraph into three short labeled items (channel runtime, cross-session memory, dual-package release) so each surface is scannable instead of buried in one long sentence.
Add one small worked example for a common customization (e.g. a before/after snippet of adding a hooks.after_finish entry to .trellis/config.yaml) to lift actionability from specific-but-abstract to copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Trellis-specific facts Claude cannot know (paths, commands, config keys) and never pads with explanations of known concepts. Minor tightening is possible: the "do not default to the global npm install directory" warning appears in both prose (line 20) and the Do Not section (line 80), and the v0.6 paragraph packs three architectural surfaces into one overloaded sentence — matching 'efficient; minor instances that could be trimmed' rather than the fully lean level-5 anchor. | 4 / 5 |
Actionability | Concrete, executable commands appear throughout: "trellis workflow --template <id>", "task.py create --parent <slug>", "trellis channel spawn --agent <name>", "trellis mem list | search | context | extract", plus exact file paths and config keys (channel.worker_guard.idle_timeout, codex.dispatch_mode: inline | sub-agent). For an instruction-only skill the guidance is specific and actionable, but it stops short of copy-paste-ready edit examples for the common customization cases, keeping it just below the fully executable level-5 anchor. | 4 / 5 |
Workflow Clarity | The "How To Use" section gives a clear 5-step conditional routing sequence (overview first, then platform-specific, multi-agent, or customization references), ending with a validation gate ("read the actual files in the user project and treat local content as authoritative"). Additional checkpoints exist (check .trellis/.template-hashes.json before overwrites; cross-check trellis --help before claiming a knob exists), but there is no explicit error-recovery/feedback loop for when a step fails, which fits 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The body is a well-organized overview: a guided reading order, an annotated index of 23 one-level-deep reference files (all verified to exist under references/local-architecture/, references/platform-files/, and references/customize-local/), grouped by topic with one-line descriptions, plus concise current-rules and do-not sections. This matches the level-5 anchor of a clear overview with well-signaled one-level-deep references and easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |