Skip to main content
skill CX Codex

azure-quantum — skill for Claude Code: Azure Quantum development

A skill for Claude Code, Codex, Cursor, and other AI coding assistants that adds expert knowledge of Azure Quantum.

CC-BY-4.0 168 installs ★ 818 updated 2026-11-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-quantum -a claude-code
Open on GitHub

What azure-quantum does

The skill covers diagnosing job failures, testing and debugging quantum programs through QDK, choosing job submission methods, managing quotas and sessions, configuring workspaces and development tools, and setting up workspace security via RBAC and access keys. The skill references local content and can fetch documentation from learn.microsoft.com using mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage.

Includes guidance on hybrid workflow patterns, Stim and qodec integration, resource estimation, QDK language support options, and regional provider availability for IonQ, Quantinuum, and Rigetti. Requires network access to pull documentation; falls back to fetch_webpage if mcp_microsoftdocs is unavailable.

What it helps with

  • Troubleshoot and resolve errors in Azure Quantum job submissions
  • Choose the right architecture for a hybrid quantum-classical workflow
  • Set up an Azure Quantum workspace with proper RBAC roles and secure access keys
  • Test and debug Q# and OpenQASM programs before running on real hardware
  • Select the best provider and region based on pricing and availability

Example prompts for the agent

  • Debug a failed Q# job submission to IonQ on Azure Quantum
  • Should I run my program on a simulator or submit it to real quantum hardware?
  • Help me configure Azure Quantum workspace access for my development team

How to install azure-quantum

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-quantum -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-quantum/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-quantum/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-quantum

How do I install azure-quantum in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-quantum -a claude-code. The skill will be available at ~/.claude/skills/azure-quantum/SKILL.md.

What does the azure-quantum skill do?

It provides your AI coding assistant with expert knowledge on Azure Quantum development: testing and debugging quantum programs, hybrid architecture patterns, quota and session management, workspace security, provider pricing, regional availability, and hardware constraints.

Does the skill require internet access?

Yes, the skill needs network access to fetch documentation from learn.microsoft.com. It uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage; if neither is available, the skill recommends installing the MCP server from the MicrosoftDocs/mcp repository.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-quantum
description: Expert knowledge for Azure Quantum development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when submitting Q#/OpenQASM jobs, configuring workspaces, using QDK/CLI, or running hybrid quantum workflows, and other Azure Quantum related development tasks.
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-08"
  generator: "docs2skills/1.0.0"
---
# Azure Quantum Skill

This skill provides expert guidance for Azure Quantum. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.

## How to Use This Skill

> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file

> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

This skill requires **network access** to fetch documentation content:
- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.

## Category Index

| Category | Lines | Description |
|----------|-------|-------------|
| Troubleshooting | L36-L43 | Troubleshooting Azure Quantum provider issues: diagnosing job failures and support/escalation policies and limits for IonQ, Quantinuum, and Rigetti hardware on Azure Quantum. |
| Best Practices | L44-L48 | Tools and techniques for testing, debugging, and validating quantum programs with the Azure Quantum Development Kit (QDK), including simulators, logging, and troubleshooting. |
| Decision Making | L49-L57 | Guidance on choosing job submission methods, regions and data migration, provider pricing and availability, and supported quantum languages in the QDK. |
| Architecture & Design Patterns | L58-L62 | Guidance on designing hybrid quantum-classical workflows in Azure Quantum, including architecture options, orchestration patterns, and when to offload tasks to quantum hardware. |
| Limits & Quotas | L63-L70 | Managing Azure Quantum API lifecycles, usage quotas, session limits/timeouts, and Rigetti hardware target constraints and capacity. |
| Security | L71-L83 | Managing secure access to Azure Quantum workspaces: RBAC roles, bulk assignment, authentication (managed identity/service principals), access keys, resource locks, and workspace/storage isolation. |
| Configuration | L84-L101 | Configuring Azure Quantum workspaces, QDK tools, simulators, VS Code, hardware/architecture models, and resource estimator settings for running and analyzing quantum jobs. |
| Integrations & Coding Patterns | L102-L117 | Using QDK/Python/CLI to submit, visualize, and run Q# and OpenQASM jobs, build noise and error-correction models, integrate Stim/qodec, and run hybrid/adaptive and resource-estimation workflows. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Diagnose and resolve common Azure Quantum issues | https://learn.microsoft.com/en-us/azure/quantum/azure-quantum-common-issues |
| Support and escalation policy for IonQ on Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/provider-support-ionq |
| Support policy for Quantinuum on Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/provider-support-quantinuum |
| Support policy for Rigetti on Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/provider-support-rigetti |

### Best Practices
| Topic | URL |
|-------|-----|
| Test and debug quantum programs with QDK tools | https://learn.microsoft.com/en-us/azure/quantum/testing-debugging |

### Decision Making
| Topic | URL |
|-------|-----|
| Choose how to submit jobs to Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs |
| Migrate Azure Quantum workspace data between regions | https://learn.microsoft.com/en-us/azure/quantum/migration-guide |
| Choose pricing plans for Azure Quantum providers | https://learn.microsoft.com/en-us/azure/quantum/pricing |
| Check regional availability of Azure Quantum providers | https://learn.microsoft.com/en-us/azure/quantum/provider-global-availability |
| Choose quantum language support in the QDK | https://learn.microsoft.com/en-us/azure/quantum/qdk-language-support-overview |

### Architecture & Design Patterns
| Topic | URL |
|-------|-----|
| Choose hybrid quantum computing architectures in Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/hybrid-computing-overview |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Manage Azure Quantum preview API lifecycle and expiry | https://learn.microsoft.com/en-us/azure/quantum/azure-quantum-api-lifecycle |
| Review and manage Azure Quantum usage quotas | https://learn.microsoft.com/en-us/azure/quantum/azure-quantum-quotas |
| Manage Azure Quantum sessions and timeouts | https://learn.microsoft.com/en-us/azure/quantum/how-to-work-with-sessions |
| Rigetti provider targets and hardware limits in Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/provider-rigetti |

### Security
| Topic | URL |
|-------|-----|
| Bulk assign Azure Quantum workspace access via CSV | https://learn.microsoft.com/en-us/azure/quantum/bulk-add-users-to-a-workspace |
| Configure Azure Quantum workspace access roles | https://learn.microsoft.com/en-us/azure/quantum/how-to-connect-workspace |
| Protect Azure Quantum resources with ARM locks | https://learn.microsoft.com/en-us/azure/quantum/how-to-set-resource-locks |
| Share Azure Quantum workspace using RBAC roles | https://learn.microsoft.com/en-us/azure/quantum/how-to-share-access-quantum-workspace |
| Configure Azure Quantum workspace access roles | https://learn.microsoft.com/en-us/azure/quantum/manage-workspace-access |
| Authenticate to Azure Quantum using managed identity | https://learn.microsoft.com/en-us/azure/quantum/optimization-authenticate-managed-identity |
| Authenticate to Azure Quantum using service principals | https://learn.microsoft.com/en-us/azure/quantum/optimization-authenticate-service-principal |
| Manage Azure Quantum workspace access keys securely | https://learn.microsoft.com/en-us/azure/quantum/security-manage-access-keys |
| Secure Azure Quantum workspace and storage boundaries | https://learn.microsoft.com/en-us/azure/quantum/security-workspace-storage-boundaries |

### Configuration
| Topic | URL |
|-------|-----|
| Define Azure Quantum workspaces using Bicep | https://learn.microsoft.com/en-us/azure/quantum/how-to-manage-quantum-workspaces-using-bicep |
| Manage Azure Quantum workspaces with Azure CLI | https://learn.microsoft.com/en-us/azure/quantum/how-to-manage-quantum-workspaces-with-the-azure-cli |
| Configure VS Code QDK extension for Azure Quantum jobs | https://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs-vscode |
| Use the QDK neutral atom device visualizer | https://learn.microsoft.com/en-us/azure/quantum/how-to-use-neutral-atom-visualizer |
| Configure environments for the Quantum Development Kit | https://learn.microsoft.com/en-us/azure/quantum/install-overview-qdk |
| Install and configure QDK chemistry Python library | https://learn.microsoft.com/en-us/azure/quantum/install-qdk-chemistry |
| Install and configure QDK error correction tools | https://learn.microsoft.com/en-us/azure/quantum/install-qdk-error-correction |
| Configure and run QDK quantum simulators in Python | https://learn.microsoft.com/en-us/azure/quantum/install-qdk-quantum-simulators |
| Configure and use IonQ targets in Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/provider-ionq |
| Configure QDK VS Code extension local simulator | https://learn.microsoft.com/en-us/azure/quantum/qdk-simulator-vscode |
| Configure hardware architecture models for the Quantum resource estimator | https://learn.microsoft.com/en-us/azure/quantum/qre-build-architecture-models |
| Define error correction and magic state models for resource estimation | https://learn.microsoft.com/en-us/azure/quantum/qre-build-error-correction-models |
| Build custom application models for the Quantum resource estimator | https://learn.microsoft.com/en-us/azure/quantum/qre-custom-applications |
| Access and customize Quantum resource estimator output | https://learn.microsoft.com/en-us/azure/quantum/qre-estimation-results |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Develop and validate QEC protocols with qodec and QDK | https://learn.microsoft.com/en-us/azure/quantum/develop-validate-qec-protocol |
| Submit Azure Quantum QIR jobs via Azure CLI | https://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs-azure-cli |
| Submit Azure Quantum jobs with QDK Python integrations | https://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs-python |
| Visualize Q# and OpenQASM circuits with QDK | https://learn.microsoft.com/en-us/azure/quantum/how-to-visualize-circuits |
| Create noise models for QDK neutral atom simulations | https://learn.microsoft.com/en-us/azure/quantum/neutral-atom-noise-models |
| Use QDK Python tools for error correction | https://learn.microsoft.com/en-us/azure/quantum/qdk-error-correction-overview |
| Implement multi-qubit noise models in QDK simulations | https://learn.microsoft.com/en-us/azure/quantum/qdk-multi-qubit-noise-models |
| Run OpenQASM programs with Azure Quantum QDK | https://learn.microsoft.com/en-us/azure/quantum/qdk-openqasm-integration |
| Build and apply QDK quantum noise models | https://learn.microsoft.com/en-us/azure/quantum/qdk-simulator-noise-models |
| Integrate Stim error correction with the QDK | https://learn.microsoft.com/en-us/azure/quantum/qdk-stim-overview |
| Create application models from quantum frameworks for resource estimation | https://learn.microsoft.com/en-us/azure/quantum/qre-supported-applications |
| Submit formatted quantum circuits to Azure Quantum | https://learn.microsoft.com/en-us/azure/quantum/quickstart-microsoft-provider-format |
| Run and decode logical quantum programs with QDK | https://learn.microsoft.com/en-us/azure/quantum/run-decode-logical-programs |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for AI and ML →

From the same set144

The whole set →
azure-attestation Reference skill for Azure Attestation work: error troubleshooting, claim-rule policies, SGX and TPM baselines, private endpoints. Keeps the agent on Microsoft's own docs. CX Codex +1 169installs azure-business-process-tracking Agent reference for Azure Business Process Tracking, focused on deployment: builds, tests and CI/CD pipelines. CX Codex +1 168installs azure-route-server Skill for Claude Code guides network engineers through Azure Route Server setup and debugging. It fetches documentation on BGP routing policies, route maps, and topology designs into agent context. CX Codex +1 168installs azure-managed-applications Skill for Azure Managed Applications development: limits, security, UI configuration, and Bicep deployment. Fetches docs via mcp_microsoftdocs MCP server. CX Codex +1 168installs azure-playwright-workspaces azure-playwright-workspaces guides Playwright Testing workspace setup, RBAC permissions, quota management, and test failure troubleshooting. CX Codex +1 168installs azure-vm-scalesets azure-vm-scalesets is a skill for Azure Virtual Machine Scale Sets, covering autoscale troubleshooting, security, and deployment. It supports scale set design and configuration. CX Codex +1 168installs azure-energy-data-services Guides Azure Energy Data Services development. It covers ADME security, DDMS API calls, configuration, deployment, and manifest-ingestion failures. CX Codex +1 167installs azure-health-bot Hands the agent a reference on Azure Health Bot: auth providers, Teams and web chat channels, telemetry, voice safeguards. Live documentation pages come from Microsoft Learn. CX Codex +1 167installs

Project sponsors

Companies that keep this analytics open