Content
67%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.
A well-structured, highly actionable body: seven condition-based workflows with mostly executable code, real reference and script bundles one level deep, and a troubleshooting section. Weaknesses are mild redundancy (Overview, When-to-Use, and Resources sections restate scope and file listings), a few non-runnable placeholder snippets, and some reference material duplicated inline.
Suggestions
Make the constrained-problem and constraint-handling snippets executable by defining the objective and constraint expressions instead of placeholders like 'g1, g2, h1'.
Trim the duplicated scope statements: merge the Overview paragraph and the 'When to Use This Skill' bullet list, and drop the per-file re-descriptions in Resources since each is already signaled with a 'See:' pointer inline.
Move the algorithm-selection tables and benchmark quick-access list fully into references/algorithms.md and references/problems.md, keeping only a pointer in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with executable code and does not explain concepts Claude already knows, but the 'Overview' paragraph duplicates the frontmatter description, the 9-bullet 'When to Use This Skill' section restates the same scope, and the Resources section re-describes files already pointed to inline — matching 'mostly efficient but includes some unnecessary explanation or could be tightened' (anchor 3). Not 4 because the duplication is noticeable across three sections rather than minor instances. | 3 / 5 |
Actionability | Most workflows give copy-paste-ready code with real imports and parameters (GA on rastrigin, NSGA-II on zdt1, NSGA-III with reference directions, pseudo-weight MCDM), each pointing to a complete runnable script. Anchor 4 rather than 5 because a few snippets are not executable as-is: the constrained example uses undefined 'f1, f2, g1, g2, h1', and Workflow 5 references undefined 'problem', 'termination', and bare 'np'. | 4 / 5 |
Workflow Clarity | Each of the seven workflows has numbered steps, an explicit 'When:' condition, and algorithm-choice guidance, and the troubleshooting section gives problem→fix feedback ('Algorithm not converging → increase population size...'). Not anchor 5 because workflows lack explicit verification checkpoints (e.g., checking result.F/CV after a run); not 3 since sequencing is coherent and error-recovery guidance exists. | 4 / 5 |
Progressive Disclosure | The body stays an overview with quick inline examples while the bulk lives in five real, well-organized reference files (verified to exist: algorithms.md 180 lines, problems.md 265, operators.md 345, visualization.md 353, constraints_mcdm.md 417) and five executable scripts, all one level deep with 'See:' pointers and a grep-based search guide. It falls short of 5 because the ~560-line body duplicates reference material (algorithm selection tables, benchmark quick-access, operator lists) that could live entirely in the references. | 4 / 5 |
Total | 15 / 20 Passed |