Content
92%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.
An exemplary skill body: executable code throughout, a validated multi-step workflow with failure-mode handling, and clean one-level-deep progressive disclosure into six real reference files. The only trim opportunity is the Purpose and Scope section duplicating the frontmatter description and the lengthy citation protocol.
Suggestions
Compress the 'Use matchms for' / 'Do not use matchms as a replacement for' bullet lists, which restate the frontmatter description almost verbatim, into a single short scope sentence.
Consider moving the full citation-fetching protocol (arXiv API details, version-suffix rules) into a reference file and keeping a two-line citation reminder in SKILL.md to reclaim context tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with version-pinned, non-obvious knowledge (removed APIs, StackedSparseArray outputs, tolerance semantics) and avoids explaining concepts Claude already knows, but the 'Purpose and Scope' bullets ('Use matchms for: ...' / 'Do not use matchms as a replacement for: ...') largely restate the frontmatter description, and the ~16-line citation protocol is a trimmable add-on — fitting the level 4 'minor instances that could be trimmed' anchor rather than 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is fully executable: pinned install commands with a verification one-liner, a complete runnable Quick Start (load, harmonize, filter, score, ranked output extraction), a working pair() snippet, a Spectrum construction snippet, and a parameterized CLI invocation — copy-paste ready and covering the common cases per the level 5 anchor. | 5 / 5 |
Workflow Clarity | The 8-step Operating Workflow is clearly sequenced with explicit validation checkpoints ('Drop invalid spectra explicitly', 'Estimate len(references) * len(queries) before scoring', 'Validate top hits visually and chemically'), handles the known failure mode (filters returning None), and is backed by a 'Non-Negotiable Checks' checklist, satisfying the level 5 anchor including validation for the batch all-pairs operation. | 5 / 5 |
Progressive Disclosure | The body is a well-signaled overview pointing one level deep into six reference files, each introduced with a one-line scope under 'Read only the reference needed for the task', with all cited paths (references/importing_exporting.md, filtering.md, similarity.md, workflows.md, migration.md, sources.md, scripts/library_search.py) verified to exist and bulk detail correctly split out of SKILL.md. | 5 / 5 |
Total | 19 / 20 Passed |