azure-chaos-studio

Name: azure-chaos-studio
Author: microsoftdocs

github.com/microsoftdocsTesting & quality796168 installsUpdated 3d ago

About azure-chaos-studio

azure-chaos-studio is a guidance skill for teams using Chaos Studio to test Azure resource resilience. It combines local references with remote documentation retrieval for troubleshooting, experiment design, security, automation, and deployment.

Key features

01Agent and experiment troubleshooting
02Scenario design and targeting
03Workspace and experiment guidance
04Security and permissions
05Automation and deployment examples

Use cases

01Diagnosing Chaos Studio agent failures
02Planning AKS resilience scenarios
03Automating or scheduling chaos experiments

MCP support

The skill can fetch Microsoft documentation using the mcp_microsoftdocs microsoft_docs_fetch tool, with webpage fetching as a fallback.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-chaos-studio

After installing, type/azure-chaos-studioin Claude Code to confirm it loaded.

Details

From the project README

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

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-L78	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	L79-L90	Configuring Chaos Studio experiments: AKS pod faults, fault/action library, workspaces/scenarios via CLI, VNet injection, and classic target selection (static/dynamic, capabilities, Azure Policy).
Integrations & Coding Patterns	L91-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
Review supported resources and roles for Chaos Studio	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-providers
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
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
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
Configure dynamic VM targets with Azure CLI for Chaos Experiments	https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-tutorial-dynamic-target-cli
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

Comments

Markdown supported

Details

Author: microsoftdocs
Repository: microsoftdocs/agent-skills
Category: Testing & quality
Installs: 168
GitHub stars: 796

Report

More skills

All skills

hyperframes-cli

github.com/heygen-com

1.3M

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, compare, grade-compare, preview, play, render, publish, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (hyperframes lambda deploy / render / progress / destroy / policies / sites).

tdd

github.com/mattpocock

1.2M

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

anti-ui-slop

uizze.com

932.8k

Stop coding agents from shipping generic UI. Use UIZZE's 800,000+ real web and iOS screens to build product-specific interfaces, define a design contract, cover required states, and run a hard finish gate. Use when designing, implementing, redesigning, critiquing, or pre-ship reviewing a web or iOS interface in Codex, Claude Code, Cursor, Copilot, or another coding agent. Trigger with "anti-ui-slop", "stop UI slop", "ground this UI in real screens", or "run the UI finish gate".

diagnosing-bugs

github.com/mattpocock

856.9k

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.