| name | anygen-diagram |
| homepage | https://www.anygen.io |
| description | Generate architecture diagrams, flowcharts, and system diagrams with AnyGen AI. Uses dialogue mode to understand structure, components, and relationships before generating. Triggers: draw diagram, architecture diagram, flowchart, system diagram, whiteboard diagram, sequence diagram. |
| env | ["ANYGEN_API_KEY"] |
| requires | ["sessions_spawn"] |
| permissions | {"network":["https://www.anygen.io","https://esm.sh","https://viewer.diagrams.net","https://registry.npmjs.org","https://storage.googleapis.com"],"filesystem":{"read":["~/.config/anygen/config.json"],"write":["~/.config/anygen/config.json","<skill_dir>/scripts/node_modules/"]}} |
AnyGen AI Diagram Generator
Generate architecture diagrams, flowcharts, and system diagrams from natural language using AnyGen OpenAPI. Supports professional style (clean, structured) and hand-drawn style (sketch-like, informal). Output: source file auto-rendered to PNG for preview.
When to Use
- User needs to create architecture diagrams, flowcharts, or system diagrams
- User has files to upload as reference material for diagram generation
Security & Permissions
What this skill does:
- Sends task prompts and parameters to the AnyGen API at
www.anygen.io
- Uploads user-provided reference files (via
--file) to www.anygen.io for processing
- Downloads diagram source files (.xml/.json) and renders them to PNG locally
- Fetches Excalidraw renderer from
esm.sh and Draw.io viewer from viewer.diagrams.net
- Auto-installs npm dependencies and Chromium on first diagram render (via Puppeteer)
- Reads/writes API key config at
~/.config/anygen/config.json
What this skill does NOT do:
- Does not send your API key to any endpoint other than
www.anygen.io
- Does not modify system configuration beyond
~/.config/anygen/config.json and scripts/node_modules/ within the skill directory
- Does not run persistent background processes
Auto-install behavior: On first render, render-diagram.sh runs npm install to fetch Puppeteer and downloads Chromium (~200MB). This requires network access to registry.npmjs.org and storage.googleapis.com.
Bundled scripts: scripts/anygen.py (Python — uses requests), scripts/render-diagram.sh (Bash), scripts/diagram-to-image.ts (TypeScript — uses Puppeteer)
Review the bundled scripts before first use to verify behavior.
Prerequisites
- Python3 and
requests: pip3 install requests
- Node.js v18+ (for PNG rendering, auto-installed on first run)
- AnyGen API Key (
sk-xxx) — Get one → Setting → Integration
- Configure once:
python3 scripts/anygen.py config set api_key "sk-xxx"
All scripts/ paths below are relative to this skill's installation directory.
CRITICAL: Background Poll — NEVER Block the Conversation
After creating a task, you MUST start a background poll process to auto-download the result, then continue the conversation normally. NEVER call poll in the foreground — it blocks for 3-20 minutes.
Rules:
- Use
create to start the task → get task_id and task_url.
- Give the user the
task_url for immediate online preview.
- Launch
poll as a background process to auto-download the file when ready (see Phase 4).
- Continue the conversation normally — do NOT wait.
- After the conversation naturally ends or the user asks about the result, check if the background poll has completed and deliver the file.
Communication Style
When interacting with the user, communicate naturally and professionally:
- You may refer to AnyGen as the service powering the diagram generation when relevant.
- Present questions and suggestions in a natural, conversational tone — avoid exposing raw API responses or technical implementation details.
- Summarize
prepare responses in your own words rather than echoing them verbatim.
- Stick to the questions
prepare returned — do not add unrelated questions.
Examples
Less ideal (overly technical):
- "The prepare API returned the following JSON response with status=collecting..."
Better (natural and professional):
- "What components and connections should this architecture diagram include?"
- "Based on what you've shared, here is the diagram plan: [summary]. Should I go ahead, or would you like to adjust anything?"
Diagram Workflow (MUST Follow)
For diagrams, you MUST go through all 4 phases. A good diagram needs clear components, relationships, layers, and style. Users rarely provide all of these upfront.
Phase 1: Understand Requirements
If the user provides files, you MUST handle them yourself before calling prepare:
- Read the file content yourself using your own file reading capabilities. Extract key information (architecture, components, flows) that is relevant to creating the diagram.
- Check if the file was already uploaded in this conversation. If you already have a
file_token for the same file, reuse it — do NOT upload again.
- Inform the user and get consent before uploading. Tell them the file will be uploaded to AnyGen's server for processing.
- Upload the file to get a
file_token for later use in task creation.
- Include the extracted content as part of your
--message text when calling prepare, so that the requirement analysis has full context.
The prepare API does NOT read files internally. You are responsible for providing all relevant file content as text in the conversation.
python3 scripts/anygen.py upload --file ./design_doc.pdf
python3 scripts/anygen.py prepare \
--message "I need an architecture diagram based on this design doc. Key components: [your extracted summary/content here]" \
--file-token tk_abc123 \
--save ./conversation.json
Present the questions from reply naturally (see Communication Style above). Then continue the conversation with the user's answers:
python3 scripts/anygen.py prepare \
--input ./conversation.json \
--message "Include API gateway, auth service, user service, and PostgreSQL database. Show the request flow" \
--save ./conversation.json
Repeat until status="ready" with suggested_task_params.
Special cases:
- If the user provides very complete requirements and
status="ready" on the first call, proceed directly to Phase 2.
- If the user says "just create it, don't ask questions", skip prepare and go to Phase 3 with
create directly.
Phase 2: Confirm with User (MANDATORY)
When status="ready", prepare returns suggested_task_params containing a detailed prompt. You MUST present this to the user for confirmation before creating the task.
How to present:
- Summarize the key aspects of the suggested plan in natural language (components, connections, layout style).
- Ask the user to confirm or modify. For example: "Here is the diagram plan: [summary]. Should I go ahead, or would you like to adjust anything?"
- NEVER auto-create the task without the user's explicit approval.
When the user requests adjustments:
- Call
prepare again with the user's modification as a new message, loading the existing conversation history:
python3 scripts/anygen.py prepare \
--input ./conversation.json \
--message "<the user's modification request>" \
--save ./conversation.json
prepare will return an updated suggestion that incorporates the user's changes.
- Present the updated suggestion to the user again for confirmation (repeat from step 1 above).
- Repeat this confirm-adjust loop until the user explicitly approves. Do NOT skip confirmation after an adjustment.
Phase 3: Create Task
Once the user confirms:
python3 scripts/anygen.py create \
--operation smart_draw \
--prompt "<prompt from suggested_task_params, with any user modifications>" \
--file-token tk_abc123 \
--export-format drawio
Immediately tell the user:
- Diagram is being generated (takes a few minutes).
- Give them the Task URL so they can preview progress online right now.
- Tell them you will deliver the rendered PNG once it's ready.
Phase 4: Monitor, Download, Render, and Deliver
Requires sessions_spawn. If sub-agent is not available, skip to the Fallback section below.
With Sub-Agent (preferred)
Spawn a sub-agent to monitor the task in the background. Use sessions_spawn with the following instructions.
Information to pass to the sub-agent (it has NO context from this conversation):
task_id — from Phase 3 output
task_url — the Task URL returned by create
script_path — absolute path to scripts/anygen.py
render_script_path — absolute path to scripts/render-diagram.sh
export_format — drawio or excalidraw
Sub-agent instructions (pass this as the task prompt):
You are a background monitor for an AnyGen diagram generation task.
Task ID: {task_id}
Task URL: {task_url}
Script: {script_path}
Render Script: {render_script_path}
Export Format: {export_format}
Your job:
1. Run the poll command to wait for completion and auto-download:
python3 {script_path} poll --task-id {task_id} --output ~/.openclaw/workspace/ --media
This will poll every 3 seconds, and automatically download the file when completed.
2. Render the downloaded file to PNG:
- Get the local file path from [RESULT] Local file: line
- For drawio: bash {render_script_path} drawio <local_file> <local_file_without_ext>.png
- For excalidraw: bash {render_script_path} excalidraw <local_file> <local_file_without_ext>.png
3. Deliver the result to the user:
a. Show the rendered PNG image to the user as a preview.
b. Send the Task URL ({task_url}) — tell the user they can view and edit the diagram online.
c. If the MEDIA: line was output, send it as a separate message by itself.
4. If rendering fails, tell the user to open the Task URL ({task_url}) to view and export the diagram.
5. If the task itself fails (status="failed"), tell the user the generation failed and provide the Task URL for reference.
6. Timeout after 20 minutes — if still not completed, tell the user the task is taking longer than expected and provide the Task URL for them to check manually.
Then continue the conversation normally. Do NOT wait for the sub-agent.
Fallback (no sub-agent)
If sessions_spawn is not available, tell the user something like: "I've started the generation for you. Unfortunately I'm not able to track the progress automatically in this environment — please check the link above in a few minutes to view and download your diagram."
Render Reference
| Format | --export-format | Export File | Render Command |
|---|
| Professional (default) | drawio | .xml | render-diagram.sh drawio input.xml output.png |
| Hand-drawn | excalidraw | .json | render-diagram.sh excalidraw input.json output.png |
Options: --scale <n> (default: 2), --background <hex> (default: #ffffff), --padding <px> (default: 20)
Command Reference
prepare
python3 scripts/anygen.py prepare --message "..." [--file-token tk_xxx] [--input conv.json] [--save conv.json]
| Parameter | Description |
|---|
| --message, -m | User message text |
| --file | File path to auto-upload and attach (repeatable) |
| --file-token | File token from prior upload (repeatable) |
| --input | Load conversation from JSON file |
| --save | Save conversation state to JSON file |
| --stdin | Read message from stdin |
create
python3 scripts/anygen.py create --operation smart_draw --prompt "..." [options]
| Parameter | Short | Description |
|---|
| --operation | -o | Must be smart_draw |
| --prompt | -p | Diagram description |
| --file-token | | File token from upload (repeatable) |
| --export-format | -f | drawio (default, professional) / excalidraw (hand-drawn) |
| --language | -l | Language (zh-CN / en-US) |
| --style | -s | Style preference |
upload
python3 scripts/anygen.py upload --file ./document.pdf
Returns a file_token. Max file size: 50MB. Tokens are persistent and reusable.
poll
Blocks until task completes, auto-downloads the file, and prints [RESULT] lines.
python3 scripts/anygen.py poll --task-id task_xxx --output ./output/
| Parameter | Description |
|---|
| --task-id | Task ID from create |
| --output | Output directory for auto-download (default: current directory) |
download (manual, if needed)
python3 scripts/anygen.py download --task-id task_xxx --output ./output/
Error Handling
| Error | Solution |
|---|
| invalid API key | Check API Key format (sk-xxx) |
| operation not allowed | Contact admin for permissions |
| prompt is required | Add --prompt parameter |
| file size exceeds 50MB limit | Reduce file size |
Notes
- Max task execution time: 20 minutes
- Download link valid for 24 hours
- PNG rendering requires Chromium (auto-installed on first run)
- Dependencies auto-installed on first run of render-diagram.sh
- Poll interval: 3 seconds