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 body contains a genuinely usable core (parameters, commands, validation check, error handling) but is buried under template boilerplate and duplicated sections with broken cross-references. Trimming to the skill-specific content would substantially improve it.
Suggestions
Remove the duplicated stub sections ('See ## X above') and consolidate the two Usage/Features/Prerequisites occurrences into single sections.
Delete the generic Security Checklist, Risk Assessment, Lifecycle, and Evaluation Criteria template filler, or reduce them to the few lines that are specific to this plotting skill.
Replace the non-portable 'cd "20260318/scientific-skills/..."' path with a path relative to the skill bundle, and drop the 'in-file CONFIG block' instruction since the script uses CLI arguments instead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~190-line body is heavily padded: the description is repeated verbatim in 'When to Use', stub sections say 'See `## Features` above for related details', the same sections (Usage, Features, Prerequisites) appear twice, and generic Risk Assessment / Security Checklist / Lifecycle / Evaluation templates add little skill-specific value. | 2 / 5 |
Actionability | Concrete executable commands are provided (py_compile check, --help, full usage example, parameters table with defaults), but the hardcoded 'cd "20260318/scientific-skills/..."' path is non-portable and 'Edit the in-file CONFIG block' does not match the actual script. | 4 / 5 |
Workflow Clarity | A numbered 5-step workflow plus a 4-step run plan with an explicit pre-execution validation checkpoint (py_compile) and a documented error-handling fallback; not 5 because several steps remain abstract and there is no validate-fix-retry loop. | 4 / 5 |
Progressive Disclosure | The bundle reference (scripts/main.py) is real and one level deep, but in-file navigation is broken and duplicative — 'Key Features' points to '## Features above' when that section appears below, and duplicated section content that should be consolidated or split is inlined. | 3 / 5 |
Total | 13 / 20 Passed |