Content
82%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 code-first, highly executable skill body: every workflow is runnable as written and decision guidance (when/when-not, method comparison, troubleshooting) is concise. The main gaps are moderate — plotting boilerplate inflates token cost, and the two secondary workflows belong in reference files to keep the main file lean.
Suggestions
Move the N-body and Poincaré-section workflows into references/ (e.g. references/nbody.md, references/poincare.md) and keep SKILL.md to a lean overview with well-signaled links.
Trim matplotlib cosmetics (axis labels, grids, legends) from the inline example to just the orbit plot and energy trace.
Add an explicit post-run validation step to each workflow (e.g. 'verify max |ΔH/H₀| < tolerance; if it drifts, halve dt or switch to Yoshida') to turn the troubleshooting table into in-workflow feedback loops.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no space is spent explaining what Hamiltonians or NumPy are, and the prose is limited to decision guidance (When to Use / Do NOT Use, comparison table). The only trimming candidate is matplotlib boilerplate (xlabel/ylabel/grid/legend lines) in the Kepler example, which is cosmetic rather than skill-relevant, matching the 'minor instances of over-explanation' anchor rather than the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | All four workflows are complete, executable, copy-paste-ready NumPy code: the leapfrog implementation includes working Kepler initial conditions, a printed energy-conservation check, and Yoshida coefficients spelled out. The examples cover the common cases (2D Kepler, 3-body figure-8, Poincaré section), fully matching the 'copy-paste ready code covering common cases' anchor. | 5 / 5 |
Workflow Clarity | The four core workflows are numbered and self-contained, with an embedded checkpoint (the energy-drift check in workflow 1) and a symptom→fix Troubleshooting table providing error-recovery guidance. Validation checkpoints are not woven into workflows 2–4 and the document presents parallel alternatives rather than one validated sequence, so it matches 'clear sequence with most checkpoints present; minor validation gaps' rather than the full feedback-loop anchor. No cap applies since the operations are non-destructive. | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), so everything is inline in one file. Structure is good — clear section headers, comparison tables, a troubleshooting table — but roughly 150 lines of code with secondary workflows (N-body, Poincaré section) inlined in SKILL.md would fit the disclosure model better as one-level-deep reference files. This matches 'good structure; most content appropriately placed; minor organization gaps' rather than a lean overview with well-signaled references. | 4 / 5 |
Total | 17 / 20 Passed |