Skip to content
Back to search

flowforge-skill

Generate professional draw.io diagrams from natural language — a Claude Code skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wentong2022-arch--flowforge-skill/badge.svg)](/listings/wentong2022-arch--flowforge-skill)

HTML

<a href="/listings/wentong2022-arch--flowforge-skill"><img src="/api/listings/wentong2022-arch--flowforge-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option 1: As a Claude Code Plugin (recommended)

# In Claude Code
/plugin install https://github.com/wentong2022-arch/flowforge-skill

Or add to your plugin marketplace and install from there.

Option 2: Manual Skill Installation

Clone this repo and copy the skill directory to your Claude Code skills folder:

git clone https://github.com/wentong2022-arch/flowforge-skill.git
cp -r flowforge-skill/skills/FlowForge ~/.claude/skills/
# Or for project-scoped:
cp -r flowforge-skill/skills/FlowForge ./.claude/skills/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 203 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # FlowForge
  2. > A Claude Code skill that turns natural language into professional draw.io diagrams — flowcharts, architecture diagrams, comparisons, and more.
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  4. [![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](CHANGELOG.md)
  5. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-orange.svg)](https://code.claude.com)
  6. **English** | [中文](README.zh-CN.md)
  7. <p align="center">
  8. <img src="assets/screenshots/05-llm-full-stack-architecture.png" alt="LLM Full-Stack Architecture — generated by FlowForge" width="800"/>
  9. </p>
  10. ---
  11. ## What is FlowForge?
  12. FlowForge is a [Claude Code](https://code.claude.com) skill that generates professional `.drawio` diagrams from natural language descriptions. Just describe what you want — a CI/CD pipeline, a system architecture, an algorithm comparison — and FlowForge produces a clean, well-laid-out draw.io XML file ready to open in [draw.io desktop](https://www.drawio.com/) or [app.diagrams.net](https://app.diagrams.net).
  13. ### Why draw.io XML?
  14. - **Editable** — You can refine the generated diagram in any draw.io editor.
  15. - **Portable** — Works in browsers, desktop apps, VS Code extensions, Confluence, etc.
  16. - **Deterministic generation** — Absolute coordinates and explicit styles let Claude produce stable, predictable layouts.
  17. ## Features
  18. - **11 layout algorithms** — `flow`, `flow-vertical`, `compare`, `layers`, `loop`, `tree`, `hub`, `columns`, `matrix`, `funnel`, `timeline`, `sequence`
  19. - **5 color themes** — `tech-blue` (default), `morandi`, `mint`, `terracotta`, `indigo`
  20. - **Smart color principles** — Size-adaptive color budget; blue dominates with strategic accent placement to avoid the "rainbow" anti-pattern
  21. - **Orthogonal arrow routing** — Clean right-angle bends, no diagonals
  22. - **Bilingual labels** — Chinese / English with technical abbreviations preserved
  23. - **Sketch-first workflow** — Confirms ASCII sketch with you before generating XML
  24. ## Installation
  25. ### Option 1: As a Claude Code Plugin (recommended)
  26. ```bash
  27. # In Claude Code
  28. /plugin install https://github.com/wentong2022-arch/flowforge-skill
  29. ```
  30. Or add to your plugin marketplace and install from there.
  31. ### Option 2: Manual Skill Installation
  32. Clone this repo and copy the skill directory to your Claude Code skills folder:
  33. ```bash
  34. git clone https://github.com/wentong2022-arch/flowforge-skill.git
  35. cp -r flowforge-skill/skills/FlowForge ~/.claude/skills/
  36. # Or for project-scoped:
  37. cp -r flowforge-skill/skills/FlowForge ./.claude/skills/
  38. ```
  39. ## Usage
  40. In Claude Code, just describe what you want to draw:
  41. ```
  42. Draw a flowchart for our user signup process
  43. 画一个 RAG 检索流程图
  44. Compare PPO vs DPO vs GRPO algorithms
  45. 帮我画一个微服务架构图
  46. ```
  47. Or use the `/FlowForge` slash command explicitly:
  48. ```
  49. /FlowForge "OAuth 2.0 authorization code flow"
  50. /FlowForge path/to/design-doc.md --type layers --theme morandi
  51. ```
  52. ### Workflow
  53. 1. **Describe** what you want
  54. 2. **Confirm theme** (or let it default to `tech-blue`)
  55. 3. **Review ASCII sketch** — FlowForge shows the planned structure before generating XML
  56. 4. **Open the `.drawio` file** in draw.io and refine if needed
  57. ## Color Themes
  58. | Theme | Style | Best for |
  59. |-------|-------|----------|
  60. | `tech-blue` | Blue-gray + warm accents | Technical content, system docs (default) |
  61. | `morandi` | Muted sage + smoky purple | Design portfolios, brand decks |
  62. | `mint` | Mint green + warm yellow | Product flows, user journeys |
  63. | `terracotta` | Earthy clay + sand | Business strategy, operations |
  64. | `indigo` | Bold indigo + violet | Tech presentations, launches |
  65. ## Diagram Types
  66. | Type | Code | Best for |
  67. |------|------|----------|
  68. | Linear flow | `flow` | Sequential steps A → B → C |
  69. | Vertical flow | `flow-vertical` | Top-down processes |
  70. | Comparison | `compare` | A vs B side-by-side |
  71. | Layer stack | `layers` | Multi-tier architectures |
  72. | Cycle | `loop` | Iterative processes (CI/CD, training loops) |
  73. | Tree | `tree` | Hierarchies, taxonomies |
  74. | Hub & spoke | `hub` | One core, many branches |
  75. | Parallel columns | `columns` | 3+ parallel concepts |
  76. | Matrix | `matrix` | Multi-dimension comparisons |
  77. | Funnel | `funnel` | Filtering, conversion |
  78. | Timeline | `timeline` | Version evolution |
  79. | Sequence | `sequence` | Component interactions |
  80. ## Gallery
  81. 9 example diagrams generated by FlowForge, covering all 5 themes and the most-used diagram types — see `gallery/` for source `.drawio` files.
  82. ### Layered Architecture (`layers` × `tech-blue` + multi-color)
  83. <p align="center">
  84. <img src="assets/screenshots/03-platform-architecture.png" alt="Economic Data Platform Architecture" width="700"/>
  85. </p>
  86. ### Algorithm Comparison (`columns` + loop × `tech-blue`)
  87. <p align="center">
  88. <img src="assets/screenshots/04-ppo-dpo-grpo-comparison.png" alt="PPO vs DPO vs GRPO" width="800"/>
  89. </p>
  90. ### Decision Tree (`tree` × `mint`)
  91. <p align="center">
  92. <img src="assets/screenshots/07-storage-decision-tree-mint.png" alt="Database Selection Decision Tree" width="650"/>
  93. </p>
  94. ### Hub & Spoke (`hub` × `indigo`)
  95. <p align="center">
  96. <img src="assets/screenshots/08-agent-capabilities-hub-indigo.png" alt="Agent Capabilities Hub" width="500"/>
  97. </p>
  98. ### Timeline (`timeline` × `terracotta`)
  99. <p align="center">
  100. <img src="assets/screenshots/09-llm-history-timeline-terracotta.png" alt="LLM Evolution Timeline" width="800"/>
  101. </p>
  102. ### Full Index
  103. | # | Diagram | Type | Theme |
  104. |---|---------|------|-------|
  105. | 01 | Data collection pipeline | `flow-vertical` + branch | `tech-blue` |
  106. | 02 | Smart data query pipeline | `flow-vertical` (long, with color rhythm) | `tech-blue` |
  107. | 03 | Economic data platform architecture | `layers` (5 tiers) | multi-color per layer |
  108. | 04 | PPO vs DPO vs GRPO algorithms | `columns` (horizontal × vertical compare, with loops) | `tech-blue` + accents |
  109. | 05 | LLM full-stack architecture | `layers` (6 tiers + cross-cutting panel) | full palette |
  110. | 06 | Traditional vs AI-augmented data team | `compare` | `morandi` |
  111. | 07 | Database selection decision tree | `tree` | `mint` |
  112. | 08 | AI Agent capability hub | `hub` (6 spokes) | `indigo` |
  113. | 09 | LLM evolution timeline | `timeline` (alternating) | `terracotta` |
  114. > Open any `.drawio` file in [app.diagrams.net](https://app.diagrams.net) to view or edit.
  115. ## Project Structure
  116. ```
  117. flowforge-skill/
  118. ├── .claude-plugin/
  119. │ └── plugin.json # Plugin metadata
  120. ├── skills/
  121. │ └── FlowForge/
  122. │ ├── SKILL.md # Main skill instructions (entry point)
  123. │ ├── themes.md # 5 color theme definitions
  124. │ ├── xml-reference.md # XML element templates
  125. │ ├── examples.md # Complete reference examples
  126. │ └── examples/ # Reference .drawio files
  127. ├── gallery/ # Showcase diagrams
  128. ├── assets/screenshots/ # README screenshots
  129. ├── README.md # English README
  130. ├── README.zh-CN.md # 中文 README
  131. ├── LICENSE # MIT
  132. └── CHANGELOG.md
  133. ```
  134. ## Design Philosophy
  135. - **Layout is deterministic** — Every diagram type has explicit coordinate formulas. No "AI guesses positions."
  136. - **Color is semantic** — Each color maps to a meaning (primary / accent / warning / etc.). Never decorative.
  137. - **Restraint over decoration** — Most nodes use the dominant color family. Accent colors are scalpels, not paintbrushes.
  138. - **Bilingual labels** — Use the user's language naturally. Technical terms (API, LLM, RAG) stay in English.
  139. ## Contributing
  140. PRs welcome! Areas where contributions are especially valuable:
  141. - New diagram type layouts (e.g., Gantt, mind map, ER diagram)
  142. - Additional color themes
  143. - Gallery examples for different domains
  144. - Translations (`README.{lang}.md`)
  145. ## Acknowledgments
  146. Built following the design principles in [Lessons from Building Claude Code: How We Use Skills](https://x.com/trq212/status/2033949937936085378) by [Thariq Shihipar](https://x.com/trq212) at Anthropic.
  147. ## License
  148. [MIT](LICENSE) © 2026 [winstonyoyo](https://github.com/wentong2022-arch)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.