Content
77%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 highly actionable, well-sequenced brainstorm workflow with copy-paste commands, templates, gates, and confirmation checkpoints. Its weaknesses are token efficiency — the PRD template is duplicated and key rules are restated multiple times — and a monolithic single-file structure where templates and research-format details would be better split into reference files.
Suggestions
Remove the duplicated PRD template: keep the Step 0 seed template and replace the 'PRD Target Structure (final)' section with a short diff-style note of what changes on convergence (e.g., 'Open Questions and Assumptions sections are removed; Decision (ADR-lite) and Technical Approach are filled in').
Consolidate the repeated 'action before asking' guidance: state it once in Core Principles and have Gates A–B and the Anti-Patterns section reference that principle instead of restating it, saving several hundred tokens.
Split stable artifacts — the PRD seed template and the research output format — into a references/ file (e.g., references/prd-template.md) and link to it, keeping SKILL.md as a navigable overview; also clearly mark 'workflow.md' and '.trellis/scripts/task.py' as external project dependencies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, directive content (gates, tables, commands, templates) rather than concept explanation, but it could be tightened: the full PRD template appears twice (Step 0 seed template and the near-identical "PRD Target Structure (final)" section), and "action before asking / no derivable questions" is restated at least four times (CoreRule, Principle 2, Gates A–B, Anti-Patterns), matching the score-3 anchor of mostly efficient with some unnecessary repetition. It does not reach score-4 efficiency because the duplicated PRD template and the long Codex-exception paragraph are clearly trimmable, but it is well above the score-2 anchor's padded explanatory sections since nearly everything is actionable instruction rather than filler. | 3 / 5 |
Actionability | Guidance is fully executable throughout: exact bash commands ("python3 ./.trellis/scripts/task.py create ... --slug <auto>"), complete copy-paste PRD markdown templates, multiple-choice question message templates, a complexity-to-action table, and concrete Task-tool sub-agent dispatch syntax with ❌/✅ examples. This matches the score-5 anchor (copy-paste ready commands covering common cases) rather than score-4, which allows minor gaps — the only placeholder, "--slug <auto>", is immediately explained by the instruction to use a slug without a date prefix. | 5 / 5 |
Workflow Clarity | The Steps 0–8 are clearly sequenced with explicit checkpoints: the Question Gates before any ask, immediate PRD updates after each answer (a feedback loop), a final confirmation gate ("Does this look correct? If yes, I'll proceed"), and checklists (repo inspection, documentation) — matching the score-5 anchor of clear sequence, explicit validation, feedback loops, and checklists. No destructive or batch operations are involved, so the validation cap does not apply, and score 4's "minor validation gaps" does not fit given the built-in confirmation and convergence checkpoints. | 5 / 5 |
Progressive Disclosure | The body has clear step-based section structure, but everything is inlined in a single ~550-line file with no bundle references at all; content that naturally belongs in separate files (the full PRD templates, the research output format, the Codex exception details) sits inline, and inline references to "workflow.md Phase 1.2" point outside the bundle without being clearly signaled as external. This matches the score-3 anchor (some structure, content that could be separate is inline); it falls short of score 4's "most content is appropriately placed" because nothing is split out despite the volume, and the simple-skill exception (under 50 lines) plainly does not apply. | 3 / 5 |
Total | 16 / 20 Passed |