trellis-visualize

Generate offline HTML/SVG diagrams for architecture, flows, logic, and state transitions.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-visualize-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-visualize
Source: https://github.com/SilentFlower/flower-trellis/tree/main/.agents/skills/trellis-visualize
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-visualize-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes assets (resource) components.

What problem does it solve? Turning complex system architecture, business processes, logic rules, and state transitions into reviewable visual diagrams usually requires external diagramming tools or online services. This Skill produces standalone HTML files with inline SVG graphics that open in any browser offline, with no JavaScript, external rendering services, or API keys required. ## Core Features & Use Cases - Four diagram types: architecture diagrams (systems, services, deployments, cloud resources), flowcharts (roles, branches, exceptions, swimlanes), logic diagrams (rules, conditions, causality), and state diagrams (transitions, rollbacks, timeouts). - Template-based generation: every diagram is built on the bundled templates/template.html, which provides a dark grid background, SVG arrow markers, semantic color palette, legend, and summary cards, ensuring a consistent visual system. - Structured workflow: builds an explicit graph model first (subjects, relations, boundaries, terminal states), asks up to 3 clarifying questions when structure-affecting information is missing, and runs a post-generation self-check to remove leftover template placeholder text. - Use Case: Ask to visualize an order approval flow, and receive doc/visualize/order-approval-flow.html with swimlanes, decision branches, exception paths, and summary cards, plus an optional PNG screenshot rendered via Playwright. ## Quick Start Ask the AI to draw an architecture diagram or flowchart of your system or business process, for example: visualize the order approval workflow including roles, decision branches, and exception handling.

Frequently Asked Questions about trellis-visualize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an architecture diagram as HTML without external tools?▼

Describe your system's components, services, and dependencies, and the Skill builds a graph model then generates a standalone HTML file with inline SVG at doc/visualize/<slug>.html. The file opens offline in any browser with no JavaScript, rendering libraries, or API keys.

What diagram types can this visualization skill create?▼

It supports four diagram types: architecture diagrams for systems and deployments, flowcharts for business processes and swimlanes, logic diagrams for rules and causality, and state diagrams for transitions and rollbacks. Legacy requests like UML or activity diagrams are also handled.

Can I create flowcharts and state diagrams with the same template?▼

Yes, flowcharts, logic diagrams, and state diagrams reuse the same template structure, dark grid, SVG defs, and card layout as architecture diagrams. The semantic color palette maps roles, decisions, exceptions, and terminal states onto the existing color system.

Does the generated SVG diagram require JavaScript or internet access?▼

No, the output is a standalone HTML file with inline CSS and SVG and no JavaScript. It renders fully offline in a browser; only the optional Google Fonts link degrades gracefully to system fonts when offline.

How do I get a PNG image of the generated diagram?▼

PNG screenshots are generated only when you request a preview, using a local Playwright Chromium script that loads the HTML file and captures a full-page screenshot. If Playwright is unavailable, the HTML remains the primary deliverable and the failure is reported.

When should I not use this visualization skill?▼

Do not use it for PRD extraction, task specification verification, post-development quality checks, or full-chain automated testing; those belong to other trellis skills. It also does not produce Mermaid-only output or write to the legacy doc/uml/ directory.