Content
60%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 provides a clear, actionable four-step workflow that correctly delegates detail to a real prompts reference and an extraction script. Its main weakness is verbosity from generic templated boilerplate sections that could be trimmed.
Suggestions
Remove or condense the generic "When to Use", "Key Features", and "Implementation Details" bullets that duplicate the description or state generic process truisms.
Add an explicit final validation step that checks the generated JSON against study_risk_of_bias_schema before returning it.
Consolidate the "Example Usage" compile/help commands with the Helper Scripts section to reduce redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Several padded, templated sections add little value: the six "When to Use" bullets, "Key Features" duplicating the description, and generic "Implementation Details" lines like "validate the request, choose the packaged workflow, and produce a bounded deliverable" are noticeably verbose boilerplate. | 2 / 5 |
Actionability | Each workflow step points to a specific named prompt in references/probast_prompts.md and the PDF step gives a concrete executable command ("python scripts/extract_pdf.py"), with only minor gaps since the prompt contents live in the bundle rather than inline. | 4 / 5 |
Workflow Clarity | The four-step sequence (metadata, parallel domain assessment, overall risk, JSON output) is clearly ordered with per-step inputs and prompt references; the only gap is a missing explicit validation of the final JSON against study_risk_of_bias_schema. | 4 / 5 |
Progressive Disclosure | SKILL.md is an overview pointing one level deep to real bundle files (references/probast_prompts.md and scripts/extract_pdf.py) that are clearly signaled, though redundant boilerplate sections leave minor organization gaps. | 4 / 5 |
Total | 14 / 20 Passed |