SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-quantum

MicrosoftDocs

azure-quantum

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 Azure Quantum workspaces, IonQ/Quantinuum/Rigetti targets, QIR/OpenQASM jobs, or Resource Estimator, and other Azure Quantum related development tasks. Not for Azure HPC Cache (use azure-hpc-cache), Azure Batch (use azure-batch), Azure Databricks (use azure-databricks), Azure Machine Learning (use azure-machine-learning).

v1.0Latest
New~2.3kUpdated Jun 26, 2026

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

Category Lines Description
Troubleshooting L37-L44 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 L45-L49 Best practices for using QDK in VS Code with Copilot, optimizing large Q# programs via resource estimation, and systematically testing and debugging quantum code.
Decision Making L50-L56 Guidance on Azure Quantum costs, provider pricing and regions, workspace migration, choosing Q# dev tools, and planning quantum-safe cryptography with the resource estimator.
Architecture & Design Patterns L57-L61 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 L62-L68 Managing Azure Quantum quotas, job/session limits, timeouts, and Rigetti-specific hardware constraints and target capabilities.
Security L69-L79 Managing 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.
Configuration L80-L92 Configuring Azure Quantum workspaces, QDK tools, simulators, and hardware targets, plus setting up and customizing Quantum Resource Estimator models and outputs.
Integrations & Coding Patterns L93-L103 Integrating QDK with Azure Quantum: connecting workspaces, submitting Cirq/OpenQASM/QIR/Pulser jobs, building noise and application models, and running adaptive hybrid quantum workflows.
Deployment L104-L108 Deploying Azure Quantum workspaces with Bicep and running/submitting Q# quantum programs from VS Code to Azure Quantum backends

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 the Quantum Development Kit https://learn.microsoft.com/en-us/azure/quantum/testing-debugging

Decision Making

Topic URL
Migrate Azure Quantum workspace data between regions https://learn.microsoft.com/en-us/azure/quantum/migration-guide
Compare Azure Quantum provider pricing plans 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

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
Review and manage Azure Quantum usage quotas https://learn.microsoft.com/en-us/azure/quantum/azure-quantum-quotas
Manage Azure Quantum sessions and avoid 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
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 control 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

Configuration

Topic URL
Configure Azure Quantum workspaces with Azure CLI https://learn.microsoft.com/en-us/azure/quantum/how-to-manage-quantum-workspaces-with-the-azure-cli
Use the QDK neutral atom device visualizer https://learn.microsoft.com/en-us/azure/quantum/how-to-use-neutral-atom-visualizer
Set up QDK VS Code extension and environment https://learn.microsoft.com/en-us/azure/quantum/install-overview-qdk
Install and configure QDK quantum simulators 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 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
Connect to Azure Quantum workspace via qdk.azure https://learn.microsoft.com/en-us/azure/quantum/how-to-connect-workspace
Run integrated hybrid quantum jobs with Adaptive RI in Azure Quantum https://learn.microsoft.com/en-us/azure/quantum/hybrid-computing-integrated
Run OpenQASM programs with the Quantum Development Kit https://learn.microsoft.com/en-us/azure/quantum/qdk-openqasm-integration
Build noise models with QDK neutral atom simulators https://learn.microsoft.com/en-us/azure/quantum/qdk-simulator-noise-models
Create application models from quantum frameworks for resource estimation https://learn.microsoft.com/en-us/azure/quantum/qre-supported-applications
Submit Cirq circuits to Azure Quantum with QDK https://learn.microsoft.com/en-us/azure/quantum/quickstart-microsoft-cirq
Submit QIR, OpenQASM, and Pulser circuits to Azure Quantum https://learn.microsoft.com/en-us/azure/quantum/quickstart-microsoft-provider-format

Deployment

Topic URL
Deploy Azure Quantum workspaces using Bicep templates https://learn.microsoft.com/en-us/azure/quantum/how-to-manage-quantum-workspaces-using-bicep
Submit and run Q# programs on Azure Quantum from VS Code https://learn.microsoft.com/en-us/azure/quantum/how-to-submit-jobs
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

77/100

Grade

B

Good

Safety

82

Quality

72

Clarity

85

Completeness

65

Summary

An expert reference skill that provides structured guidance for Azure Quantum development, covering troubleshooting, best practices, architecture patterns, security, configuration, and deployment. The skill functions as a curated index with links to Microsoft Learn documentation and MCP integration instructions, enabling agents to retrieve detailed guidance from authoritative sources when needed.

Detected Capabilities

documentation retrievalnetwork accessMCP integrationreference indexing

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure quantum developmentquantum program submissionazure quantum securityquantum resource estimatorhybrid quantum computingquantum workspace migrationqdk with azure quantumquantum job debugging

Risk Signals

INFO

Network access via mcp_microsoftdocs:microsoft_docs_fetch and fetch_webpage

Compatibility & How to Use sections
INFO

References to sensitive operations (managing access keys, service principals, managed identities)

Security category
INFO

External documentation links to learn.microsoft.com

Category index tables

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Troubleshoot Azure Quantum job failures and provider issues
  • Design hybrid quantum-classical architectures and workflows
  • Configure Azure Quantum workspaces and quantum simulators
  • Submit and run quantum programs (Q#, QIR, OpenQASM, Cirq, Pulser) to Azure Quantum hardware targets
  • Estimate quantum resource requirements using the Resource Estimator
  • Manage Azure Quantum security, access control, and authentication
  • Migrate Azure Quantum workspaces between regions
  • Deploy Azure Quantum infrastructure using Bicep templates

Quality Notes

  • Strength: Well-organized category index with clear line ranges and descriptions enabling precise documentation lookup
  • Strength: Clear scope boundaries—skill explicitly excludes Azure HPC Cache, Batch, Databricks, and Machine Learning (directs to other skills)
  • Strength: Comprehensive coverage across 9 major Azure Quantum topics with focused URLs for each
  • Strength: Clear instructions for agents on how to use the skill, including fallback mechanisms for missing MCP tools
  • Strength: Includes metadata (generated_at, generator) to track freshness and suggest updates
  • Limitation: No local reference files provided (only links and descriptions)—agents entirely dependent on network access and external tool availability
  • Limitation: Category line ranges (L35-L44, etc.) reference non-existent local content; only the index itself and frontmatter are present
  • Limitation: No edge case handling documented (e.g., what if fetch fails, network timeout, tool unavailable)
  • Limitation: No concrete code examples or detailed patterns—purely a navigation reference
  • Limitation: Deprecation/freshness guidance relies on agent checking metadata but no automatic version reconciliation is described
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-quantum in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...

MicrosoftDocs/azure-quantum | SkillRepo