AV

aref-vc/excalidraw-skill

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

25 stars 质量 68 趋势 19MIT

一个Claude代码技能,可以将任何文本提示转换成手绘的Excalidraw风格图示,本地保存为SVG + PNG。没有浏览器,没有Puppeteer,没有MCP服务器。

概览

一个Claude代码技能,可以将任何文本提示转换成手绘的Excalidraw风格图示,本地保存为SVG + PNG。没有浏览器,没有Puppeteer,没有MCP服务器。 用通俗易懂的英语描述一张图,并在一秒内获得本地手绘草图: - — 决策树、流程、用户旅程 - — 服务、数据库、API、连接 - — 组件、数据流、部署管道 输出采用正宗Excalidraw风格:标签用Virgil手写字体,注释用Cascadia单空间,粗略手绘形状用粗糙字体。 安装后,在Claude代码中触发该技能: 默认情况下,图表会以 SVG 和 PNG(2 倍分辨率)两种形式保存到 ~/Downloads/Excalidraw/。 要更改输出目录,请编辑 SKILL.md 中的OUTPUT_DIR行: 在带有注释属性的形状上直接添加技术细节。注释在标签下方以单空间表示,若超出形状边界则自动用省略号截断。

概述(AI 翻译)

一个Claude代码技能,可以将任何文本提示转换成手绘的Excalidraw风格图示,本地保存为SVG + PNG。没有浏览器,没有Puppeteer,没有MCP服务器。

它的作用

用通俗易懂的英语描述一张图,并在一秒内获得本地手绘草图:

  • 流程图——决策树、流程、用户旅程
  • 架构图 — 服务、数据库、API、连接
  • 系统设计 — 组件、数据流、部署管道

输出采用正宗Excalidraw风格:标签用Virgil手写字体,注释用Cascadia单空间,粗略手绘形状用粗糙字体。

安装

用途

安装后,在Claude代码中触发该技能:

或者自然地描述你想要的:

输出

默认情况下,图表会以 SVG 和 PNG 格式(2 倍分辨率)保存到 ~/Downloads/Excalidraw/。

要更改输出目录,请编辑 OUTPUT_DIR 中的 OUTPUT_DIR 行:

支持元素

类型 描述 关键属性
rectangle 服务,组件(可选圆角) label,annotation,sectionLabel,rounded

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Excalidraw Skill for Claude Code

A Claude Code skill that transforms any text prompt into a hand-drawn Excalidraw-style diagram, saved as SVG + PNG locally. No browser, no Puppeteer, no MCP server.

What it does

Describe a diagram in plain English and get a hand-drawn sketch rendered locally in under a second:

  • Flowcharts — decision trees, process flows, user journeys
  • Architecture diagrams — services, databases, APIs, connections
  • System designs — components, data flows, deployment pipelines

Output uses the authentic Excalidraw look: Virgil handwritten font for labels, Cascadia monospace for annotations, and roughjs for sketchy hand-drawn shapes.

Install

# Clone into your Claude Code skills directory
git clone https://github.com/aref-vc/excalidraw-skill.git ~/.claude/skills/excalidraw

# Install renderer dependencies
cd ~/.claude/skills/excalidraw/scripts && npm install

Usage

Once installed, trigger the skill in Claude Code:

/excalidraw user -> API gateway -> auth service -> database

Or describe what you want naturally:

draw me a hand-drawn architecture diagram with a load balancer,
three API servers, a Redis cache, and a PostgreSQL database

Output

By default, diagrams are saved to ~/Downloads/Excalidraw/ as both SVG and PNG (2x resolution).

To change the output directory, edit the OUTPUT_DIR line in SKILL.md:

OUTPUT_DIR: ~/Documents/My Diagrams/

Supported Elements

Type Description Key properties
rectangle Services, components (optional rounded corners) label, annotation, sectionLabel, rounded
ellipse Actors, users, external systems label, annotation
diamond Decisions, conditions label
arrow Connections between shapes (auto-routed) label (collision-aware positioning)
line Dividers, separators points
text Titles, annotations, labels subtitle (stacked below with gap)

Features

Inline annotations

Add technical details directly on shapes with the annotation property. Annotations render in monospace below the label and auto-truncate with ellipsis if they exceed the shape bounds.

{
  "type": "rectangle",
  "label": "API Gateway",
  "annotation": "REST + WebSocket | Rate limited | JWT auth",
  "width": 200, "height": 100
}

Section labels

Group related shapes in zone rectangles with sectionLabel. The label renders bold at the top-left corner, inset from the edge.

{
  "type": "rectangle",
  "x": 30, "y": 80,
  "width": 500, "height": 220,
  "fill": "#e7f5ff",
  "sectionLabel": "API LAYER"
}

Title with subtitle

在 GitHub 查看完整 README

推荐工具

换一个关键词,或者移除筛选条件。

安装

npx skillfish add aref-vc/excalidraw-skill
新手?先看 mcpskill.org 教程 →