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
- Diagram examples must pass their applicable specialized verification checks in scripts/verify-*.py.
- Mermaid import behavior is checked by scripts/verify-mermaid-import.py and the Mermaid import reference path.
- Documentation synchronization is verified by scripts/verify-docs-sync.py.
- Screenshot freshness is enforced by scripts/verify-screenshot-freshness.py.
- Host packaging metadata remains defined through the shared plugin manifest convention, including .claude-plugin/plugin.json.
Routing table
- skills/…/SKILL.md -> docs/diagram-design-skill.md
skills/diagram-design/prompts/**-> docs/diagram-onboarding-and-output.mdskills/diagram-design/references/diagram-types/**-> docs/diagram-taxonomy-and-semantics.md- skills/…/style*.md -> docs/diagram-style-and-primitives.md
- skills/…/animation*.md -> docs/diagram-animation.md
skills/diagram-design/scripts/**-> docs/diagram-self-validation.md- skills/…/doctor*.md -> docs/diagram-diagnostics.md
- skills/…/import-*.md -> docs/diagram-import-export.md
- skills/…/import-mermaid.md -> docs/mermaid-import.md
- skills/…/import-drawio.md -> docs/drawio-import.md
- skills/…/import-excalidraw.md -> docs/excalidraw-import.md
- skills/…/import-plantuml.md -> docs/plantuml-import.md
- skills/…/export*.md -> docs/diagram-export.md
.claude-plugin/**-> docs/plugin-distribution.md- .github/…/release*.yml -> docs/plugin-release-automation.md
- .claude-plugin/plugin.json -> docs/plugin-manifest-validation.md
- scripts/verify-*.py -> docs/quality-assurance.md
- scripts/test-verify-*.py -> docs/diagram-verification-suite.md
- .github/…/ci.yml -> docs/ci-and-pages-automation.md
templates/**-> docs/diagram-asset-library.md- templates/*.html -> docs/diagram-templates.md
examples/**-> docs/diagram-example-gallery.md