Content
71%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 lean, well-sequenced, tool-aware workflow with genuine validation checkpoints (preview inspection, results/errors checking for partial downloads). Its main weakness is actionability: it never shows an example search query, criteria set, or field list, so the executor must invent the most error-prone step, and there is no recovery loop for failed downloads.
Suggestions
Add a concrete example `mp_search_materials` invocation (sample criteria and requested fields) so the 'search with explicit criteria' step is executable rather than aspirational.
Add an error-recovery feedback loop for the batch download step: when `errors` is non-empty, retry failed `mp_id` values or trim them from the shortlist before reporting.
Fold the 'Suggested tools' list and the Quick Start steps into the Workflow to remove duplication with the frontmatter metadata and tighten the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40-line body is efficient and tool-specific (e.g. "writes the full result table to `output_csv_rel` and returns preview rows") with no concept explanations Claude already knows. Not 5 because Quick Start restates the Workflow sequence and "Suggested tools" duplicates the frontmatter metadata — minor trimmable redundancy. | 4 / 5 |
Actionability | Quotes: "Use `mp_search_materials` to write a CSV candidate table", "`mp_download_structure` writes conventional standard structures under `output_dir`" — concrete tool names, parameters, and behaviors are given, but there is no example query, criteria set, or field list; "Define search criteria and requested fields" is a high-level hint without executable specifics, matching anchor 3 (concrete guidance but missing key details). | 3 / 5 |
Workflow Clarity | The three steps (search with explicit criteria → prune before download → download retained candidates) are clearly sequenced, and validation checkpoints exist ("returns preview rows for quick inspection", "Use the returned `results` and `errors` rather than assuming every requested ID resolved"), so the batch-operation cap at 3 does not bind. Not 5 because there is no error-recovery feedback loop (e.g. retry or trim failed IDs) for the batch download step. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references (no references/, scripts/, or assets/ bundles exist), and is organized into clear sections (Overview, Quick Start, Suggested tools, Workflow, Output Contract, References). Per the rubric's simple-skill guidance, well-organized sections alone merit a 5; the References section is a pointer to the tool schema, not a broken file reference. | 5 / 5 |
Total | 16 / 20 Passed |