Content
71%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 well-structured, dense with skill-specific guidance, and highly actionable on its face — concrete per-step commands, a deterministic-tools table, onboarding config, and an explicit anti-patterns section. Its main defect is bundle integrity: every referenced script, reference, and asset path is absent from the bundle, making the deferred-detail navigation dead and the commands unexecutable as shipped, with some repetition of the core recurrence rule as a secondary trim opportunity.
Suggestions
Ship the referenced bundle files (scripts/study_designer.py, scripts/saturation_planner.py, scripts/insight_synthesizer.py, scripts/onboard.py, scripts/ar_evaluator.py, assets/research_plan_template.md, and the three references/*.md files) or inline their essential content, so the cited paths resolve and the workflow commands execute.
State the insight-recurrence rule once canonically (e.g., in Purpose) and reference it from the tool description, anti-patterns, and forcing questions instead of restating it four times.
Add an explicit validation checkpoint to the Workflow's final step, e.g., verify synthesizer output tags against the atomic repository schema (and re-tag if mismatched) before filing insights.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and skill-specific throughout — the workflow, scripts table, onboarding, and forcing-question sections all carry non-obvious content (method-mapped flags, config scopes, canon citations). However, the core insight-recurrence rule is restated ~4 times ("a single quote is an anecdote", "flags any candidate below the source threshold as an ANECDOTE", "One participant is a signal to probe", "require recurrence across ≥3 sources"), and the intro largely restates the frontmatter description — minor trimming opportunities, matching level 4 rather than the every-token-earns-its-place level 5; well above level 3 since nothing explains concepts Claude already knows. | 4 / 5 |
Actionability | Concrete, complete CLI invocations with all flags: "study_designer.py --goal {discovery|evaluative|validation} --stage {concept|prototype|beta|live} --profile {...}", "saturation_planner.py --method {...} --segments N", "insight_synthesizer.py --input observations.json --min-sources 3", plus runnable quick examples and onboarding commands. Not 5 because the referenced scripts (scripts/study_designer.py, saturation_planner.py, insight_synthesizer.py, onboard.py, ar_evaluator.py) and assets/research_plan_template.md are not present in the bundle, so the copy-paste-ready commands cannot actually execute as shipped; not 3 because the guidance itself is specific, syntactically complete, and covers the common cases. | 4 / 5 |
Workflow Clarity | A clearly sequenced 5-step workflow (frame → pick method → size → synthesize → file in repository) with a concrete command per step and useful checkpoints ("Honor the redirect if it routes to experiment-designer", "Record the confidence label and limits", "Treat ANECDOTE-flagged clusters as signals, not findings"). Not 5 because there is no explicit validate-output/recovery step (e.g., verifying repository tags before filing); not 3 because checkpoints are mostly present and the sequence has no gaps. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned with a dedicated References section giving one-line descriptions of three reference files, and references are one level deep and clearly signaled. However, none of the referenced bundle files exist — there is no scripts/, references/, or assets/ directory in the bundle — so every cited path (3 references, 5 scripts, 1 asset) is dead and navigation to the deferred detail is impossible. This sits between level 3 (structure present but organization compromised) and level 4; the dead references keep it at 3 rather than 4, while the clean internal signaling keeps it above 2. | 3 / 5 |
Total | 15 / 20 Passed |