lumen

---

Single-file HTML/SVG outputs that work offline. Bundles and unifies capabilities from five upstream projects into one coherent skill set:

• architecture-diagram-generator — semantic colors, z-order arrow masking
• fireworks-tech-graph — 14 diagram types, AI-domain templates (RAG, Mem0, Multi-Agent)
• visual-explainer — Mermaid with zoom/pan, project recap, fact-check
• gmdiagram — 9 diagram + 9 chart types, JSON → SVG pipeline, Nice Numbers algorithm
• roxabi-forge — 14 fgraph topologies, 10 slide patterns, gallery templates, Frame → Structure → Style → Deliver methodology

✨ Features

• 🎨 8 skills — diagram, chart, mermaid, slides, gallery, guide, recap, fact-check
• 🖌️ 13 aesthetics — 8 mermaid palettes (blueprint, editorial, paper, terminal, dracula, nord, solarized, gruvbox) + 5 fgraph aesthetics (dark-professional, blueprint, editorial, terminal, lyra); glassmorphism / cyberpunk-neon / hand-drawn land in v0.2
• 📄 Single-file HTML — embedded CSS/JS/SVG, opens in any browser, works offline (file://)
• 🤖 Dual distribution — Claude Code plugin AND PI extension from the same repo
• 🪜 Frame → Structure → Style → Deliver — disciplined methodology baked into every skill
• ⚡ No Python, no librsvg — pure HTML/CSS/SVG; LLM authors via skill, or deterministic TS renderer via PI tool

📦 Installation

Claude Code (plugin)

/plugin marketplace add MonsieurBarti/lumen
/plugin install lumen

PI coding agent (extension)

PI discovers the extension automatically once installed.

From npm:

pi install npm:@the-forge-flow/lumen

From GitHub (tracks main):

pi install git:github.com/MonsieurBarti/lumen

Pin a version:

pi install npm:@the-forge-flow/lumen@<version>

Replace <version> with the latest release or any tag from the CHANGELOG.

Then reload PI with /reload.

🎯 Skills

Skills are organized in three tiers (inspired by Shiv Sakhuja's Skill Graphs 2.0):

• Capabilities (atomic) — single-purpose, deterministic. Don't invoke other skills.
• Composites (molecular) — orchestrate 2–10 capabilities in a fixed pipeline.
• Playbooks (compound) — human-driven orchestrators over composites.

Capabilities (skills/)

Skill	What it does	Triggers
lumen-diagram	Architecture / flow / sequence / ER / state / gantt / network / dependency-graph / AI-pattern diagrams	draw, diagram, visualize, sketch, architecture of X
lumen-chart	Bar / pie / line / area / scatter / radar / funnel / bubble / table	chart, graph, plot, trend, comparison
lumen-mermaid	Mermaid with zoom / pan / fit / new-tab export	mermaid diagram, raw mermaid source
lumen-slides	Magazine-quality scroll-snap deck, 10 slide patterns	create deck, slides, pitch, presentation
lumen-gallery	Image / audio comparison gallery, 5 templates, dynamic filters (standalone — not chained from any composite)	gallery, showcase, compare visually, side by side
lumen-guide	Multi-tab HTML doc with component library	write a guide, architecture doc, multi-tab doc
lumen-recap	Project state recap (state + recent + debt + next)	recap, where are we, summarize the project
lumen-fact-check	Verify a doc against the codebase, propose corrections	fact-check, verify this doc, is this still accurate

Composites (composites/)