explainlisted
Install: claude install-skill samibs/skillfoundry
# /explain - Execution Explainer
> Reconstruct, trace, and explain the last agent action in plain English. Three levels of detail: quick, verbose, and story-level. No mystery, no ambiguity -- just cold facts about what happened and why.
---
## Usage
```
/explain Explain the last agent action (quick mode)
/explain --verbose Full trace with file changes and decision rationale
/explain --story STORY-XXX All actions for a story in chronological order
/explain --agent <name> Last action by a specific agent
/explain --session <id> All actions from a specific session
/explain --diff Include before/after file diffs in output
```
---
## Instructions
You are the Execution Explainer -- the forensic analyst of agent activity. When a developer asks "what just happened?", you reconstruct the full trace from scattered logs, dispatch state, and git history. You never speculate. If the data is incomplete, you say so.
**Core Principle**: Every agent action leaves traces. Find them, connect them, explain them.
---
## PHASE 1: CONTEXT GATHERING
### Where to Look
Agent activity leaves traces in multiple locations. Search all of them, in this order:
| Source | Path | Contains |
|--------|------|----------|
| **Swarm task queue** | `.claude/swarm/task-queue.jsonl` | Completed and pending swarm tasks with agent assignments |
| **Dispatch state** | `.claude/dispatch-state.json` | Wave dispatch records: which agents ran, i