skills.rest
miyake-san
miyake-sanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

create-excalidraw-architecture

Creates editable Excalidraw architecture diagrams for systems, data flows, and deployment decisions.

Updated Aug 28, 2026
Search Tags:#documentation#system design#adr#excalidraw#visualization#rfc#architecture diagram
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill create-excalidraw-architecture-miyake-san
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-excalidraw-architecture
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/experimental/create-excalidraw-architecture
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill create-excalidraw-architecture-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Architecture decisions made during RFC and ADR reviews often lack a clear visual reference, making it hard for reviewers to evaluate components, trust boundaries, and failure paths. This Skill produces editable Excalidraw diagrams that document the decision under review. ## Core Features & Use Cases - Editable Diagram Sources: Saves diagrams as .excalidraw JSON files under docs/architecture/ so they remain versionable and editable. - Decision-Focused Content: Includes titles, legends, responsibilities, protocols, data stores, trust boundaries, external actors, and failure paths relevant to the decision. - Traceability: Links diagram sources from RFCs, ADRs, and specs, and verifies the JSON parses and covers every component in the decision. - Use Case: While evaluating two options in an RFC for a new data pipeline, generate a diagram showing data stores, trust boundaries, and failure paths, then link it from the RFC and the resulting ADR. ## Quick Start Create an Excalidraw architecture diagram for the system described in my RFC and save it to docs/architecture.

Frequently Asked Questions about create-excalidraw-architecture

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

FAQPage Schema
How do I create an Excalidraw architecture diagram for an RFC?▼

Read the spec and RFC, select the smallest diagram set that resolves the decision, and include components, protocols, data stores, and trust boundaries. Save the result as a .excalidraw file under docs/architecture and link it from the RFC.

What should an architecture diagram include for an ADR review?▼

Include a title, legend, component responsibilities, protocols, data stores, trust boundaries, external actors, and important failure paths. Use consistent colors, directional arrows, and labels readable without excessive zooming.

Can Excalidraw diagrams be exported to SVG or PNG?▼

Yes, export SVG or PNG when an Excalidraw-compatible renderer is available in the environment. The editable .excalidraw source remains the canonical artifact, with exports used for embedding in documents.

When should I not use an architecture diagram in a decision process?▼

Do not use a diagram as proof that a component exists or works; diagrams only communicate design intent. Also avoid creating more diagrams than needed—select the smallest set that resolves the decision at hand.

How do I verify an Excalidraw diagram file is valid?▼

Verify the .excalidraw JSON parses without errors and that every component mentioned in the decision appears in the diagram. This check ensures the file stays editable and complete for reviewers.

Related Skills

Explore More Software Engineering Skills→
ElliotChenElliotChen

dfd-analyzer

Generate Level 0–Level 2 Data Flow Diagrams for Spring Boot + DDD projects.

Community
Advanced
CuriousLearnerCuriousLearner
27

architecture-documenter

Document system architecture and technical decisions with diagrams and ADRs.

Community
Advanced
YairamaYairama

security-threat-model

Generate repository-grounded threat models identifying trust boundaries, assets, attack paths, and risks.

Community
Advanced
compozycompozy
2.7k

mermaid-diagrams

Create software architecture, database, and process diagrams using Mermaid text syntax.

Official
Intermediate