azure-chaos-studio — Claude Code skill: what it does, how to install
Skill for Azure Chaos Studio setup: experiments, workspaces, AKS agents, Private Link, and migration from classic experiments.
CC-BY-4.0 170 installs ★ 818 updated 2026-11-02
npx skills add MicrosoftDocs/Agent-Skills --skill azure-chaos-studio -a claude-codeWhat azure-chaos-studio does
The skill provides troubleshooting guidance for Chaos Studio (agent status, experiment errors, workspace issues), quota limits, RBAC and customer-managed key configuration, scenario setup, and resource targeting. Includes automation examples via CLI, ARM, Bicep, and REST API. Requires network access: the skill calls the mcp_microsoftdocs MCP server or fetch_webpage to pull current documentation from learn.microsoft.com.
Covers migration from classic experiments to Workspaces, target deployment via ARM templates, integration with Logic Apps and Azure Monitor. Security sections include AKS authentication, IP ranges for Chaos Studio, and Private Link for the agent. Configuration and best practices cover virtual networks, Azure Policy, fault and action libraries, and testing AKS node resilience.
What it helps with
- set up Chaos Studio experiments via ARM and CLI
- diagnose agent and workspace errors
- migrate classic experiments to Workspaces
- configure RBAC and Private Link for Chaos Studio
- automate chaos testing scenarios via REST API
Example prompts for the agent
- How do I migrate a Chaos Studio classic experiment to a workspace?
- Set up Private Link for the Chaos Studio agent in an AKS cluster
- Show me Chaos Studio quota limits and known workspace issues
How to install azure-chaos-studio
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-chaos-studio -a claude-code2Manually: put the files in place
~/.claude/skills/azure-chaos-studio/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-chaos-studio/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-chaos-studio -a codex2Manually: put the files in place
.agents/skills/azure-chaos-studio/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-chaos-studio -a cursor2Manually: put the files in place
.cursor/skills/azure-chaos-studio/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-chaos-studio2Manually: put the files in place
.github/skills/azure-chaos-studio/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-chaos-studio -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-chaos-studioManually: put the files in place
.devin/skills/azure-chaos-studio/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-chaos-studio -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-chaos-studio
How to install azure-chaos-studio in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-chaos-studio -a claude-code, the skill will appear in ~/.claude/skills/azure-chaos-studio/SKILL.md.
What does azure-chaos-studio do?
Provides guidance for Azure Chaos Studio: troubleshooting agent and workspace issues, RBAC setup, Private Link, customer-managed keys, migration from classic experiments, automation via CLI and ARM.
What does azure-chaos-studio require?
Network access and the mcp_microsoftdocs MCP server (or fetch_webpage as fallback) to fetch documentation from learn.microsoft.com.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-chaos-studio description: Expert knowledge for Chaos Studio development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when automating Chaos Studio via CLI/ARM/REST, configuring AKS agents, Private Link, CMK, or migrating to Workspaces, and other Chaos Studio related development tasks. Not for Azure Monitor (use azure-monitor), Azure Resiliency (use azure-resiliency), Azure Reliability (use azure-reliability), Azure Defender For Cloud (use azure-defender-for-cloud). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-11-01" generator: "docs2skills/1.0.0" --- # Chaos Studio Skill This skill provides expert guidance for Chaos Studio. Covers troubleshooting, best practices, decision making, 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](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-L44 | Diagnosing and fixing Chaos Studio agent, workspace, scenario, and classic experiment issues, including status verification, known errors, and common deployment/runtime failures. | | Best Practices | L45-L50 | Guidance on designing Chaos Studio scenarios to test AKS node resilience and on filtering/targeting specific Azure resources when configuring chaos experiments. | | Decision Making | L51-L56 | Guidance on when to use Chaos Workspaces vs classic Experiments and how to migrate existing Chaos Studio classic experiments into Workspaces. | | Limits & Quotas | L57-L63 | Limits, quotas, and known issues for Chaos Studio classic and Workspaces preview, including experiment constraints, feature gaps, and current platform limitations. | | Security | L64-L77 | Networking, identity, RBAC, and encryption setup for Chaos Studio/AKS: agent connectivity, IP allowlists, Private Link, workspace roles, least-privilege access, and customer-managed keys. | | Configuration | L78-L91 | Configuring Chaos Studio experiments: workspaces, scenarios, targets (static/dynamic), virtual network injection, Azure Policy, and using fault/action libraries and templates. | | Integrations & Coding Patterns | L92-L113 | Patterns and examples for automating, integrating, and scripting Chaos Studio experiments and agents using CLI, ARM/Bicep, REST, Logic Apps, and Azure monitoring/telemetry tools. | | Deployment | L114-L121 | Checking OS/region/model compatibility, and deploying Chaos Studio classic experiments and targets using ARM templates, including version and fault support details. | ### Troubleshooting | Topic | URL | |-------|-----| | Resolve known Chaos Studio agent issues | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-known-issues | | Troubleshoot Azure Chaos Studio agent issues | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-troubleshooting | | Verify and diagnose Chaos Studio agent status | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-verify-status | | Troubleshoot Chaos Studio Workspaces and scenarios | https://learn.microsoft.com/en-us/azure/chaos-studio/troubleshoot-workspaces-scenarios | | Troubleshoot Azure Chaos Studio classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting | ### Best Practices | Topic | URL | |-------|-----| | Test AKS node resilience with Chaos Studio Workspaces | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-guidance | | Filter and target resources in Chaos Studio Scenarios | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspaces-resource-targeting | ### Decision Making | Topic | URL | |-------|-----| | Migrate from Chaos Studio classic experiments to Workspaces | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-migrate-from-classic | | Choose between Chaos Workspaces and Experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspaces-vs-experiments | ### Limits & Quotas | Topic | URL | |-------|-----| | Review limitations and known issues for Chaos Experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-limitations | | Review Chaos Studio classic service limits and quotas | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-service-limits | | Review Chaos Studio Workspaces preview limitations | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspaces-limitations | ### Security | Topic | URL | |-------|-----| | Understand Chaos Studio agent networking and identity | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-concepts | | Configure AKS authentication for Chaos Experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-authentication | | Prepare AKS clusters and permissions for Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-extension-install | | Authorize Chaos Studio IP ranges for AKS experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges | | Assign RBAC permissions for Chaos Studio experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions | | Configure customer-managed keys for Chaos Studio classic | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys | | Configure permissions and security for Chaos Experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-permissions-security | | Configure Private Link for Chaos Studio agent | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service | | Configure Chaos Studio Workspace permissions and identities | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspace-permissions | | Create least-privilege custom roles for Chaos Studio Workspaces | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspaces-least-privilege-roles | ### Configuration | Topic | URL | |-------|-----| | Use Chaos Studio fault and action library | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-library | | Manage Chaos Studio Workspaces and Scenarios via CLI | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-manage-cli | | Set up virtual network injection for Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-networking | | Run and manage classic Chaos Studio experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-run-experiment | | Use Chaos Studio scenario and outage templates | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-scenarios | | Configure target selection for classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-target-selection | | Configure targets and capabilities for classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-targets-capabilities | | Configure dynamic targets in portal for classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-dynamic-target-portal | | Map Chaos Studio actions to supported resources | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-workspaces-supported-resources | | Configure Chaos Studio classic targets via Azure Policy | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-policy-targets | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Use Chaos Studio relay container for private networks | https://learn.microsoft.com/en-us/azure/chaos-studio/azure-container-instance-details | | Deploy Chaos Studio agent with ARM templates | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-arm-template | | Deploy Chaos Studio classic experiments with Bicep | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-bicep | | Measure Chaos Experiment impact with Azure Monitor Workbooks | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard | | Manage Chaos Experiments with REST API samples | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-samples-rest-api | | Send Chaos Studio agent telemetry to Application Insights | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights | | Send Chaos Studio experiment telemetry to Azure Monitor | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor | | Simulate Microsoft Entra ID outages with classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-aad-outage-portal | | Define agent-based CPU pressure experiments with Azure CLI | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-agent-based-cli | | Configure agent-based faults in portal for classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-agent-based-portal | | Configure AKS Chaos Mesh faults with Azure CLI | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-aks-cli | | Create AKS Chaos Mesh faults in portal for classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-aks-portal | | Simulate availability zone down on VM scale sets | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-availability-zone-down-portal | | Simulate DNS outages with NSG rules in classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-dns-outage | | Script service-direct faults with Azure CLI and REST | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-service-direct-cli | | Create service-direct faults in portal for classic experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-service-direct-portal | | Use CLI and portal experiment examples in Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples | | Schedule recurring classic experiments with Logic Apps | https://learn.microsoft.com/en-us/azure/chaos-studio/tutorial-schedule | ### Deployment | Topic | URL | |-------|-----| | Check OS and fault support for Chaos Studio agent | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-os-support | | Check regional availability for Chaos Studio models | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-region-availability | | Check Chaos Studio classic version compatibility | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-versions | | Deploy classic experiments with ARM template samples | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-experiment | | Deploy Chaos Studio targets via ARM templates | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-targets |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills