/ 目录 / 演练场 / excalidraw-skill
● 社区 Agents365-ai ⚡ 即开即用

excalidraw-skill

作者 Agents365-ai · Agents365-ai/excalidraw-skill

Claude Code skill for turning natural-language system descriptions into hand-drawn Excalidraw diagrams — SVG/PNG/editable .excalidraw export.

Agents365-ai's Excalidraw skill auto-detects when a discussion needs a diagram (3+ components, multi-tier systems, workflows) and generates the right one: flowchart, architecture, sequence, mind map, or swimlane. Export via Kroki API (no install) or local excalidraw-brute-export-cli with Firefox. Editable .excalidraw files open directly on excalidraw.com.

为什么要用

核心特性

实时演示

实际使用效果

excalidraw-skill.replay ▶ 就绪
0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法: excalidraw-skill

Sketch a microservices architecture diagram from a prose description

👤 Engineers writing design docs ⏱ ~10 min beginner

何时使用: You're writing an RFC and want a diagram without opening a separate tool.

步骤
  1. Describe the system
    Use the excalidraw skill — draw a microservices e-commerce architecture with clients, API gateway, 4 services, RabbitMQ, and per-service databases.✓ 已复制
    → Claude generates layout + exports an SVG via Kroki
  2. Tweak and re-export
    Add Redis in front of the product service and regenerate.✓ 已复制
    → Updated diagram with Redis inserted, layout re-balanced
  3. Save editable version
    Save as .excalidraw so I can edit it on excalidraw.com.✓ 已复制
    → File saved to CWD

结果: A hand-drawn-style architecture diagram in your doc in under 5 minutes.

注意事项
  • Diagram is cluttered for 10+ components — Ask Claude to group by tier first; the skill has layout rules for that
搭配使用: filesystem

Generate a sequence diagram from an API interaction you just debugged

👤 Backend engineers documenting flows for teammates ⏱ ~10 min beginner

何时使用: You finally figured out the 5-service OAuth dance and want to document it.

步骤
  1. Paste the log or describe the flow
    Excalidraw skill — sequence diagram: user → frontend → auth service → identity provider → callback → session.✓ 已复制
    → Sequence diagram with correct arrows and return messages
  2. Refine
    Add the error path when the IdP returns 401.✓ 已复制
    → Alternative flow rendered distinctly

结果: A sequence diagram you can drop into the PR description.

组合

与其他 MCP 搭配,撬动十倍杠杆

excalidraw-skill + filesystem

Save generated diagrams directly into your docs folder

Generate the architecture diagram and save it to docs/architecture/v2.svg.✓ 已复制
excalidraw-skill + github

Attach the diagram to a PR by committing it alongside the spec

Create the diagram, commit to docs/, and reference it in the PR body.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
generate_flowchart process description Process has decision points and sequential steps 0 via Kroki, 0 local
generate_architecture components + relationships System has tiers or service boundaries 0
generate_sequence actors + messages Documenting a time-ordered interaction 0
export_png diagram ID Need rasterized image for docs that don't support SVG 0 (requires local CLI)

成本与限制

运行它的成本

API 配额
Kroki has no explicit quota but don't hammer it
每次调用 Token 数
Diagram specs are compact (<2k tokens typically)
费用
Free — skills are local files. Kroki is free.
提示
Use Kroki for one-offs, install excalidraw-brute-export-cli only if you need offline.

安全

权限、密钥、影响范围

凭据存储: No credentials — pure prompts
数据出站: Kroki path sends your diagram spec to kroki.io. Local CLI path sends nothing.

故障排查

常见错误与修复

Wrong trigger keywords — Claude writes Mermaid instead

Say 'excalidraw' explicitly; 'draw a diagram' alone can pick other tools.

替代方案

excalidraw-skill 对比其他方案

替代方案何时用它替代权衡
Mermaid via markdownYour docs already render Mermaid natively (GitHub, etc.)No hand-drawn aesthetic, less layout control
drawio via desktop appYou want click-heavy manual layoutNot agent-driven

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills