AGENTS.md

1Use the canonical `visual-explainer` skill from `plugins/visual-explainer/`.
2 
3For Pi, prefer `pi install git:github.com/nicobailon/visual-explainer` or install a local checkout with `pi install ./visual-explainer`. The package metadata points to `./plugins/visual-explainer` for the skill, `./plugins/visual-explainer/commands` for prompts, and `./plugins/visual-explainer/extension.ts` for the native `visual_explainer` tool.
4 
5Do not keep the old manual installer copies alongside a package install. The manual installer is skill/prompt-only and does not install the native Pi tool. If you previously used `install-pi.sh`, remove `~/.pi/agent/skills/visual-explainer`, the copied `~/.pi/agent/prompts/{diff-review,fact-check,generate-slides,generate-visual-plan,generate-web-diagram,plan-review,project-recap}.md` files, and stale `~/.pi/agent/prompts/s[h]are*.md` files before relying on the package.
6 
7Activate with `$visual-explainer` or slash commands such as `/diff-review`, `/plan-review`, `/generate-web-diagram`, and `/generate-slides` after restarting Pi. Generated pages go to `~/.agent/diagrams/` and should be opened in a browser when possible.
8 
9Command templates are convenience prompts; the skill itself is the source of behavior. The extension exposes one `visual_explainer` tool: use `action: "prepare"` for planning visual explanations after generating or reviewing a substantial plan, architecture, diff, or implementation, and `action: "render"` as the finalizer for writing generated HTML. Ask before calling `visual_explainer` with `action: "prepare"` unless the user explicitly requested visual output. `/generate-web-diagram` remains a prompt template command.
10