Introducing a new way to review your PRs.

Read the announcement

cathrynlavery / diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

View on GitHub

23 documents · Updated Nov 20, 2026

overview

Knowledge Base updated: 2026-11-19

Diagram Design Knowledge Base

Orientation

This repository packages the diagram-design capability: a reusable skill, import/export flows, visual assets, and validation tooling for creating diagram deliverables.

The primary instruction and implementation surface is skills/diagram-design/; reusable templates and examples support artifact production, while scripts/ supplies repository-wide verification checks.

Plugin manifests under host-specific integration directories package the skill for supported assistants. GitHub Actions runs checks and publishes repository artifacts.

System architecture

flowchart TD
  Users[Diagram authors] --> Skill[diagram-design skill]
  Skill --> Guidance[References and prompts]
  Skill --> Templates[HTML templates]
  Skill --> Examples[Example artifacts]
  Guidance --> Import[Import workflows]
  Import --> Mermaid[Mermaid import]
  Import --> Drawio[draw.io import]
  Import --> Excalidraw[Excalidraw import]
  Import --> PlantUML[PlantUML import]
  Skill --> Validation[Skill-local validation]
  Validation --> Verifiers[Repository verification scripts]
  Templates --> Artifacts[Completed diagram artifacts]
  Artifacts --> Export[Export workflow]
  Verifiers --> CI[GitHub Actions CI]
  Skill --> Plugins[Host plugin manifests]
  Plugins --> Hosts[Claude, Codex, Factory, Qoder]

Glossary

  • diagram-design skill: The central instruction set and supporting resources for diagram creation.
  • Artifact: A completed diagram deliverable and its associated output assets.
  • Host manifest: Package metadata that exposes the skill to a particular assistant host.
  • Verification script: A specialized repository check for a diagram family or cross-cutting quality property.
  • Shared plugin root: The common package-root convention used by the supported host integrations.

Invariants

Routing table