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.
A high-quality, current-API skill body: executable examples for every execution path, an explicit core workflow with validation checkpoints, and a clean one-level reference structure. The only weakness is minor token load from a few sections (citation instructions, join_data gotcha detail) that could live in reference files.
Suggestions
Move the detailed multi-register 'join_data' guidance (register ordering, LSB placement caveat) into references/primitives.md, keeping only a one-line pointer in SKILL.md.
Compress the citation-fetching instructions ('Citing Scientific Agent Skills' section) to a short pointer, since the DOI resolution steps rarely need to be in top-level context.
Make the 'IBM QPU Estimation' example self-contained by defining or re-acquiring 'backend' (e.g., via QiskitRuntimeService), since it currently relies on a variable only defined in the earlier sampling section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive with no basic-concept padding ('Do not install qiskit-terra; it was superseded', 'qiskit.pulse was removed in Qiskit 2.0'), but a few sections could be trimmed: the citation-fetching instructions and the multi-register 'join_data' paragraph duplicate detail that belongs in references. It is not a 3 because nothing explains concepts Claude already knows, and not a 5 because of those minor over-explanations. | 4 / 5 |
Actionability | Five complete, executable code blocks (local sampling, local estimation, IBM QPU sampling, IBM QPU estimation, batch mode) plus concrete install commands and runnable bundled scripts ('python scripts/run_local_primitives.py --shots 1024 --seed 7') cover the common cases copy-paste ready. No pseudocode or vague direction is present. | 5 / 5 |
Workflow Clarity | The Core Workflow gives an explicit Map -> Optimize -> Apply layout -> Execute -> Analyze sequence, reinforced by a Final Checklist with concrete validation steps (verify parameter order, run locally before QPU, inspect depth and two-qubit operations). Validation checkpoints are explicit before the costly QPU submission step, matching the top anchor. | 5 / 5 |
Progressive Disclosure | A Reference Map table routes each topic to one of 11 one-level-deep reference files, all of which exist on disk, and three bundled scripts are listed with their invocations and safety boundaries ('The Runtime inspection script selects or inspects a backend but never submits a quantum job'). Navigation is easy and content is appropriately split. | 5 / 5 |
Total | 19 / 20 Passed |