CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cirq

Cirq is Google Quantum AI's open-source framework for designing, simulating, and running quantum circuits on quantum computers and simulators.

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/cirq/SKILL.md

The canonical home for this skill is cirq in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

53%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.

The body is a well-organized overview with executable quick-start code and concrete templates, but it has recurring prose/bullet redundancy and its six clearly-signaled reference files do not exist in the bundle, leaving the promised deep content undeliverable. Fixing the dangling references is the highest-impact improvement, followed by tightening the duplicated Core Capabilities sections.

Suggestions

Ship the six referenced files under references/ (building.md, simulation.md, transformation.md, hardware.md, noise.md, experiments.md) or remove/inline the pointers — the skill currently promises content it cannot deliver.

Remove the redundant duplication between each Core Capabilities lead-in sentence and its "Common topics" bullet list, keeping one or the other.

Make code examples self-contained: define `q0`/`simulator` in the parameterized example and show the `workspace` setup in the Azure template so snippets are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly code and terse lists with no concept-teaching padding, but every "Core Capabilities" section pairs an intro sentence that restates the "Common topics" bullets beneath it (e.g. "For comprehensive information about building quantum circuits, including qubits, gates, operations, custom gates, and circuit patterns, see:" followed by a bullet list repeating those topics). This systematic duplication plus the generic Best Practices advice means it fits anchor 3 (mostly efficient, could be tightened) rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Installation commands and the quick-start circuit are executable, and the three templates are concrete, but there are minor gaps: the parameterized example reuses `q0` and `simulator` from the previous block without redefining them, and the Azure template calls `AzureQuantumService(workspace)` with an undefined `workspace`. This matches anchor 4 (mostly executable with minor gaps) rather than 5 (fully copy-paste ready throughout).

4 / 5

Workflow Clarity

The content is organized by topic rather than as sequenced workflows; there are no explicit multi-step processes with validation checkpoints. Hints like "Always test on simulators first" and the Common Issues troubleshooting give implicit checkpoints and error recovery, fitting anchor 3 (sequence/checkpoints missing or implicit) rather than 4, which requires most checkpoints explicitly present.

3 / 5

Progressive Disclosure

Six references are clearly signaled and one level deep (references/building.md, simulation.md, transformation.md, hardware.md, noise.md, experiments.md), but none of these files exist in the bundle — the references/ directory is absent. Scored against the actual bundle structure per the judging guidelines, progressive disclosure is advertised but not delivered: all detailed content is unreachable. This falls to anchor 2 rather than 3, since the problem is not that references could be better signaled but that the referenced paths are missing entirely.

2 / 5

Total

12

/

20

Passed

Description

65%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.

The description identifies a distinct niche with good natural keywords, but it reads as the library's tagline rather than a skill description: the action verbs are generic and there is no explicit trigger guidance for when to use the skill. Adding a "Use when..." clause and concrete capability actions would raise completeness and specificity.

Suggestions

Add an explicit trigger clause, e.g. "Use when working with Cirq, building or simulating quantum circuits, running variational algorithms, or executing circuits on quantum hardware."

Replace the tagline verbs with concrete skill actions: mention noise modeling, circuit optimization/transformation, parameter sweeps, and hardware execution across Google/IonQ/Azure/AQT/Pasqal providers.

Include common user phrasings like "quantum computing", "qubits", and "quantum gates" to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain and a few actions ("designing, simulating, and running quantum circuits"), but these are the framework tagline's generic verbs rather than concrete skill actions — capabilities like noise modeling, hardware execution, parameter sweeps, and circuit optimization are absent. It matches anchor 3 (domain plus limited actions, not comprehensive) rather than 4, whose several specific actions leave only minor gaps.

3 / 5

Completeness

It clearly answers "what" (a framework for designing, simulating, and running quantum circuits) but contains no "when" — no "Use when..." clause or equivalent trigger guidance. Per the judging guidelines, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Keywords "Cirq", "quantum circuits", "quantum computers", and "simulators" are terms users would naturally say when needing this skill. It fits anchor 4 (good coverage with a few natural terms missing) but not anchor 5, since common variations like "quantum computing", "qubits", or "gates" are absent.

4 / 5

Distinctiveness Conflict Risk

"Cirq is Google Quantum AI's open-source framework" names a clear niche with distinct triggers ("Cirq", "quantum circuits") that would not naturally appear when other skills are needed. This matches anchor 5 (clear niche, minimal conflict risk).

5 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

13

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/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.