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 delivers genuinely actionable, executable guidance for scipy.constants, CODATA searching, and the Materials Project API, organized into clear labeled workflows. Its weaknesses are verbosity — long print-demo blocks and a duplicated quick-reference table that teach Claude nothing it doesn't know — and structure: everything is inlined in one 225-line file when the PDG and quick-reference tables belong in separate reference files. It also promises NIST Chemistry WebBook and OEIS coverage in the description that the body never delivers, and its own 'never hardcode constants' rule is contradicted by the hardcoded PDG and astronomical values.
Suggestions
Replace the print-statement demonstrations in sections 1, 2, and 6 with a compact API summary — Claude can call `const.c` without seeing 20 example print lines — and cut the duplicated Quick Reference table.
Move the PDG particle table and the constants quick-reference into separate reference files (e.g., `references/pdg.md`, `references/constants.md`) and link them from SKILL.md, keeping the body a lean overview.
Either add workflows for NIST Chemistry WebBook and OEIS or remove them from the description, and reconcile the 'never hardcode constants' rule with the inline PDG/astronomical values (e.g., point to `pdg.lbl.gov` lookup or an astropy-based method as the primary path).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Sections 1–2 are ~80 lines of print-statement demonstrations that merely echo constant values Claude could obtain directly from `scipy.constants` — tutorial padding that teaches nothing new. The Quick Reference table then re-lists values already demonstrated, and the PDG section inlines a ~50-line hardcoded particle dict. This is noticeably verbose with several padded sections, matching anchor 2 rather than the 'minor instances of over-explanation' at 4. | 2 / 5 |
Actionability | The guidance is mostly executable: concrete `scipy.constants` usage, a working `find_constant` search function, and a complete Materials Project query function with API-key handling and ImportError fallback. Minor gaps keep it from 5: section 5 is a data dict rather than runnable lookup code, section 6 relies on an earlier import without restating it, and two databases promised in the description (NIST Chemistry WebBook, OEIS) have no corresponding workflow at all. | 4 / 5 |
Workflow Clarity | This is a reference/lookup skill rather than a multi-step process, and the content is organized as six clearly labeled, self-contained workflows with a tips section — the core action (query `scipy.constants`, never hardcode) is unambiguous. It sits at anchor 4 ('clear sequence with most checkpoints present; minor gaps') rather than 5 because there are no verification steps (e.g., checking the CODATA edition or confirming a value's uncertainty) and no stated decision path for which source to use when several overlap. | 4 / 5 |
Progressive Disclosure | Section headers and numbered workflows give reasonable structure, but the ~225-line body is monolithic — the PDG particle table and the Quick Reference table are exactly the bulk reference material that belongs in separate files loaded on demand. With no references/, scripts/, or assets/ files at all, nothing is split out, matching anchor 3 ('some structure but content that should be separate is inline') rather than the well-signaled one-level-deep references at 5. | 3 / 5 |
Total | 13 / 20 Passed |