Content
78%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 dense, well-structured procedural skill that splits detail appropriately into one-level-deep reference and asset files, all of which are present and clearly signaled. It is actionable and well-sequenced with validation tooling, with minor room to tighten prose and make validation feedback loops explicit.
Suggestions
Make the validate-fix-retry loop explicit in workflow steps that invoke a script (e.g. 'If exit code is 1, review the report, fix the record, and re-run until exit code 0').
Trim definitional asides Claude already knows (e.g. the full FINER mnemonic expansion, 'PICO is not a universal template') to tighten conciseness.
Consider a brief inline example of a filled prediction/rival matrix or evidence-ledger row to lift actionability from concrete-command to copy-paste-ready for the core scientific outputs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and efficient for a complex domain, with specialized content (estimands, target-trial analogues, intercurrent-event handling) earning its place; a few explanatory disclaimers ('PICO is not a universal template', the FINER expansion) could be trimmed. | 4 / 5 |
Actionability | Provides concrete executable commands (e.g. 'python3 scripts/check_operationalization.py local-operationalization.json'), a full tool-index table with copy-paste invocations, and specific templates/frameworks; minor gaps remain in the inherently procedural reasoning steps. | 4 / 5 |
Workflow Clarity | A clearly sequenced 12-step workflow with per-step checklists and validation scripts referenced throughout; the validate-fix-retry feedback loop is implied via exit codes rather than spelled out explicitly in the steps. | 4 / 5 |
Progressive Disclosure | SKILL.md is a well-organized overview with one-level-deep references; the References and Local tool index sections clearly signal each bundled file (all referenced references/, assets/, and scripts/ paths exist on disk), making navigation easy. | 5 / 5 |
Total | 17 / 20 Passed |