Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with concrete executable tool calls and a clear phased workflow, but it is over-long and monolithic, duplicating tool documentation inline rather than offloading it to reference files, and lacks explicit feedback-loop checkpoints for its batch operations.
Suggestions
Move the 'Tool Parameter Reference', 'Fallback Chains', and per-phase 'Output for Report' templates into separate reference files (e.g. TOOL_REFERENCE.md, REPORT_TEMPLATE.md) and link to them one level deep, reducing SKILL.md to an overview plus the phased workflow.
Add explicit validate->fix->retry checkpoints between phases (e.g., confirm FAERS returned data and apply the fallback chain before proceeding to disproportionality, and re-run any event whose response shape deviates from the documented structure).
Trim the fabricated sample numbers inside the output-for-report markdown blocks or mark them clearly as illustrative, and de-duplicate tools that already appear in the phased code examples to cut length without losing actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is reference-grade and mostly non-redundant conceptually, but at ~1100 lines it duplicates tool coverage (full Tool Parameter Reference re-lists tools already shown per-phase) and carries large illustrative output-for-report templates with fabricated sample counts that could be trimmed, fitting the score-2 'mostly efficient but could be tightened' anchor rather than the lean score-3 anchor. | 2 / 3 |
Actionability | It provides fully executable tu.tools.* calls with exact parameters and real response JSON shapes, a complete parameter reference table, fallback chains, and concrete error-handling code (the NOT_FOUND check), matching the score-3 'fully executable, copy-paste ready' anchor. | 3 / 3 |
Workflow Clarity | The 10-phase pipeline with an ASCII diagram, numbered subsections, a per-phase completeness checklist, and NOT_FOUND error handling is clearly sequenced, but batch disproportionality operations lack explicit validate->fix->retry feedback loops and inter-phase verify-checkpoints, which the rubric caps at 2 for batch/destructive workflows. | 2 / 3 |
Progressive Disclosure | No bundle files exist and the skill is a single monolithic ~1100-line SKILL.md holding all phases, the full tool reference, fallback chains, and edge cases inline; it is well-sectioned (avoiding a score-1 wall of text) but content that should be split into separate reference files is kept inline, matching the score-2 anchor. | 2 / 3 |
Total | 9 / 12 Passed |