workflow-generatorlisted
Install: claude install-skill askuma/workflow-generator
# workflow-generator
Scan the current project and produce a complete visual system workflow with concurrency capacity analysis.
## Steps
1. **Locate the project root** — use the current working directory unless the user specified a path.
2. **Run the analyzer**:
```bash
python3 ~/.claude/skills/workflow-generator/scripts/analyze.py <project_root> <project_root>/WORKFLOW.html
```
3. **Open the output**:
```bash
xdg-open <project_root>/WORKFLOW.html 2>/dev/null || open <project_root>/WORKFLOW.html 2>/dev/null || true
```
4. **Report to the user** — include:
- Framework and worker count
- Concurrent request capacity (total I/O + practical throughput)
- Primary bottleneck
- Detected storage and external sources
- Clickable link to `WORKFLOW.html`
## Output sections
The generated `WORKFLOW.html` always contains all of the following:
1. **Stat row** — 4–6 large-number tiles:
- API Worker Processes (replicas × uvicorn/gunicorn workers)
- Max Concurrent Async I/O (~100 per asyncio worker)
- Max Parallel CPU Tasks (asyncio.Semaphore limit, if detected)
- Rate Limit (nginx / slowapi / express-rate-limit, if detected)
- Practical Throughput (what the real ceiling is after all limits)
- LLM Timeout (if an LLM provider is detected)
2. **System Architecture diagram** — adaptive layered CSS flow:
- **EXTERNAL SOURCES & CLIENTS** — webhook sources (Jira, Slack, ADO, GitHub, Stripe), users
- **GATEWAY / REVERSE PROXY** — nginx