concise-diagram
/concise-diagram
Rysuje zwięzłe diagramy architektury, przepływów i sekwencji w Unicode, ASCII lub SVG, z krótkimi etykietami i ponumerowanymi notatkami.
- Autor
- elct9620 ↗
- Repozytorium
- claudekit ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 2
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/icon.py, scripts/lint.py
Co robi i kiedy
Rysuje zwięzłe diagramy architektury, przepływów i sekwencji w Unicode, ASCII lub SVG, z krótkimi etykietami i ponumerowanymi notatkami.
Wyzwalacze z opisu
Oryginalny opis (EN)
Draw diagrams that read at a glance — architecture, layers, flows, sequences, containment — as Unicode text in a terminal reply, ASCII in Markdown, or inline SVG in HTML, with one concept per node, short labels, and lettered notes below; bundled scripts check text diagram alignment and fetch Lucide or brand icons. Use this skill whenever you are about to draw any diagram, box-and-arrow sketch, or ASCII art, including the diagrams inside documents written with concise-docs, even if the user only asks to "explain the structure" or "show how it fits together". 畫架構圖、流程圖、分層圖、時序圖或任何示意圖時使用。
Jak działa
- Elements
- Notes
- Shape
- Medium
- Workflow
Podgląd SKILL.md
---
name: concise-diagram
description: Draw diagrams that read at a glance — architecture, layers, flows, sequences, containment — as Unicode text in a terminal reply, ASCII in Markdown, or inline SVG in HTML, with one concept per node, short labels, and lettered notes below; bundled scripts check text diagram alignment and fetch Lucide or brand icons. Use this skill whenever you are about to draw any diagram, box-and-arrow sketch, or ASCII art, including the diagrams inside documents written with concise-docs, even if the user only asks to "explain the structure" or "show how it fits together". 畫架構圖、流程圖、分層圖、時序圖或任何示意圖時使用。
---
# Concise Diagram
A diagram shows structure: which parts exist and how they connect. Readers take in the shape first, then the labels, then the notes — so the shape carries the meaning and the words stay short.
## Elements
| Element | Holds | Text |
|---------|-------|------|
| Node | One concept | Label of 1-3 words |
| Edge | One relation between two nodes | Specific verb, 1-3 words |
| Group | Nodes that belong together | Label of 1-3 words |
| Note | Detail a label cannot hold | concise-docs sentence limit |
Structure lives in edges and groups. Take away the boxes: if what remains reads as a list, it is a list or a table — write it as one, since side-by-side columns without edges or groups only look like a diagram.
An edge label says what flows or happens — `queries`, `publishes`, `renders` — because a vague `uses` tells the reader nothing the arrow did not. Give each concept one name in the diagram and the surrounding text; in a CJK document, a text diagram needs English labels, so use the English term in the prose too.
## Notes
When a node or edge needs more than its label, mark it with a letter and explain it in a list below the diagram, outside the drawing — a list, because Markdown joins plain lines into one paragraph. Notes are prose, so write them in the reader's language:
```
+----------+ queries +-----------+
| Main (a) |---------->| Store (b) |
+----------+ +-----------+
```
- (a) The main application serving HTTP requests.
- (b) PostgreSQL, one schema per tenant.
The note list is also the diagram's key: explain any notation whose meaning is not obvious, such as a dashed edge.
## Shape
- One main direction, left to right or top to bottom, so the eye follows the flow without searching.
- Crossing edges mean the diagram holds too much; split it. Edges merging into one node are fine. Straight edges with few bends read fastest.
- Order diagrams big to small and shallow to deep, as in concise-docs: the first shows the whole, each later one zooms into a single part and draws it under the same name.
| Form | Shows | Layout |
|------|-------|--------|
| Layers | Dependency between levels | Stacked boxes, top depends on below |
| Flow | Steps or data movement | Boxes and arrows in one direction |
| Sequence | Messages over time | Lifelines across, time downward |
| Containment | What sits inside what | Nested boxes |
## Medium
| Output | Characters | Reference |
|--------|-----------|-----------|
| Terminal reply | Unicode box drawing | `references/terminal.md` |
| Markdown document | ASCII `+ - \| > v` | `references/terminal.md` |
| HTML page | Inline SVG | `references/html.md` |
Markdown is opened in editors and on GitHub with fonts and locales you do not control; ASCII is one column wide everywhere, while box drawing and CJK are not. A text diagram always sits in a code fence, since the terminal renders Markdown too and collapses spacing outside one. A file tree is a listing, not a diagram, and keeps its usual form. Read the reference for the output before drawing.
## Workflow
1. List the nodes, edges, and groups in words before drawing anything; check each is one concept with a 1-3 word label.
2. Pick the form, and split the content into several diagrams if edges would cross.
3. Draw it in the medium's characters, then write the lettered notes below.
4. Check text diagrams with the script and SVG by rendering a screenshot, then fix every error and every label that touches a line or border.
```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/lint.py docs/architecture.md # ASCII in Markdown
python3 ${CLAUDE_SKILL_DIR}/scripts/lint.py --unicode /tmp/diagram.txt # terminal reply
```
For a terminal reply, write the diagram to a scratch file first and check it there. Output is `path:line: error|warning: ...`; the exit code is 1 when any error exists.
Pliki w paczce (5)
- SKILL.md 4 KB
- references/html.md 3 KB
- references/terminal.md 3 KB
- scripts/icon.py 3 KB
- scripts/lint.py 7 KB
Wersje
W bazie nie ma innych skilli o nazwie concise-diagram.
Migawka bazy z 13.11.2026 · wersja paczki fc0a12ed37df (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100text-diagram
Rysuje niezawodne, wyrównane diagramy architektury w tekście ASCII z zagnieżdżonymi ramkami, strzałkami i łącznikami. - 95mermaid
Renderuje diagramy Mermaid jako SVG lub ASCII, na przykład schematy przepływu, sekwencji, stanów i klas. - 95mermaid
Renderuje diagramy Mermaid jako SVG lub ASCII, na przykład schematy przepływu, sekwencji, stanów i klas. - 100plantuml-ascii
Generuje diagramy ASCII z PlantUML w trybie tekstowym: diagramy sekwencji, klas i przepływu, także w wersji Unicode z flagą -utxt. - 100ascii-art-diagram-creator
Prawdopodobnie tworzy diagramy ASCII art w ramach kategorii treści wizualnych. - 100ascii-schemas
Generuje schematy, diagramy i makiety interfejsu w ASCII ze znakami Unicode do rysowania ramek: architektura, modele ER, schematy baz, przepływy, topologie wdrożeń i diagramy sekwencji.