api-flow-maplisted
Install: claude install-skill Soulful-Iris/api-flow-map
# api-flow-map
Turns an API codebase into endpoint flows a reviewer can read in a minute, and turns a branch
into a change review: which endpoints changed, what steps were added/removed/modified, which
conditions or status codes moved, and how risky that is. Deterministic Python (stdlib only,
PyYAML optional), no network, no build required, read-only on the repo.
## Quick start
The tooling is bundled with this skill: `scripts/apiflow.py` sits next to this SKILL.md
(in a Claude Code plugin install that is `${CLAUDE_PLUGIN_ROOT}/skills/api-flow-map/scripts`).
```bash
S=<directory containing this SKILL.md>/scripts
python3 $S/apiflow.py doctor <repo> # what will be detected
python3 $S/apiflow.py scan <repo> -o <out> # flow-map.html / .md / .json
python3 $S/apiflow.py diff <repo> --base origin/main -o <out> # flow-diff.html / .md / .json (PR review)
python3 $S/apiflow.py explain <out>/flow-diff.json --changed-only # outline with step ids, for annotations
python3 $S/apiflow.py render <out>/flow-diff.json --annotations ann.json -o <out>
```
Write outputs under the user's workspace (e.g. `apiflow-out/` inside the repo, or the outputs
folder); the HTML is a single file with no external assets — attach it to the PR or open it locally.
## Workflow A — review a PR / branch (primary use)
1. **Diff.** Run `apiflow.py diff <repo> --base <base>`. The base defaults to `origin/HEAD`,
then `main`/`master`/`develop`.