Content
66%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 exceptionally actionable and the workflow control flow (sequencing, stop points, critique loop, verification) is a model of explicitness, but it pays for that with severe verbosity — rules restated three or four times, embedded incident narratives, and rationale-asides — and zero progressive disclosure: a 40K monolith with no reference files where clearly separable material (question format, agent-dispatch protocol, SALP formats) is inlined.
Suggestions
Split the self-contained 'Question Format (FR-UNIVERSAL.QA-FORMAT)' section and the surface-scout/plan-critic dispatch protocol into reference files (e.g. references/question-format.md, references/agent-dispatch.md), leaving SKILL.md a lean overview with one-level-deep pointers — the body currently carries ~40K characters inline with no bundle files at all.
Deduplicate rules stated in multiple places: the frontmatter five-key/eliding-is-a-defect rule is repeated verbatim in rule 9, step 3, step 5a, and the Output Format section — state it once and reference it.
Move dated incident post-mortems ("observed 2026-09-06, plan-affected-surface-scout: ...", "2026-09-06: plan-recommends-root-over-symptom ...") out of the operative rules; they are history, not instruction, and per the rubric's time-sensitivity guideline belong in a separate defect-notes reference if kept at all.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40K-character body restates the same constraints in three or four places ("Eliding a key is a defect" appears in rule 9, step 3, step 5a, and the Output Format section) and pads rules with incident post-mortems ("observed 2026-09-06, `plan-affected-surface-scout`: the two scout rows for `documents/` and `.codex/` had no bullet...", "2026-09-06: `plan-recommends-root-over-symptom` offered three DB-side variants...") and multi-clause rationale asides ("a dispatch you launched and never collected has cost turns and bought nothing, and the pull to shrug and enumerate the tree yourself is strongest exactly there"). This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than anchor 1, since the verbosity is self-written process prose, not explanations of concepts Claude already knows. | 2 / 5 |
Actionability | Guidance is fully concrete and copy-paste ready: a canonical frontmatter YAML block, exact SALP row format (`- [REF:fr:<id> | <FR-ID>] — <one-line summary> — <status>`), exact insert strings (`- **Tasks:** [REF:task:<YYYY>-<MM>-<slug> | <slug>]`), and runnable commands (`mkdir -p`, `date +%Y-%m-%d`, `ls .claude/agents/ .cursor/agents/ .opencode/agent/ "${CODEX_HOME:-$HOME/.codex}/agents/" 2>/dev/null`). Per the rubric's instruction-only note, the absence of program code isn't penalized because every instruction carries an exact format or command; this matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | Steps 1–8 are explicitly sequenced with STOP points ("STOP and wait", "Never stop here with nothing written", "TOTAL STOP"), a built-in feedback loop (step 6 critique → step 7 triage/apply), validation checkpoints (5a acceptance-tuple check, completeness check, "Only ambiguity that blocks stating the Goal may halt you"), and a final verification checklist. Anchor 5 ('clear sequence with explicit validation steps; feedback loops for error recovery; checklists') is the best fit; the oddly ordered sub-steps (5a, 5c, 5b) is a cosmetic blemish, not a validation gap that would drop it to anchor 4. | 5 / 5 |
Progressive Disclosure | There are no bundle files (references/, scripts/, assets/ are absent) and no references at all — the entire skill is one ~40K-character file. Large self-contained blocks that clearly belong in separate files are fully inlined: the ~2.5K-character "Question Format" section, the surface-scout dispatch protocol with host-specific variants (Codex spawn_agent/wait_agent instructions), and the SALP row/back-pointer format rules. This matches anchor 2 ('minimal structure; content that clearly belongs in separate files is inlined'); not anchor 1 because the body has clear internal section organization, and not anchor 3 because there are no references to signal and the inlined mass is very large. | 2 / 5 |
Total | 14 / 20 Passed |