diagram

Generate Mermaid diagrams from wiki content with glossary and sources.

5|1|Updated May 3, 2026
One-click install
npx skills add https://github.com/cooperacode/forge --skill diagram-cooperacode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram
Source: https://github.com/cooperacode/forge/tree/main/.forge/skills/diagram
Command: npx skills add https://github.com/cooperacode/forge --skill diagram-cooperacode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, and includes scripts (resource) components.

What problem does it solve?

Translates the content of the active wiki into readable Mermaid diagrams (C4 context, C4 container, C4 component, process-flow, data-flow, sequence, and state) with an accompanying glossary, enabling quick visual understanding of architectures and flows.

Core Features & Use Cases

  • Extract structural and behavioral relationships from wiki content to produce diagrams that visualize systems, containers, components, flows, and interactions.
  • Align with upstream ADRs and canonical entity names when present to ensure diagrams reflect architectural decisions and entity models.
  • Generate diagrams using Mermaid templates and export to artifacts/diagrams with a linked glossary and sources.

Quick Start

Provide a request like 'Generate a C4-context diagram for the current wiki' to produce the diagram.

Frequently Asked Questions about diagram

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

FAQPage Schema
How do I generate a Mermaid diagram from wiki content?

Generate a Mermaid diagram by parsing active wiki content and upstream context to visualize systems, containers, components, and flows. The diagram is exported to a specified output path with an accompanying glossary and linked sources.

What is the difference between C4-context and C4-container diagrams?

C4-context and C4-container diagrams visualize different hierarchy levels of a system. C4-context maps strategic system interactions, while C4-container diagrams detail the specific deployable units and their relationships within the system.

How do I create a process-flow diagram from an existing wiki?

Create a process-flow diagram by requesting the Skill to parse your active wiki content. It automatically applies the appropriate diagram type based on the work item's hierarchy level and preserves canonical names from upstream ADRs.

Can I use ADR canonical names when generating architecture diagrams?

Canonical names from ADRs are preserved during diagram generation. Aligning with upstream ADRs ensures the generated C4-context, C4-component, and process-flow diagrams accurately reflect established architectural decisions and entity models.

Do I need bash to export Mermaid diagrams to artifacts?

Bash is a required dependency to execute the scripts that parse wiki content and export the generated Mermaid diagrams. The script locks the language and populates the artifact with a linked glossary and sources.

When should I use sequence and state diagrams for my architecture?

Sequence and state diagrams are applied for Tactical work item hierarchy levels. Use these diagram types to visualize specific behavioral interactions and state transitions within your system's components and processes.