{"id":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","shortId":"5Z9aze","kind":"skill","title":"azure-chaos-studio","tagline":"Expert knowledge for Chaos Studio development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when creating Chaos Studio experiments via ARM/CLI, configuring Chaos Agent, Azure Monitor, Private Link, or AKS targets, and","description":"# Chaos Studio Skill\n\nThis skill provides expert guidance for Chaos Studio. Covers troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.\n\n## How to Use This Skill\n\n> **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\n\n> **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)\n\nThis skill requires **network access** to fetch documentation content:\n- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.\n- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.\n\n## Category Index\n\n| Category | Lines | Description |\n|----------|-------|-------------|\n| Troubleshooting | L33-L40 | Diagnosing and fixing Chaos Studio and Chaos Agent issues, including installation/health problems, VM agent status checks, known errors, and common experiment or connectivity failures. |\n| Limits & Quotas | L41-L48 | Chaos Studio limits: agent OS/fault compatibility, known issues, regional/HA behavior, and throttling, quotas, and usage constraints for experiments |\n| Security | L49-L63 | Securing Chaos Studio: identities, roles, permissions, CMK encryption, network/IP controls, Private Link, VNet injection, AKS auth, and safely controlling experiment targets/capabilities. |\n| Configuration | L64-L76 | Authoring and deploying Chaos Studio experiments and targets with ARM/Bicep, configuring agents, policies, monitoring (Azure Monitor, Workbooks), and checking OS/tool compatibility. |\n| Integrations & Coding Patterns | L77-L82 | Using CLI/REST to create and manage Chaos Studio experiments, plus patterns for sending Chaos Agent telemetry to Application Insights and integrating experiments into automated workflows |\n\n### Troubleshooting\n| Topic | URL |\n|-------|-----|\n| Review known issues and workarounds for Chaos Agent | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-known-issues |\n| Troubleshoot Azure Chaos Agent installation and health | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-troubleshooting |\n| Verify and interpret Chaos Agent status on VMs | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-verify-status |\n| Troubleshoot common Azure Chaos Studio issues | https://learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting |\n\n### Limits & Quotas\n| Topic | URL |\n|-------|-----|\n| Check OS and fault compatibility for Chaos Agent | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-os-support |\n| Review Chaos Studio limitations and known issues | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-limitations |\n| Understand Chaos Studio regional and HA model | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-region-availability |\n| Azure Chaos Studio throttling and usage limits | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-service-limits |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Allowlist Chaos Studio Relay Bridge Host container image | https://learn.microsoft.com/en-us/azure/chaos-studio/azure-container-instance-details |\n| Understand Chaos Agent networking, identity, and dependencies | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-concepts |\n| Configure Entra authentication for Chaos Studio AKS faults | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-authentication |\n| Authorize Chaos Studio IP ranges for AKS clusters | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges |\n| Assign managed identity permissions for Chaos experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions |\n| Configure customer-managed keys for Chaos Studio experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys |\n| Assign roles for Chaos Studio supported resource types | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-providers |\n| Configure permissions and security for Azure Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-permissions-security |\n| Configure Private Link for Chaos Agent experiments | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service |\n| Secure Chaos Studio with virtual network injection | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-networking |\n| Control Chaos Studio targets and capabilities securely | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-targets-capabilities |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Deploy Chaos Agent on VM scale sets with ARM | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-arm-template |\n| Author Chaos Studio experiments with Bicep templates | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-bicep |\n| Use Chaos Studio fault and action parameters | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-library |\n| Configure Azure Workbook to measure Chaos Studio faults | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard |\n| Configure Azure Monitor integration for Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor |\n| Check OS and tool compatibility for Chaos Studio | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-versions |\n| Use Azure Policy to auto-add Chaos Studio targets | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-policy-targets |\n| Define Chaos Studio experiments using ARM templates | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-experiment |\n| Deploy Chaos Studio targets and capabilities via ARM | https://learn.microsoft.com/en-us/azure/chaos-studio/sample-template-targets |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Call Azure Chaos Studio REST APIs with CLI samples | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-samples-rest-api |\n| Send Chaos Agent experiment telemetry to App Insights | https://learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights |\n| Create Chaos Studio experiments via CLI and portal | https://learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples |","tags":["azure","chaos","studio","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure-functions"],"capabilities":["skill","source-microsoftdocs","skill-azure-chaos-studio","topic-agent","topic-agent-skills","topic-agentic-skills","topic-agentskill","topic-ai-agents","topic-ai-coding","topic-azure","topic-azure-functions","topic-azure-kubernetes-service","topic-azure-openai","topic-azure-sql-database","topic-azure-storage"],"categories":["Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-chaos-studio","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MicrosoftDocs/Agent-Skills","source_repo":"https://github.com/MicrosoftDocs/Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 549 github stars · SKILL.md body (6,972 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:53:49.920Z","embedding":null,"createdAt":"2026-04-18T21:58:26.028Z","updatedAt":"2026-05-18T18:53:49.920Z","lastSeenAt":"2026-05-18T18:53:49.920Z","tsv":"'/en-us/azure/chaos-studio/azure-container-instance-details':442 '/en-us/azure/chaos-studio/chaos-agent-arm-template':563 '/en-us/azure/chaos-studio/chaos-agent-concepts':452 '/en-us/azure/chaos-studio/chaos-agent-known-issues':353 '/en-us/azure/chaos-studio/chaos-agent-os-support':398 '/en-us/azure/chaos-studio/chaos-agent-troubleshooting':363 '/en-us/azure/chaos-studio/chaos-agent-verify-status':374 '/en-us/azure/chaos-studio/chaos-studio-aks-authentication':463 '/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges':474 '/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions':484 '/en-us/azure/chaos-studio/chaos-studio-bicep':573 '/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys':496 '/en-us/azure/chaos-studio/chaos-studio-fault-library':583 '/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard':594 '/en-us/azure/chaos-studio/chaos-studio-fault-providers':507 '/en-us/azure/chaos-studio/chaos-studio-limitations':408 '/en-us/azure/chaos-studio/chaos-studio-permissions-security':518 '/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service':528 '/en-us/azure/chaos-studio/chaos-studio-private-networking':538 '/en-us/azure/chaos-studio/chaos-studio-region-availability':418 '/en-us/azure/chaos-studio/chaos-studio-samples-rest-api':666 '/en-us/azure/chaos-studio/chaos-studio-service-limits':428 '/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights':677 '/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor':604 '/en-us/azure/chaos-studio/chaos-studio-targets-capabilities':548 '/en-us/azure/chaos-studio/chaos-studio-versions':615 '/en-us/azure/chaos-studio/experiment-examples':688 '/en-us/azure/chaos-studio/sample-policy-targets':628 '/en-us/azure/chaos-studio/sample-template-experiment':638 '/en-us/azure/chaos-studio/sample-template-targets':649 '/en-us/azure/chaos-studio/troubleshooting':383 '/microsoftdocs/mcp/blob/main/readme.md)':160 '3':131 'accept':199 'access':165 'action':579 'add':622 'agent':31,80,124,183,197,219,225,244,299,329,350,357,368,395,445,524,554,669 'ak':37,277,459,470 'allowlist':432 'api':660 'app':673 'applic':332 'arm':560,634,646 'arm/bicep':297 'arm/cli':28 'assign':475,497 'auth':278 'authent':455 'author':288,464,564 'auto':621 'auto-add':620 'autom':338 'avail':150 'azur':2,32,302,355,377,419,513,585,596,617,656 'azure-chaos-studio':1 'behavior':250 'bicep':569 'bridg':436 'call':655 'capabl':72,544,644 'categori':83,91,107,203,205 'chao':3,8,24,30,40,49,215,218,241,264,291,321,328,349,356,367,378,394,400,410,420,433,444,457,465,480,491,500,514,523,530,540,553,565,575,589,600,611,623,630,640,657,668,679 'check':227,306,388,605 'cli':662,683 'cli/rest':316 'cluster':471 'cmk':269 'code':19,59,310,651 'combin':62 'common':231,376 'compat':246,308,392,609 'configur':16,29,56,284,298,453,485,508,519,549,584,595 'connect':234 'constraint':256 'contain':438 'content':67,169 'control':272,281,539 'cover':51 'creat':23,318,678 'custom':487 'customer-manag':486 'defin':629 'depend':449 'deploy':290,552,639 'descript':207 'develop':10 'diagnos':212 'doc':175 'document':70,168 'e.g':95,111 'encrypt':270 'entra':454 'error':229 'experi':26,232,258,282,293,323,336,481,493,525,567,632,670,681 'expert':5,46 'failur':235 'fallback':187 'fault':391,460,577,591 'fetch':71,167,176,189 'file':101,109,116,121 'fix':214 'github.com':159 'github.com/microsoftdocs/mcp/blob/main/readme.md)':158 'guid':157 'guidanc':47 'ha':414 'health':360 'host':437 'ident':266,447,477 'imag':439 'import':78,122 'includ':11,221 'index':84,204 'inject':276,535 'insight':333,674 'instal':154,156,358 'installation/health':222 'integr':18,58,309,335,598,650 'interpret':366 'ip':467 'issu':220,248,345,380,405 'key':489 'knowledg':6 'known':228,247,344,404 'l120':98 'l33':210 'l33-l40':209 'l35':97 'l35-l120':96 'l40':211 'l41':239 'l41-l48':238 'l48':240 'l49':261 'l49-l63':260 'l63':262 'l64':286 'l64-l76':285 'l76':287 'l77':313 'l77-l82':312 'l82':314 'latest':139 'learn':182,196 'learn-agent-skil':181,195 'learn.microsoft.com':352,362,373,382,397,407,417,427,441,451,462,473,483,495,506,517,527,537,547,562,572,582,593,603,614,627,637,648,665,676,687 'learn.microsoft.com/en-us/azure/chaos-studio/azure-container-instance-details':440 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-arm-template':561 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-concepts':450 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-known-issues':351 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-os-support':396 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-troubleshooting':361 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-agent-verify-status':372 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-authentication':461 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-aks-ip-ranges':472 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-assign-experiment-permissions':482 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-bicep':571 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-configure-customer-managed-keys':494 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-library':581 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-metrics-and-dashboard':592 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-fault-providers':505 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-limitations':406 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-permissions-security':516 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-link-agent-service':526 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-private-networking':536 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-region-availability':416 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-samples-rest-api':664 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-service-limits':426 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-app-insights':675 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-set-up-azure-monitor':602 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-targets-capabilities':546 'learn.microsoft.com/en-us/azure/chaos-studio/chaos-studio-versions':613 'learn.microsoft.com/en-us/azure/chaos-studio/experiment-examples':686 'learn.microsoft.com/en-us/azure/chaos-studio/sample-policy-targets':626 'learn.microsoft.com/en-us/azure/chaos-studio/sample-template-experiment':636 'learn.microsoft.com/en-us/azure/chaos-studio/sample-template-targets':647 'learn.microsoft.com/en-us/azure/chaos-studio/troubleshooting':381 'limit':13,53,236,243,384,402,425 'line':93,105,206 'link':35,110,119,274,521 'local':63 'locat':87 'manag':320,476,488 'markdown':186,202 'mcp':145,172 'measur':588 'metadata.generated':126 'microsoft':174 'microsoftdoc':146,173 'model':415 'monitor':33,301,303,597 'month':132 'network':164,446,534 'network/ip':271 'old':133 'os':389,606 'os/fault':245 'os/tool':307 'paramet':580 'pattern':20,60,311,325,652 'permiss':268,478,509 'plus':324 'polici':300,618 'portal':685 'prefer':170 'privat':34,273,520 'problem':223 'provid':45 'pull':137 'queri':178,192 'quick':65 'quick-refer':64 'quota':14,54,237,253,385 'rang':94,468 'read':100,115 'refer':66,120 'region':412 'regional/ha':249 'relay':435 'relev':88 'remot':69 'repositori':143 'requir':163 'resourc':503 'rest':659 'return':185,201 'review':343,399 'role':267,498 'safe':280 'sampl':663 'scale':557 'section':89 'secur':15,55,259,263,429,511,529,545 'security.md':112,113 'send':327,667 'set':558 'skill':42,44,77,162,184,198 'skill-azure-chaos-studio' 'source-microsoftdocs' 'specifi':104 'status':226,369 'string':179,193 'studio':4,9,25,41,50,216,242,265,292,322,379,401,411,421,434,458,466,492,501,515,531,541,566,576,590,601,612,624,631,641,658,680 'suggest':134,151 'support':502 'target':38,295,542,625,642 'targets/capabilities':283 'telemetri':330,671 'templat':570,635 'text/markdown':200 'throttl':252,422 'tool':147,608 'topic':341,386,430,550,653 'topic-agent' 'topic-agent-skills' 'topic-agentic-skills' 'topic-agentskill' 'topic-ai-agents' 'topic-ai-coding' 'topic-azure' 'topic-azure-functions' 'topic-azure-kubernetes-service' 'topic-azure-openai' 'topic-azure-sql-database' 'topic-azure-storage' 'troubleshoot':12,52,208,340,354,375 'type':504 'understand':409,443 'url':342,387,431,551,654 'usag':255,424 'use':21,75,81,99,114,171,188,315,574,616,633 'user':136,153 'verifi':364 'version':140 'via':27,645,682 'virtual':533 'vm':224,556 'vms':371 'vnet':275 'webpag':190 'workaround':347 'workbook':304,586 'workflow':339","prices":[{"id":"268916db-2505-454e-a743-9d4c8304f6cd","listingId":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MicrosoftDocs","category":"Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:58:26.028Z"}],"sources":[{"listingId":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-chaos-studio","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-chaos-studio","isPrimary":false,"firstSeenAt":"2026-04-18T21:58:26.028Z","lastSeenAt":"2026-05-18T18:53:49.920Z"}],"details":{"listingId":"aef4ce33-17ec-4d0c-9cc1-2bdff81d2ed3","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-chaos-studio","github":{"repo":"MicrosoftDocs/Agent-Skills","stars":549,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"license":"cc-by-4.0","html_url":"https://github.com/MicrosoftDocs/Agent-Skills","pushed_at":"2026-05-17T02:50:05Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"397c1880bcf23a4a150ced5169dbc89bcee1db26","skill_md_path":"skills/azure-chaos-studio/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-chaos-studio"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-chaos-studio","description":"Expert knowledge for Chaos Studio development including troubleshooting, limits & quotas, security, configuration, and integrations & coding patterns. Use when creating Chaos Studio experiments via ARM/CLI, configuring Chaos Agent, Azure Monitor, Private Link, or AKS targets, 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 Site Recovery (use azure-site-recovery).","compatibility":"Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation."},"skills_sh_url":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-chaos-studio"},"updatedAt":"2026-05-18T18:53:49.920Z"}}