| name | start-chaos |
| description | Orchestrate the full Chaos Studio v2 workflow: auth → workspace → scenario → run. Shares a single state file and supports resume. |
StartChaos — Orchestrated Chaos Experiment Pipeline
⛔ ABSOLUTE RULE: Do NOT improvise, skip, or substitute any step. On ANY error, STOP and wait for the user.
When to use this skill (vs. the MCP server)
This skill is the human-interactive path: it persists state, renders cards,
prompts for missing inputs, and generates an HTML report at the end. Use it
when there is a user in the loop.
If you are an autonomous agent with no user to prompt — or you need
typed, atomic operations to compose into your own workflow — use the
chaos-studio MCP server instead (see mcp/README.md). The MCP exposes
the same Chaos Studio v2 surface as discrete tools (chaos_create_workspace,
chaos_list_recommended_scenarios, chaos_execute_scenario, …) without the
state file, cards, or interactive prompts.
Both surfaces target Microsoft.Chaos 2026-05-01-preview and use the local
az login session for auth.
How It Works
All pipeline logic lives in scripts/Invoke-StartChaos.ps1. The script handles auth, workspace creation, scenario setup, execution, permission validation/fix, and the final summary card.
The AI orchestrator's only job is:
- Set
$env:STARTCHAOS_STATE_PATH to ${SESSION_DIR}/startchaos-state.json
- Run the script
- Handle exit codes that require user input (see below)
- Re-run the script with the user's answers as parameters
Running the Script