Content
46%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 with real, clearly linked reference files, but it is markedly verbose—inlining definitions of concepts Claude already knows and an unrelated schematics section—and offers checklists of questions rather than a concrete, executable evaluation workflow.
Suggestions
Remove the inlined bias/fallacy/statistics definitions (concepts Claude already knows) and rely on the existing reference files, keeping only the decision-relevant checklist prompts in SKILL.md.
Delete or relocate the 'Visual Enhancement with Scientific Schematics' section; it is off-scope for critical thinking and cites a scripts/generate_schematic.py that is not present in the bundle.
Convert the claim-evaluation and critique sections from lists of questions into an explicit sequenced workflow with decision checkpoints (e.g., classify claim strength → match to evidence → flag red flags → emit structured critique).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~570-line body extensively inlines concepts Claude already knows (defining every bias, fallacy, and p-value basics) and includes an off-topic 'Visual Enhancement with Scientific Schematics' section that references a non-existent scripts/generate_schematic.py, producing several padded, unnecessary sections. | 2 / 5 |
Actionability | Provides a concrete five-part critique structure and per-domain checklists of questions to ask, but guidance is mostly prompts-to-consider rather than executable decision procedure, leaving key how-to-decide detail incomplete. | 3 / 5 |
Workflow Clarity | Numbered sequences exist (claim evaluation, design process, critique structure) but they read as taxonomies; no explicit validation checkpoints or error-recovery feedback loops are present, though the task is non-destructive so the hard cap does not bind. | 3 / 5 |
Progressive Disclosure | Well-sectioned overview with six clearly signaled, one-level-deep reference files that all exist on disk; the main gap is that large bias/fallacy/statistics taxonomies are inlined in the body duplicating the reference files rather than living only in references. | 4 / 5 |
Total | 12 / 20 Passed |