CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cirq

Google quantum computing framework. Use when targeting Google Quantum AI hardware, designing noise-aware circuits, or running quantum characterization experiments. Best for Google hardware, noise modeling, and low-level circuit design. For IBM hardware use qiskit; for quantum ML with autodiff use pennylane; for physics simulations use qutip.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered reference-style skill: pinned, reproducible installs; executable templates; honest caveats about hardware examples; and clean one-level-deep progressive disclosure into real reference files. The remaining weaknesses are modest — slight duplication between the 'Common topics' lists and the reference files, a few generic best-practice bullets, and one code example that isn't self-contained.

Suggestions

Trim the 'Common topics' bullet lists (or reduce each to 3-4 keywords) since they duplicate the opening lines of their corresponding references/*.md files.

Make the parameterized-circuit Quick Start self-contained by re-defining q0 and the simulator in that block so both examples are independently copy-paste runnable.

Prune generic Best Practices bullets ('Keep circuits modular and reusable', 'Document thoroughly with metadata') in favor of Cirq-specific guidance Claude would not derive on its own.

DimensionReasoningScore

Conciseness

The body is dominated by executable code and tight, version-pinned install commands, with little concept padding ('Density matrix simulation is O(2^2n)' is useful specificity, not fluff). Minor trims exist: some generic Best Practices bullets ('Keep circuits modular and reusable', 'Document thoroughly with metadata'), the six 'Common topics' lists partially duplicating their reference files' contents, and a long citation-fetching procedure — but these are minor, matching anchor 4 rather than the looser anchor 3.

4 / 5

Actionability

Install commands are exact and pinned ('uv pip install "cirq-core==1.7.0"'), and the Quick Start, noise-study, and variational templates are near copy-paste ready. Falls just short of anchor 5 on small gaps: the parameterized example reuses q0/simulator/np from the prior code block without redefining them, and the hardware template defers sampler configuration to hardware.md (though the deferral is explicitly and reasonably justified as illustrative).

4 / 5

Workflow Clarity

The build → simulate → transform → hardware → noise → experiments progression is mirrored in section order, and validation checkpoints appear where they matter: 'Always test on simulators first', 'Validate circuits against device constraints before execution', and device.validate_circuit() in the hardware template. It is a topical reference rather than a numbered procedure with explicit validate→fix→retry loops, so it sits at anchor 4 rather than 5; no destructive/batch operations apply, so the score-3 cap is not triggered.

4 / 5

Progressive Disclosure

SKILL.md is a genuine overview: every capability section is a one-line pointer to a real, existing references/*.md file ('Complete guide to...'), with topic lists aiding discovery; verified that all seven referenced files exist and cross-link only as one-level-deep siblings, never as nested chains. Code kept inline is appropriately the getting-started subset, matching the anchor-5 example structure.

5 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what/when structure, concrete domain-specific trigger terms, and unusually good routing guidance against the neighboring quantum skills (qiskit, pennylane, qutip). The main gaps are the absence of the word 'Cirq' in the description text itself and a lean 'what' that lists use contexts rather than concrete capabilities like circuit building and simulation.

DimensionReasoningScore

Specificity

Names the domain ('Google quantum computing framework') and several concrete activities — 'designing noise-aware circuits', 'running quantum characterization experiments', 'noise modeling, and low-level circuit design'. Not quite anchor 5 because it describes use contexts more than the full set of concrete actions the skill performs (e.g., circuit building, simulation, job submission).

4 / 5

Completeness

Explicitly answers both: what ('Google quantum computing framework... Best for Google hardware, noise modeling, and low-level circuit design') and when ('Use when targeting Google Quantum AI hardware, designing noise-aware circuits, or running quantum characterization experiments'). The 'Use when' clause contains concrete trigger phrases, matching anchor 5; voice is third person.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'quantum', 'Google Quantum AI hardware', 'noise', 'circuits', 'characterization experiments', plus routing terms like 'IBM hardware', 'quantum ML', 'physics simulations'. Falls short of anchor 5 because it omits a few natural synonyms users would say — most notably 'Cirq' itself, along with 'quantum circuit', 'simulation', and 'NISQ'.

4 / 5

Distinctiveness Conflict Risk

Claims a clear niche (Google Quantum AI hardware) and actively disambiguates siblings: 'For IBM hardware use qiskit; for quantum ML with autodiff use pennylane; for physics simulations use qutip.' This explicit routing gives minimal conflict risk, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

K-Dense-AI/scientific-agent-skills

Path

skills/cirq/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.