Excalidraw Code Diagram Skill

Generate importable Excalidraw architecture diagrams from source code.

This repository packages a Codex skill that:

• scans source files in a repository
• extracts file-level relationships and optional top-level symbols
• writes a .excalidraw scene file that can be imported into Excalidraw

Repository layout

.
├── SKILL.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── live-canvas.md
│   └── scene-format.md
└── scripts/
    └── code_to_excalidraw.py

Install as a local Codex skill

Clone this repository, then place or symlink it under:

$HOME/.codex/skills/excalidraw-skill

Example:

git clone <your-repo-url> "$HOME/.codex/skills/excalidraw-skill"

Usage

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/excalidraw-skill/scripts/code_to_excalidraw.py" \
  --input /path/to/repo \
  --output /path/to/repo/output/architecture.excalidraw \
  --title "Repository Architecture"

Then open https://excalidraw.com and import the generated file.

Notes

• The default path is file generation, not live canvas mutation.
• If you already run an Excalidraw MCP server such as mcp_excalidraw, see references/live-canvas.md.
• Supported languages currently include JavaScript, TypeScript, Python, Go, Java, Kotlin, and Rust.