Official agent skill

Azure Quantum

by MicrosoftDocs in MicrosoftDocs/Agent-Skills

Expert knowledge for Azure Quantum development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations &…

OfficialCC-BY-4.0Auto-check passedDevelopment

Install Azure Quantum

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MicrosoftDocs/Agent-Skills azure-quantum --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MicrosoftDocs/Agent-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/azure-quantum .claude/skills/azure-quantum && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
azure-quantum
GitHub stars
775
Token cost
~2.6k tokens
SKILL.md length
772 words
Files
1
Skills in repo
149
Repo updated
First seen
Licence
CC-BY-4.0

At a glance

Expert knowledge for Azure Quantum development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations &…

  • Using QDK with Python/Q
  • SKILL.md covers How to Use This Skill and Category Index
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Rigetti/IonQ targets

What it does

Azure Quantum is an agent skill from MicrosoftDocs/Agent-Skills, published by the product's own GitHub organization. Expert knowledge for Azure Quantum development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using QDK with Python/Q, OpenQASM or hybrid jobs, Rigetti/IonQ targets, QIR jobs, or Bicep/CLI workspace deploys, and other Azure Quantum related development tasks. Not for Azure HDInsight (use azure-hdinsight), Azure Databricks (use azure-databricks), Azure Machine Learning (use…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires network access. Uses mcpmicrosoftdocs:microsoftdocsfetch or fetchwebpage to retrieve documentation.

It sits in Development, covering Design patterns and Infrastructure as code. It works with Microsoft Azure, Azure Machine Learning, Databricks and Bicep. The repository describes itself as: Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs. The licence is CC-BY-4.0.

When your agent uses it

  • Using QDK with Python/Q
  • Rigetti/IonQ targets
  • Bicep/CLI workspace deploys
  • Other Azure Quantum related development tasks

Example prompts

  • “/azure-quantum”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.

What it can do on your machine

Read from SKILL.md and the folder at commit ba74e8f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • learn.microsoft.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.

    From compatibility in the SKILL.md frontmatter.

Context cost

Azure Quantum loads about 2.6k tokens when it runs. Until then it costs about 153 tokens; SKILL.md has 772 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~153
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MicrosoftDocs/Agent-Skills at commit ba74e8f, republished under its CC-BY-4.0 licence (© MicrosoftDocs). 772 words, ~2,580 tokens.

Download SKILL.mdSave it as .claude/skills/azure-quantum/SKILL.md (or your agent's skills folder).
name
azure-quantum
description
Expert knowledge for Azure Quantum development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using QDK with Python/Q#, OpenQASM or hybrid jobs, Rigetti/IonQ targets, QIR jobs, or Bicep/CLI workspace deploys, and other Azure Quantum related development tasks. Not for Azure HDInsight (use azure-hdinsight), Azure Databricks (use azure-databricks), Azure Machine Learning (use azure-machine-learning), Azure Synapse Analytics (use azure-synapse-analytics).
compatibility
Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata.generated_at
2026-10-04
metadata.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, integrations & coding patterns, and deployment. 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

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

CategoryLinesDescription
TroubleshootingL37-L44Troubleshooting Azure Quantum provider issues: diagnosing job failures and support/escalation policies and limits for IonQ, Quantinuum, and Rigetti hardware on Azure Quantum.
Best PracticesL45-L49Tools and techniques for testing, debugging, and validating quantum programs with the Azure Quantum Development Kit (QDK), including simulators, logging, and troubleshooting.
Decision MakingL50-L57Guidance on choosing job submission methods, comparing provider pricing and regions, and migrating Azure Quantum workspaces between geographic locations.
Architecture & Design PatternsL58-L62Guidance on designing hybrid quantum-classical workflows in Azure Quantum, including architecture options, orchestration patterns, and when to offload tasks to quantum hardware.
Limits & QuotasL63-L70Managing Azure Quantum API lifecycles, usage quotas, session limits/timeouts, and Rigetti hardware target constraints and capacity.
SecurityL71-L81Managing secure access to Azure Quantum workspaces: RBAC and access control, bulk user assignment, ARM locks, managed identities, service principals, and secure handling of access keys.
ConfigurationL82-L95Configuring Azure Quantum tools and targets: CLI workspaces, VS Code/QDK setup, simulators, hardware/error models, resource estimator, and IonQ/neutral atom device integration.
Integrations & Coding PatternsL96-L109Using the Azure Quantum QDK with Python/Q#, including connecting workspaces, submitting and visualizing circuits, running OpenQASM and hybrid jobs, and configuring simulator/noise and resource models.
DeploymentL110-L114Deploying Azure Quantum workspaces via Bicep templates and submitting QIR-based quantum jobs using Azure CLI, including setup, configuration, and command workflows.
Troubleshooting
TopicURL
Diagnose and resolve common Azure Quantum issueshttps://learn.microsoft.com/en-us/azure/quantum/azure-quantum-common-issues
Support and escalation policy for IonQ on Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/provider-support-ionq
Support policy for Quantinuum on Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/provider-support-quantinuum
Support policy for Rigetti on Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/provider-support-rigetti
Best Practices
TopicURL
Test and debug quantum programs with QDK toolshttps://learn.microsoft.com/en-us/azure/quantum/testing-debugging
Decision Making
TopicURL
Choose how to submit jobs to Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs
Migrate Azure Quantum workspace data between regionshttps://learn.microsoft.com/en-us/azure/quantum/migration-guide
Compare Azure Quantum provider pricing planshttps://learn.microsoft.com/en-us/azure/quantum/pricing
Check regional availability of Azure Quantum providershttps://learn.microsoft.com/en-us/azure/quantum/provider-global-availability
Architecture & Design Patterns
TopicURL
Choose hybrid quantum computing architectures in Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/hybrid-computing-overview
Show full SKILL.md (304 more words)Show less
Limits & Quotas
TopicURL
Manage Azure Quantum preview API lifecycle and expiryhttps://learn.microsoft.com/en-us/azure/quantum/azure-quantum-api-lifecycle
Review and manage Azure Quantum usage quotashttps://learn.microsoft.com/en-us/azure/quantum/azure-quantum-quotas
Manage Azure Quantum sessions and timeoutshttps://learn.microsoft.com/en-us/azure/quantum/how-to-work-with-sessions
Rigetti provider targets and hardware limits in Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/provider-rigetti
Security
Configuration
TopicURL
Configure Azure Quantum workspaces with Azure CLIhttps://learn.microsoft.com/en-us/azure/quantum/how-to-manage-quantum-workspaces-with-the-azure-cli
Configure VS Code QDK extension for Azure Quantum jobshttps://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs-vscode
Use the QDK neutral atom device visualizerhttps://learn.microsoft.com/en-us/azure/quantum/how-to-use-neutral-atom-visualizer
Install and configure QDK chemistry Python libraryhttps://learn.microsoft.com/en-us/azure/quantum/install-qdk-chemistry
Install and configure QDK quantum simulatorshttps://learn.microsoft.com/en-us/azure/quantum/install-qdk-quantum-simulators
Configure and use IonQ targets in Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/provider-ionq
Configure hardware architecture models for the Quantum resource estimatorhttps://learn.microsoft.com/en-us/azure/quantum/qre-build-architecture-models
Define error correction and magic state models for resource estimationhttps://learn.microsoft.com/en-us/azure/quantum/qre-build-error-correction-models
Build custom application models for the Quantum resource estimatorhttps://learn.microsoft.com/en-us/azure/quantum/qre-custom-applications
Access and customize Quantum resource estimator outputhttps://learn.microsoft.com/en-us/azure/quantum/qre-estimation-results
Integrations & Coding Patterns
TopicURL
Connect Python QDK to Azure Quantum workspacehttps://learn.microsoft.com/en-us/azure/quantum/how-to-connect-workspace
Submit Azure Quantum jobs with QDK Python integrationshttps://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs-python
Visualize Q# and OpenQASM circuits with QDKhttps://learn.microsoft.com/en-us/azure/quantum/how-to-visualize-circuits
Run integrated hybrid quantum jobs with Adaptive RI in Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/hybrid-computing-integrated
Configure neutral atom noise models with QDK Python APIshttps://learn.microsoft.com/en-us/azure/quantum/neutral-atom-noise-models
Model multi-qubit gate noise with QDK Pythonhttps://learn.microsoft.com/en-us/azure/quantum/qdk-multi-qubit-noise-models
Run OpenQASM programs with Azure Quantum QDKhttps://learn.microsoft.com/en-us/azure/quantum/qdk-openqasm-integration
Build and configure QDK simulator noise modelshttps://learn.microsoft.com/en-us/azure/quantum/qdk-simulator-noise-models
Create application models from quantum frameworks for resource estimationhttps://learn.microsoft.com/en-us/azure/quantum/qre-supported-applications
Submit formatted quantum circuits to Azure Quantumhttps://learn.microsoft.com/en-us/azure/quantum/quickstart-microsoft-provider-format
Deployment

© MicrosoftDocs, CC-BY-4.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/azure-quantum of MicrosoftDocs/Agent-Skills.

Open the folder on GitHubat commit ba74e8f

Compare with similar skills

Azure Quantum next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Azure Quantum compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azure Quantum this skillMicrosoftDocs/Agent-Skills775—~2.6kAutomated safety check: PassCC-BY-4.0
Azure Architecture Autopilotgithub/awesome-copilot40k1 repos~1.9kAutomated safety check: PassMIT
Apex Azure Bicep Patternsjonathan-vella/apex217—~2.5kAutomated safety check: PassMIT
Azure Preparemicrosoft/GitHub-Copilot-for-Azure2551 repos~3.2kAutomated safety check: PassMIT
Apex Terraform Patternsjonathan-vella/apex217—~2.2kAutomated safety check: PassMIT
Code ReviewAzure/sap-automation145—~7kAutomated safety check: PassMIT

Similar skills

  • Azure Architecture Autopilot

    github/awesome-copilot

    Official

    Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

    40k GitHub starsUsed in 1 repo~1.9k tokens
    DevOps & CloudAuto-check passed
  • Apex Azure Bicep Patterns

    jonathan-vella/apex

    UTILITY SKILL — Reusable Azure Bicep patterns: hub-spoke, private endpoints, diagnostics, AVM composition.

    217 GitHub stars~2.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Azure Prepare

    microsoft/GitHub-Copilot-for-Azure

    Official

    Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow.

    255 GitHub starsUsed in 1 repo~3.2k tokens
    DevOps & CloudAuto-check passed
  • Apex Terraform Patterns

    jonathan-vella/apex

    UTILITY SKILL — Reusable Azure Terraform patterns: hub-spoke, private endpoints, diagnostics, AVM-TF modules.

    217 GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Code Review

    Azure/sap-automation

    Official

    Review pull requests in the SAP Deployment Automation Framework.

    145 GitHub stars~7k tokensUpdated today
    DevelopmentAuto-check passed
  • Azure Diagrams

    cmb211087/azure-diagrams-skill

    Comprehensive technical diagramming toolkit for solutions architects, presales, and developers.

    150 GitHub stars~4k tokensUpdated 3 mo ago
    DevOps & CloudAuto-check: notes

More from MicrosoftDocs/Agent-Skills

All 149 skills in this repo
  • Azure Personalizer

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure AI Personalizer development including troubleshooting, decision making, security, configuration, and integrations & coding patterns.

    775 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Azure Architecture Advisor

    MicrosoftDocs/Agent-Skills

    Official

    Guides Azure solution design by category, from reference architectures and design patterns to technology choices and migrations, fetching current Microsoft Learn pages over the network.

    775 GitHub stars~15k tokensUpdated yesterday
    Auto-check passed
  • Azure Advisor Guidance

    MicrosoftDocs/Agent-Skills

    Official

    Reference guidance for Azure Advisor work: recommendations, alerts and digests, workbooks, RBAC access and sovereign-cloud limits, fetched from Microsoft Learn.

    775 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Azure AI Vision Reference

    MicrosoftDocs/Agent-Skills

    Official

    Looks up Microsoft Learn guidance for Azure AI Vision: Image Analysis, Read OCR containers, smart-crop thumbnails, background removal and video frame analysis, plus limits and deployment.

    775 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Azure Analysis Services

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure Analysis Services development including troubleshooting.

    775 GitHub stars~608 tokensUpdated yesterday
    Auto-check passed
  • Azure Anomaly Detector

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure AI Anomaly Detector development including troubleshooting, best practices, limits & quotas, configuration, and deployment.

    775 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about Azure Quantum

What does Azure Quantum do?

Expert knowledge for Azure Quantum development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations &…. Azure Quantum is an agent skill from MicrosoftDocs/Agent-Skills, published by the product's own GitHub organization. Expert knowledge for Azure Quantum development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment.

When should I use Azure Quantum?

Azure Quantum fits situations like: using QDK with Python/Q; rigetti/IonQ targets; bicep/CLI workspace deploys; other Azure Quantum related development tasks.

How do I install Azure Quantum in Claude Code?

Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-quantum -a claude-code`. Or copy the skill folder (skills/azure-quantum in MicrosoftDocs/Agent-Skills) into .claude/skills/azure-quantum in your project. Claude Code loads it when a task matches its description.

How do I install Azure Quantum in Codex?

Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-quantum -a codex`. Or copy the skill folder (skills/azure-quantum in MicrosoftDocs/Agent-Skills) into .agents/skills/azure-quantum in your project. Codex loads it when a task matches its description.

Can I use Azure Quantum in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-quantum -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/azure-quantum, .gemini/skills/azure-quantum, .github/skills/azure-quantum and .opencode/skills/azure-quantum in your project.

What does Azure Quantum need to run?

SKILL.md names no scripts, command-line tools or credentials: Azure Quantum is instructions for the agent only. Our summary lists: Python 3. Compatibility (from SKILL.md): Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation..

Does Azure Quantum access the network?

SKILL.md names 2 domains. As links in the text: learn.microsoft.com and github.com. This is read from the text; nothing was executed.

Is Azure Quantum safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Azure Quantum use?

Azure Quantum is published under the CC-BY-4.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Azure Quantum use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Azure Quantum?

Skills that share tags, products or a category with Azure Quantum: Azure Architecture Autopilot (github/awesome-copilot, 40k stars), Apex Azure Bicep Patterns (jonathan-vella/apex, 217 stars), Azure Prepare (microsoft/GitHub-Copilot-for-Azure, 255 stars) and Apex Terraform Patterns (jonathan-vella/apex, 217 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azure Quantum?

MicrosoftDocs (a GitHub organization, an official publisher) maintains it in MicrosoftDocs/Agent-Skills, which has 775 GitHub stars. The repository holds 149 skills in this directory. The repository was last updated on October 5, 2026.

Source: MicrosoftDocs/Agent-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.