Content
78%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 tight, well-structured instruction skill: it documents exact tool contracts and failure modes, sequences the workflow clearly with verification checkpoints, and avoids teaching concepts Claude already knows. The only real gaps are mild Quick Start/Workflow duplication and the absence of a worked example of search criteria and fields.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean (~40 lines), assumes Claude's competence, and conveys non-obvious operational facts (tool failure conditions, parameter names, partial-success behavior) rather than explaining known concepts. Minor trimmable redundancy keeps it from anchor 5: the Quick Start steps substantially duplicate the Workflow section (e.g. 'Prune the candidate table before downloading structures' vs '### 2. Prune before download'), and the single-sentence Overview restates the frontmatter description. | 4 / 5 |
Actionability | Guidance is concrete for an instruction-only skill: named tools (`mp_search_materials`, `mp_download_structure`), named parameters/outputs (`output_csv_rel`, `output_dir`, `mp_id`), and specific behavioral contracts ('fails on empty criteria or empty fields', 'supports partial success', 'use the returned results and errors'). It falls short of anchor 5 because no concrete example of search criteria or a requested-fields set is given — 'Define search criteria and requested fields' and the References note defer to the tool schema instead of showing a worked case. | 4 / 5 |
Workflow Clarity | A clear three-step sequence (search with explicit criteria → prune via the CSV ledger → download only retained candidates) with verification checkpoints present: inspect preview rows, check returned results/errors rather than assuming success, and report partial-download failures in the Output Contract. Anchor 5 is not reached because the error-recovery loop is thin — failures are flagged for 'follow-up' but no retry/fix guidance is given for the batch download step. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (references/, scripts/, assets/ do not exist) and no external references are needed; the rubric's simple-skill exception applies and the well-organized sections (Overview, Quick Start, Suggested tools, Workflow, Output Contract, References) earn a 5. The References section is a behavioral pointer to the live tool schema, not a file reference, so there are no broken or deeply-nested reference paths. | 5 / 5 |
Total | 17 / 20 Passed |