Content
88%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 lean overview: a crisp done/boundaries contract plus a five-step workflow with explicit checkpoints, routing all detail to real, well-scoped reference files. The only structural cost is two-level reference chaining, and a couple of steps leave the exact inspection action to judgment.
Suggestions
Make step 4's inspection instruction slightly more concrete (e.g., name the preferred browser tool or what 'in-scope surface' means) so actionability reaches fully executable guidance.
Consider listing the secondary references (dev-server recipes, launch-json-schema, live-remote) in a short navigation block in SKILL.md or flattening the run.md -> recipe chain, so the bundle reads as one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~23-line body assumes Claude's competence throughout: no concept explanations, no padding, every sentence carries operational content (e.g., "Read `references/run.md` before resolving the requested ref or starting anything"). Even the dense step-1 disclosure sentence is load-bearing requirement text, not filler, so it matches anchor 5 rather than anchor 4's "minor instances of over-explanation". | 5 / 5 |
Actionability | Steps are concrete and delegating: named files to read ("Read `references/run.md`"), a named sibling skill to invoke ("invoke `ce-commit` for the polish changes"), and specific reporting outputs ("report the commit(s), the still-running server URL, and any residual blocker"). Per the rubric's code-vs-instruction note, absent code is not penalized, but phrases like "inspect only as needed, edit the in-scope surface" and "use a browser capability available in the active harness" leave the exact action to judgment, which is the minor gap that keeps this at anchor 4 instead of 5. | 4 / 5 |
Workflow Clarity | The five-step Run sequence has explicit checkpoints and stop conditions: ask live-or-traditional "once, before any server starts", "Wait for observations. ... Do not start a review pass", the feedback loop of iterate/hot-reload/inspect, and explicit termination criteria in the Done section (every fix reflected or reported as blocked; blocker ends the run with resume evidence). It exceeds anchor 4 because validation and closure conditions are explicit rather than implicit. | 5 / 5 |
Progressive Disclosure | The body is a lean router: it signals exactly which reference owns what ("`references/live-start.md`; it owns preconditions, install, the endpoint, and the URL handoff"; "`references/run.md` ... owns existing-worktree safety, dev-server discovery ..."), and all referenced files exist in the bundle. Scored against the actual bundle, references chain two levels from SKILL.md (run.md routes onward to dev-server-*.md and launch-json-schema.md; live-start.md routes to live-loop.md, live-remote.md, and install-riffrec.md), which is more depth than the anchor-5 "one-level-deep" pattern, so anchor 4 fits. | 4 / 5 |
Total | 18 / 20 Passed |