Content
88%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 is a well-organized, highly executable guide: complete runnable PySINDy workflows, explicit validation-by-simulation, a parameter reference, and a symptom→fix troubleshooting table. Minor gains available from trimming the redundant Overview and moving advanced workflows into reference files.
Suggestions
Drop or shrink the Overview section, which repeats the frontmatter description, and remove self-evident code comments to tighten conciseness.
Split advanced workflows (custom function libraries, coefficient extraction) into a references/ file linked from a short 'Advanced' section, improving progressive disclosure as the skill grows.
Add the trigger synonyms 'system identification' and 'equation discovery' to the description to broaden natural-term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and code-dominated with no padding or explanation of concepts Claude already knows, but the Overview section re-states the frontmatter description and a few code comments ('Ground truth', 'sparsity threshold') restate the obvious — minor instances of over-explanation that could be trimmed, matching anchor 4 rather than the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Six complete, copy-paste-ready PySINDy programs cover the common cases (basic fit, threshold sweep, custom libraries, noisy data, simulation validation, coefficient extraction), backed by a key-parameters table — fully executable guidance with concrete examples covering the common cases. | 5 / 5 |
Workflow Clarity | Workflows are numbered in a clear progression from basic fit to validation, with an explicit validation workflow ('Validate: Simulate and Compare' including quantitative RMSE) and a troubleshooting table that serves as error-recovery feedback ('Too many terms discovered → Increase threshold'). The threshold sweep adds a complexity-vs-error feedback loop, matching the top anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the ~190-line body is well-sectioned with clear headers, so structure is good — but everything lives inline in SKILL.md (well above the 50-line simple-skill case), and advanced material like custom library construction or coefficient extraction could plausibly be split into reference files, matching anchor 4 ('most content is appropriately placed; minor organization gaps') rather than the reference-splitting anchor 5. | 4 / 5 |
Total | 18 / 20 Passed |