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.
A well-crafted routing skill: lean, fully sequenced, with an exhaustive decision table and clean deferral to the canonical workflow file. The only weaknesses are minor actionability gaps — an unexplained --platform flag and an unspecified lightweight/complex decision criterion.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean throughout: terse confirmations ("Confirms: current task, git state, recent commits."), a dense status/artifact routing table, and no explanation of concepts Claude already knows. Every routing bullet carries decision information, matching the "lean and efficient" anchor. Not 4: there is no trimmable over-explanation to remove. | 5 / 5 |
Actionability | Commands are executable and copy-paste ready ("python3 ./.trellis/scripts/get_context.py --mode phase") and routing conditions are explicit, but there are minor gaps: "--platform codex" appears unexplained, "decide whether the task is lightweight or complex" gives no criteria, and "--step <X.X>" is a placeholder. Not 5: these gaps mean the guidance is not fully self-sufficient for every decision point. | 4 / 5 |
Workflow Clarity | Clear ordered sequence (load context → load Phase Index → decide → load specific step) with explicit checkpoints: Step 1 confirms state, and the exhaustive status/artifact routing table covers every status value with a target step. No destructive or batch operations, so the validation cap does not apply. Not 4: checkpoints are explicit and complete, not implicit. | 5 / 5 |
Progressive Disclosure | The body is an explicit entry point with a clearly signaled one-level-deep reference ("Full workflow and detailed phase steps live in .trellis/workflow.md") and well-organized sections; no bundle files exist to mis-structure. Not 4: nothing that belongs in a separate file is inlined beyond the resume-essential routing table. | 5 / 5 |
Total | 19 / 20 Passed |