umple-diagram-generator

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Generate diagrams (state machines, class diagrams) from natural language requirements using Umple. Use when user requests: (1) State machine diagrams (2) UML class diagrams (3) Diagram generation from text descriptions, (4) Any mention of Umple diagram generation, (5) Visual representation of states, transitions, events, classes, or relationships. Outputs SVG diagrams with organized folder structure.

1installs

Sourceumple/umple-skills

Added on2026-02-23

NPX Install

npx skill4agent add umple/umple-skills umple-diagram-generator

SKILL.md Content

View Translation Comparison →

Umple Diagram Generator Skill

Overview

Generate an Umple

.ump

model from requirements and render it to SVG (Umple + Graphviz).

Supported diagram types

Type	Umple generator	Read before writing Umple
`state-machine`	`GvStateDiagram`	`references/state-machine-guidance.md`
`class-diagram`	`GvClassDiagram`	`references/class-diagram-guidance.md`

Script

Entry point:

scripts/main.ts

(run with Bun via

npx -y bun

).

Quick start

bash

# Folder mode: organized output with all files (.ump, .gv, .svg)
npx -y bun ${SKILL_DIR}/scripts/main.ts --input model.ump --output ./diagrams --name "light-controller"

# Exact path mode: save SVG to specific file path
npx -y bun ${SKILL_DIR}/scripts/main.ts --input model.ump --output ./my-diagram.svg

# Class diagram with custom name
npx -y bun ${SKILL_DIR}/scripts/main.ts --input model.ump --output ./diagrams --name "user-system" --type class-diagram

Replace

${SKILL_DIR}

with the absolute path to this skill directory.

Script options

Option	Description
`-i, --input <path>`	Input `.ump` file (required)
`-o, --output <path>`	Output path: directory for folder mode, or `.svg` file for exact path (required)
`-n, --name <name>`	Diagram name for folder mode (optional, triggers folder mode)
`-t, --type <type>`	Diagram type: `state-machine` (default), `class-diagram`
`-s, --suboption <opt>`	GvStateDiagram suboption (repeatable)
`--json`	JSON output with details
`-h, --help`	Show help

Output modes

Folder Mode (when

--name

is specified or

--output

is a directory):

Creates organized folder with timestamped name
Includes all files:
```
.ump
```
(source),
```
.gv
```
(graphviz),
```
.svg
```
(diagram)

Folder naming:

With
```
--name
```
:
```
<sanitized-name>_<timestamp>/
```
Without
```
--name
```
:
```
<diagram-type>_<timestamp>/
```

Example:

diagrams/
└── light-controller_20260121_183045/
    ├── model.ump
    ├── model.gv
    └── model.svg

Exact Path Mode (when

--output

ends with

.svg

):

Saves only the SVG file to the exact specified path
Useful when user specifies a specific output location