block-diagram

Generate D2 block diagrams and render SVG artifacts from text briefs.

11|1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/jimezsa/opencolab --skill block-diagram
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: block-diagram
Source: https://github.com/jimezsa/opencolab/tree/main/projects/SKILLS/block-diagram
Command: npx skills add https://github.com/jimezsa/opencolab --skill block-diagram

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Generate accurate, readable D2 block diagrams from a text brief to communicate architecture clearly and deterministically.

Core Features & Use Cases

  • Canonical D2 source: produce diagrams/<slug>.d2 from a textual description for reproducible diagrams.
  • Deterministic rendering: default to sketch-style SVG and optional PNG artifacts when requested.
  • Flexible content: supports LaTeX equation blocks when needed, unlabeled arrows by default, and Telegram file directives when required.
  • Telegram delivery: optional directives for Telegram file transfer.

Quick Start

Describe your system briefly and I will generate a canonical D2 diagram and the corresponding SVG by default.

Frequently Asked Questions about block-diagram

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

FAQPage Schema
How do I generate D2 block diagrams from a text brief?▼

To generate D2 block diagrams from a text brief, describe your system architecture and the tool will normalize components and edges to write a canonical .d2 source file and render an SVG artifact.

Do I need d2 installed in PATH to render block diagrams?▼

Yes, you need the d2 command-line tool and bash available in your PATH to validate the diagram source and execute the provided render script for generating SVG or PNG artifacts.

Can I include LaTeX equation blocks in a D2 diagram?▼

Yes, you can include LaTeX equation blocks in a D2 diagram when needed. The tool processes text briefs to support LaTeX equations alongside normalized components and edges.

What is the best way to automate architecture diagram rendering for Telegram?▼

Automate architecture diagram rendering for Telegram by generating a D2 block diagram and emitting optional Telegram file directives during the SVG or PNG rendering process.

Does the block diagram generator output both SVG and PNG files?▼

Yes, the block diagram generator defaults to sketch-style SVG output and supports optional PNG artifacts, saving both canonical .d2 and rendered image files under a diagrams directory.