Content
46%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 content has a genuine, actionable workflow core (entity extraction rules plus an output template pointing to a real reference), but it is buried under generic boilerplate sections that add little skill-specific value. Tightening the padding and adding concrete validation would improve it.
Suggestions
Remove or collapse boilerplate sections (Dependencies, Implementation Details, Required Inputs, Output Contract) that restate general norms Claude already knows; keep only skill-specific guidance.
Inline a short concrete example of an actual database query (e.g., a sample PubMed Boolean string built from PICOS) instead of deferring all query syntax to the reference file.
Replace generic validation boilerplate with a concrete, skill-specific check (e.g., verify each of the 7 databases has a populated query block and that PICOS fields are non-empty before emitting the result).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Much of the body is generic boilerplate (Dependencies, Implementation Details that says 'See ## Workflow above', When to Use, Required Inputs, Output Contract) that restates norms Claude already knows rather than adding skill-specific knowledge. | 2 / 5 |
Actionability | Step 1 gives concrete extraction rules (limit 5 keywords, simplification example, term mapping) and the output template is specific, but the core executable detail of building database queries is deferred to references/databases.md rather than shown inline. | 3 / 5 |
Workflow Clarity | A clear two-step sequence exists, but validation checkpoints are generic boilerplate ('Validate required inputs before execution') rather than concrete, skill-specific verification steps tied to the output. | 3 / 5 |
Progressive Disclosure | The one real reference (references/databases.md, which exists) is clearly signaled inline at Step 2, and the body functions as an overview; minor gaps come from boilerplate sections diluting the structure. | 4 / 5 |
Total | 12 / 20 Passed |