processon-diagram-generator
Generate ProcessOn-compatible editable diagrams and optionally render images through the ProcessOn API. Use when the user explicitly requests ProcessOn, hosted editable diagram output, or API-rendered flowcharts, swimlanes, sequences, architectures, ER diagrams, org charts, timelines, or infographics. Requires PROCESSON_API_KEY for remote generation. Prefer Mermaid for ordinary Markdown-native diagrams and PlantUML for strict UML/C4 source.
How do I install this agent skill?
npx skills add https://github.com/full-stack-skills/document-skills --skill processon-diagram-generatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a legitimate tool for generating ProcessOn diagrams. It follows security best practices for credential handling, file path sanitization, and update checking. No malicious patterns were detected.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
ProcessOn Diagram Generator
Convert an evidence-backed diagram specification into editable DSL and, when requested, a rendered image.
Routing
- Use this skill only when ProcessOn or hosted editable output is requested.
- Use the
mermaidskill for ordinary Markdown-native diagrams. Install with:npx skills add full-stack-skills/document-skills --skill mermaid. - Use the
plantumlskill for strict UML, C4, or.pumloutput. Install with:npx skills add full-stack-skills/document-skills --skill plantuml. - Use the
processon-mindmapskill when only a ProcessOn-ready mind-map outline is needed. Install with:npx skills add full-stack-skills/document-skills --skill processon-mindmap.
Configuration
Required:
export PROCESSON_API_KEY="<your-processon-api-key>"
Obtain a key at https://smart.processon.com/user. Never print, persist, or include the key in prompts or output.
Optional configuration:
| Variable | Purpose |
|---|---|
PROCESSON_DSL_API_URL | Override the DSL API URL |
PROCESSON_RENDER_API_URL | Override the image-render API URL |
PROCESSON_MODEL | Override the remote model |
PROCESSON_UID | Override the request UID |
PROCESSON_CONNECT_TIMEOUT | Request timeout in seconds |
PROCESSON_MAX_RETRIES | Retries for timeout, 429, and 5xx failures |
Do not perform a remote update check on every invocation. Check the bundled version files only when the user asks about updates or maintenance.
Run an explicit update check only on request:
python3 scripts/check_update.py
Workflow
- Extract nodes, relationships, decisions, participants, states, and labels from the request or inspected source.
- Resolve missing relationships with source inspection; ask only when ambiguity materially changes the diagram.
- Build a concise prompt that preserves the user's language and requests a readable layout with minimal crossings.
- Run the bundled client:
python3 scripts/processon_api_client.py \
--title "登录流程" \
"生成登录、鉴权、数据查询和令牌签发流程图"
- Use
--no-renderwhen only editable DSL is needed. - Deliver the complete DSL and edit URL even if image rendering fails.
Output contract
The final response must include:
- complete DSL without truncation;
- the edit URL
https://smart.processon.com/editor; - rendered image URL or saved path when rendering succeeds;
- a clear rendering failure reason when it fails;
- assumptions made while reconstructing the diagram.
Use ordinary Markdown links or local image previews when supported by the host. Do not impose raw-URL-only formatting unless the user requests it.
Reliability rules
- Retry only timeouts, connection failures, HTTP 429, and HTTP 5xx.
- Use bounded exponential backoff.
- Do not retry authentication or other deterministic 4xx failures.
- Keep DSL delivery independent from image rendering success.
- Save images beneath the requested project or explicit output directory; never use a machine-specific hard-coded path.
- Reject empty or malformed API responses with a diagnostic that does not expose credentials.
Validation
Before completion, confirm the DSL is non-empty, the diagram type is known or explicitly generic, the edit URL is present, and any local output path exists. Run the offline unit tests after changing the client:
python3 -m unittest discover -s tests -p 'test_*.py'
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/full-stack-skills/document-skills/processon-diagram-generator">View processon-diagram-generator on skillZs</a>