diagnosing-root-causes
Installation
SKILL.md
Diagnosing Root Causes
Use this skill to diagnose a reported problem from supplied resources and deliver an evidence-backed RCA report. The orchestrator classifies the issue, manages clarification and approval gates, routes work to specialist subagents, and keeps conclusions traceable. Raw artifacts stay in subagent contexts; the orchestrator retains only bounded summaries, verdicts, approvals, and drafts.
Inputs
| Input | Required | Example |
|---|---|---|
ISSUE |
Yes | "Deploy job fails after dependency update" |
RESOURCES |
Yes | logs/build-42.txt, repo paths, CI URL, commit range |
ISSUE_SOURCE |
No | runtime, CI/CD, or user-report |
REPRODUCTION |
No | npm test -- auth.spec.ts fails locally |
ENVIRONMENT |
No | macOS, Node 22, branch, commit, affected version |
APPROVED_ACTIONS |
No | Tier C actions approved for handoff packaging only, default none |