Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, clearly sequenced drug-safety workflow with concrete tool schemas and explicit checkpoints. It loses points for instructional padding, the absence of executable compute examples despite directing their use, and a monolithic structure with no reference splitting.
Suggestions
Add at least one runnable Python example for the 'COMPUTE, DON'T DESCRIBE' directive — e.g. a pandas/statsmodels snippet computing PRR/ROR with 95% CI from a FAERS count matrix.
Trim tutorial asides Claude already knows (missing-data interpretation, the bias-type enumeration) to recover token budget.
Move the per-phase tool reference (inputs/outputs) and the PRR/ROR/IC interpretation tables into a reference file referenced one level deep, keeping SKILL.md as a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and well-structured, but includes tutorial-style asides Claude likely already knows (e.g. 'Missing data is informative — a missing lab value may mean the test wasn't ordered', and the channeling/notoriety/protopathic bias enumeration) that could be trimmed. | 2 / 3 |
Actionability | Tool names with exact input/output schemas and numeric signal thresholds are highly concrete, yet despite a 'COMPUTE, DON'T DESCRIBE' directive the body provides no executable Python code examples — guidance is actionable at the tool level but incomplete at the compute level. | 2 / 3 |
Workflow Clarity | A clearly sequenced 0-6 phase pipeline with explicit checkpoints — signal criteria (PRR >= 2.0, lower CI > 1.0, N >= 3), a 5-step signal-credibility checklist, and evidence grading tiers — giving an unambiguous execution path. | 3 / 3 |
Progressive Disclosure | Sections are well organized, but the skill is a monolithic single file with no bundle files (references/, scripts/, assets/ absent) and no one-level-deep references to split out the large tool reference and interpretation tables. | 2 / 3 |
Total | 9 / 12 Passed |