Content
85%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 exceptionally lean, well-sequenced orchestration body with genuine validation feedback loops and thorough failure handling. Its one material defect is bundle integrity: the four load-bearing reference files the workflow depends on are absent, which both breaks navigation and blocks full executability.
Suggestions
Ship the four missing reference files under <skill>/reference/ (interview.md, directions.md, candidate-spec.md, distill.md) — they are load-bearing for Phases 1, 2, 3, and 6, and their absence makes the referenced paths dangling.
If any reference is intentionally excluded, inline its minimal content (e.g., a candidate-spec skeleton or a condensed interview question list) so the phase can still be executed from SKILL.md alone.
Add a one-line bundle manifest or file inventory so missing references are detectable before a run starts rather than mid-workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~60-line body is dense imperative instruction with no concept explanations: path conventions are defined once ("All paths below: `<skill>` = ... `<run>` = `.design-md/`"), phase steps are single-line directives, and failures are compressed into a table. Every token earns its place. | 5 / 5 |
Actionability | Gives copy-paste commands (`node <skill>/scripts/validate.mjs <run>/candidates/<id> --pages <page,list>`, `node -e "console.log(crypto.randomUUID())"`, the server launch) and exact JSON shapes for run.json/manifest.json. Falls short of fully executable because Phases 1, 3, and 6 delegate their instruction content to `<skill>/reference/interview.md`, `candidate-spec.md`, and `distill.md`, none of which exist in the bundle. | 4 / 5 |
Workflow Clarity | Clear phase sequence with explicit validation and feedback loops for a batch/destructive workflow: Phase 4 validates each candidate, retries failures once with validator errors fed back, enforces a >=3-valid threshold, and deletes invalid leftovers; Phase 6 finalize is transactional (tmp file → pinned lint → backup → rename → archive); Phase 0 gates resume/replacement; and the error-handling table covers server, lint, tab-close, and interruption failures with fallbacks. | 5 / 5 |
Progressive Disclosure | The on-paper design is good — each phase points to a one-level-deep reference at the point of need — but scored against the actual bundle, all four referenced paths (`reference/interview.md`, `reference/directions.md`, `reference/candidate-spec.md`, `reference/distill.md`) are missing while only `scripts/` and `assets/picker/` exist. Dangling references for the majority of phase detail is a major organization gap, not the minor one anchor 4 allows, though structure and signaling are far above anchor 2's buried/inlined-content pattern. | 3 / 5 |
Total | 17 / 20 Passed |