Content
73%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 well-structured instruction skill with an excellent validated workflow: ordered steps, an explicit dependency-check gate with failure handling, and concrete output specifications. Its weaknesses are redundancy — the 22 Hard Rules substantially restate section mandates — and three orphaned bundle files that no document links to.
Suggestions
Deduplicate the Hard Rules: drop rules that verbatim restate Step 4.5 and Sections C.5/G/I/J (e.g., rules 11–12, 16, 19–22) and keep a single canonical statement of each mandate, cutting 30–40 lines.
Link analysis-modules.md, method-library.md, and workflow-step-template.md from the relevant body sections (e.g., method-library from Step 6, workflow-step-template from Section D) so every bundle file is reachable from the overview.
Inline one worked example of a workflow step (per workflow-step-template.md) and one sample formal reference entry with identifier, so the output format is concrete without opening the reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is instruction-dense rather than padded with background concepts Claude already knows, but the 22-item Hard Rules section heavily restates content already stated in the body — rules 11–12 repeat Step 4.5's citation rules, rule 16 restates Section G's subset requirement, and rules 19–22 restate the C.5/I/J 'mandatory in every output' declarations. This matches the score-3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') — above score 2, since there is no concept-teaching padding, but below score 4, since the rule/section duplication is systematic rather than minor. | 3 / 5 |
Actionability | As an instruction-only skill, the guidance is highly concrete: exact output sections A–J with required contents, exact redirect and Dataset Disclaimer text to reproduce verbatim, input examples, minimum retrieval counts ('2–4 outcome/exposure background references... 1 explicit evidence-gap note'), and a worked dependency-formula list. It stays at score 4 rather than 5 because a few instructions remain process-level without a worked example inline (e.g., 'provide the full workflow using the required stepwise format' delegates the format entirely to a reference file, and no sample workflow step or sample reference entry is shown in the body). | 4 / 5 |
Workflow Clarity | The seven steps are explicitly ordered ('always run in order'), and Step 5 is a genuine validation gate before output: a dependency consistency checklist ('Do causal claims appear without explicit instrument-selection and harmonization logic?'), forbidden-claim rules, and explicit failure handling ('If dependency fails, remove or downgrade the downstream claim rather than silently keeping it'). Insufficient-detail handling ('infer a reasonable default and state assumptions explicitly') and the six-element self-critical risk review add error-recovery feedback. This matches the score-5 anchor (clear sequence with explicit validation steps and feedback loops). | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview with clearly signaled one-level-deep references ('→ Detailed pattern logic: [references/study-patterns.md]'), and all five linked reference files exist with no nested second-level references. However, three of the eight bundle files — analysis-modules.md, method-library.md, and workflow-step-template.md — are linked from neither SKILL.md nor any other reference file, making them undiscoverable. Good structure with a real navigation gap places this at score 4 rather than 5; it is above score 3 because the linked references are clear and the overview/detail split is appropriate. | 4 / 5 |
Total | 16 / 20 Passed |