Content
56%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 skill is well-structured with clear progressive disclosure to 9 reference files and a solid sequenced workflow, but it suffers from heavy cross-sectional repetition and lacks concrete worked examples of its deliverables.
Suggestions
Consolidate the redundant guidance across Task / Core Function / Execution / Hard Rules / What This Skill Should Not Do / Quality Standard into a single authoritative section to reduce token bloat.
Add at least one worked example deliverable (a sample image-generation prompt, a sample Mermaid flowchart, or a sample designer handoff brief) to lift actionability.
Trim the restated 'recommend uploading protocol/title-abstract/figure-list' instruction, which appears in at least four separate sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The same core guidance (clarify first, don't overclaim, route by capability, explain logic, recommend uploads) is restated across Task, Core Function, Execution, Mandatory Output Structure, Formatting Expectations, Hard Rules, What This Skill Should Not Do, and Quality Standard — noticeably verbose with several padded, duplicative sections. | 2 / 5 |
Actionability | Provides a concrete Mandatory Output Structure (sections A-J with specific sub-bullets) and named block categories, but lacks any worked example (no sample prompt, Mermaid, or storyline), leaving key execution details unspecified. | 3 / 5 |
Workflow Clarity | A clear 9-step numbered sequence with explicit validation checkpoints (Step 1 input clarification, Step 8 uncertainty flagging, Output A Input Match Check, Output I Claim Boundary Check); minor gaps in that checkpoints are clarification-oriented rather than validate-fix-retry loops. | 4 / 5 |
Progressive Disclosure | Body is an overview pointing to 9 real, one-level-deep reference files in references/, each well-signaled with a 'Use to/Use when' note; all referenced paths exist and navigation is easy. | 5 / 5 |
Total | 14 / 20 Passed |