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.
A tight, high-signal instruction skill: a clearly sequenced verification workflow with explicit checkpoints, concrete commands and paths, and disciplined deferral of detail to external references. The only deductions are minor: a small motivational intro paragraph that could be trimmed and a suite mode whose executor invocation could be more concrete.
Suggestions
Trim the opening motivation paragraph ("The most documented failure of coding agents is claiming success regardless of reality...") to a single sentence stating the stance, since Claude already knows agents overclaim success.
In suite mode, give one concrete example of how to launch the executor subagent against a scenario copy (command or prompt template), so that mode is as copy-paste actionable as the default mode.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and almost every token is operative (standing rules, fraud definitions, verdict format), but the opening motivation paragraph ("The most documented failure of coding agents is claiming success regardless of reality...") states a failure mode Claude already knows, and occasional rhetorical framing ("guilty until its justification traces to a spec") could be trimmed. It fits the score-4 anchor (efficient, minor instances of over-explanation) better than score 5 (every token earns its place) and far better than score 3. | 4 / 5 |
Actionability | Concrete guidance throughout: specific commands (`git diff`, `git status`, `/fable-judge suite <target>`), exact file paths (`fable-method`'s `references/failure-modes.md`, `references/domains/`, `eval/workflow.js`, `eval/README.md`), an ordered fraud checklist, and a prescribed verdict format. It stops short of the score-5 anchor because the suite mode's executor-subagent invocation is not copy-paste ready and "re-run every claimed verification" is necessarily generic; it clearly exceeds the score-3 anchor (pseudocode/incomplete). | 4 / 5 |
Workflow Clarity | The default mode is a clear 5-step sequence with explicit validation checkpoints: diff as ground truth, re-running every claimed verification, UNVERIFIABLE labeling for non-rerunnable claims, evidence-first verdict delivery with a claims table, and read-only standing rules. The suite mode also validates against scenario ground truths. The work is read-only, so the destructive/batch cap does not apply; this matches the score-5 anchor (explicit validation steps, feedback loops, checklists). | 5 / 5 |
Progressive Disclosure | The ~39-line body stays an overview: two clearly headed modes, with the failure-mode catalogue, domain adapters, and eval mechanics correctly deferred to well-signaled one-level-deep references ("The full catalogue is `fable-method`'s `references/failure-modes.md`", `references/domains/`, `eval/`). Both install cases (plugin vs standalone) are addressed, so navigation is unambiguous — the score-5 anchor, not the score-4 anchor with organization gaps. | 5 / 5 |
Total | 18 / 20 Passed |