Content
70%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.
The body is a tightly written craft guide with an exemplary steps-plus-done-when workflow and checkable validation, and it correctly contains no code padding. Its weaknesses are a redundant MUST list that duplicates earlier sections and inlined per-run detail that belongs in reference files per the skill's own disclosure rule.
Suggestions
Cut the trailing MUST/MUST NOT block or the duplicated rules in Shape/Fixed-step Skill so each rule has one home, per the skill's own 'one home' principle.
Move the Run handoff section and the handoff.md format block into a reference file (e.g. references/handoff.md) and link to it, keeping SKILL.md to the core craft and steps.
Define or link what 'the gate' is in Step 1, since the gate's content lives in grilling-for-routine and is not restated here.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The prose is terse and imperative throughout ("Write numbered steps. Each step has a done-when."), but the closing MUST/MUST NOT block (lines 88-100) repeats rules already stated in Shape and Fixed-step Skill ("Do not use em dashes" vs "MUST NOT use em dashes", "No second-person identity" vs "MUST NOT assign a second-person identity"), which violates the skill's own 'Keep each rule in one home' principle. This is 'mostly efficient but could be tightened', not 4, because the duplication is a noticeable block (~13 of 101 lines) rather than a minor trim. | 3 / 5 |
Actionability | The body gives concrete paths (~/.dora/harness/<slug>/handoff.md, .env), a literal handoff.md format block, and numbered steps with checkable done-whens; as an instruction-only skill the guidance is executable. It stops short of 5 because some instructions assume external context from grilling-for-routine ('Read the grill answers. Use the gate.' never defines the gate here) and the example prompt block covers only the poll/skip/apply shape. | 4 / 5 |
Workflow Clarity | The Steps section is a clear 5-step sequence where every step carries an explicit, checkable done-when, step 4 is a dedicated validation pass ("no second-person identity, no em dashes, every step has a done-when"), and step 5 defines the handoff back to grilling-for-routine. This matches 'clear sequence with explicit validation steps; checklists for complex processes'. | 5 / 5 |
Progressive Disclosure | Sections are well-labeled and the skill is ~100 lines with no bundle files, but detail that its own rule says belongs 'in a later file' (the Run handoff mechanics, the handoff.md format block, the dora session/wire tooling notes in the opening) is inlined in SKILL.md. This fits 'some structure but content that should be separate is inline', not 4, since no references exist at all to offload that detail. | 3 / 5 |
Total | 15 / 20 Passed |