# Create Editable Excalidraw Diagrams

Manual diagram creation is slow and inconsistent. This skill converts natural language into editable Excalidraw files using templates, layout guidance, and optional icon tools.

## Install

```bash
npx skillstore add github/excalidraw-diagram-generator
```

## Metadata

- Status: approved
- Slug: github-excalidraw-diagram-generator
- Skillstore revision: r2
- Version status: missing
- Tree hash: 1515a65446f04340e77de9ef12b7b3af6317109c5b36b43a1624efa7878739f7
- Author: github
- GitHub username: github
- License: MIT
- Repository: https://github.com/github/awesome-copilot/tree/main/skills/excalidraw-diagram-generator/
- Ref: c43861a65bb95efcae259cd161c9d6f4dc7eec6f
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, filesystem, external\_commands
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/github-excalidraw-diagram-generator
- Manifest: https://skillstore.pages.dev/api/skills/github-excalidraw-diagram-generator/manifest

## Capabilities

- Generates editable Excalidraw files from natural language descriptions.
- Supports flowcharts, mind maps, architecture, data flow, class, sequence, swimlane, relationship, and ER diagrams.
- Uses bundled templates for consistent Excalidraw structure and styling.
- Applies layout, spacing, color, font, and element-count guidance.
- Splits Excalidraw libraries into individual icon files and a reference index.
- Adds library icons, labels, and styled arrows to existing diagrams with Python tools.

## Use Cases

- Map Product Workflows: Create flowcharts or swimlanes that show decisions, responsibilities, and handoffs.
- Document Software Design: Build architecture, class, sequence, and data flow diagrams for technical documentation.
- Organize Research Topics: Turn themes, evidence, and related concepts into a readable mind map.

## Prompt Templates

### Simple Flowchart

```
Create an Excalidraw flowchart for [process]. Include [steps], decision points, and a clear start and end.
```

### Cross-Team Workflow

```
Create a swimlane diagram for [workflow]. Use lanes for [roles] and show every handoff, decision, and final outcome.
```

### System Interaction

```
Create a sequence diagram for [scenario]. Include [actors], synchronous and asynchronous messages, return values, and activation periods.
```

### Cloud Architecture

```
Create an Excalidraw architecture diagram for [system]. Use [icon library] when available, label trust boundaries, and show protocols and data flows.
```

## Limitations

- Complex curves use simple straight or basic curved lines.
- Automatic generation does not embed images.
- The workflow does not provide automatic collision detection.
- Specialized icons require a compatible Excalidraw library and local setup.

## Best Practices

- Provide the diagram type, key elements, relationships, and preferred flow direction.
- Keep the first diagram below 20 elements and split detailed subsystems into separate views.
- Review labels, arrow direction, spacing, and source data before sharing the file.

## Anti Patterns

- Do not request one crowded diagram for every system detail.
- Do not use unlabeled arrows when relationships or protocols are important.
- Do not load icon libraries from unknown sources without reviewing their contents.

## Security Audit

- Audited at: 2026-07-23T17:55:29.14\+00:00
- Summary: The 163 static alerts are false positives caused by Markdown, diagram metadata, identifier logic, and documented local file writes. No shell execution or programmatic network request was found. Two semantic risks remain in handling untrusted icon libraries and icon paths.

## Stats

- Views: 221
- Downloads: 61
- Favorites: 1
- Popularity score: 0