Ý tưởng kỹ thuật đáng được vẽ tay.

Skill vẽ hình cho Claude Code: bạn đưa một đoạn văn kỹ thuật - hoặc một ý tưởng còn thô mới chỉ có chữ - agent viết một spec JSON ngắn, một lệnh là ra hình Excalidraw thật - kéo vào excalidraw.com sửa tiếp được, đúng màu ở cả chế độ sáng và tối, render offline.

git clone https://github.com/nv-minh/drawing-excalidraw-figures.git
  ~/.claude/skills/drawing-excalidraw-figures

Chưa tin? Xem 32 hình do 4 model AI vẽ cùng một bộ đề.

struct paddingvẽ bằng skill này
đổi hình:

Vẽ hình dạng của ý tưởng, không vẽ danh sách thành phần.

thời gian thành độ dàithanh dài bao nhiêu, chuyện kéo dài bấy nhiêu
dữ liệu thành ôô rộng đúng số byte, giá trị thật nằm trong ô
giới hạn thành một đường kẻngưỡng nét đứt: vượt hay chưa, nhìn là biết
sự cố thành một nét đỏchỗ gãy có dấu X đỏ, không cần chú thích cũng hiểu

Bốn bước, không hơn

Viết một câu

Trước khi vẽ, agent phải viết được câu này. Không viết được thì không vẽ - một hình thừa tệ hơn không có hình.

"Nhìn hình này, người đọc THẤY điều mà đoạn văn không cho thấy."

Ghi spec JSON

Toạ độ, chữ, màu theo tên token. Không mã hex, không vẽ tay từng nét.

// trục thời gian + 10 thanh giữ connection
{"t":"axis","ticks":["0s","1s","2s","3s"]}
{"t":"cells","labels":["","","…"],
 "fill":"warn"}

Chạy một lệnh

Renderer dùng chính thư viện Excalidraw, qua Chromium thật, rồi xuất bốn file.

$ python3 scripts/ve.py fig.json
✓ fig.excalidraw  fig.svg
✓ fig-light.png   fig-dark.png

Soi hai theme, sửa

Tool bắt được chữ tràn, mũi tên xuyên hộp, màu lệch token. Còn hình có đọc được hay không thì mắt phải kiểm.

Hình ví dụ chế độ sáng
chế độ sáng
Hình ví dụ chế độ tối
chế độ tối

Cơ chế bên trong

Điểm khác với các thư viện vẽ hình khác: renderer dùng thư viện Excalidraw thật trong Chromium, đo chữ bằng đúng font sẽ hiển thị, và tô màu bằng token - nên hình bao giờ cũng khít và sống được ở cả hai chế độ.

fig.json spec ngắn ve.py dựng scene Chromium @excalidraw/excalidraw đo chữ bằng font thật SVG var(--token) 4 file + PNG 2 theme cổng tự kiểm: chữ tràn · mũi tên xuyên hộp · màu sai token → về sửa spec rồi chạy lại mỗi vòng render 15-40 giây · vòng sửa thường dừng sau 2-4 lần
Scene thật, không vẽ nháive.py nạp bundle @excalidraw/excalidraw vào Chromium và đo chữ bằng đúng font sẽ hiển thị - hộp không bao giờ rộng hơn chữ sau khi xuất SVG.
Màu là token, không phải hexSpec chỉ nhận tên token (err, l4, warn...), SVG xuất ra tô bằng var(--token) nên chế độ tối không cần vẽ lại lần thứ hai.
Hai hàng cổng trước khi nộp✗ lỗi cứng dừng ngay; • nhắc nhẹ để bạn tự quyết. Cái đo được bằng máy thì máy gác - hình có đọc được hay không là việc của mắt.

Hai mươi chín loại hình, template sẵn

Mỗi loại một template JSON chạy được - chép ra, sửa chữ, là có hình.

Luồng và nghiệp vụ

  • request flow
  • sequence alt/loop
  • swimlane theo vai
  • state lồng nhau
  • system hai luồng
  • failure branch
  • decision tree

Dữ liệu

  • ER crow's foot
  • bảng có hàng thật
  • entity + cột
  • dải ô byte
  • hash ring
  • anatomy lồng khung

Thời gian và ngưỡng

  • timeline
  • threshold
  • curve
  • before / after
  • progressive series
  • code evidence

Trực giác

  • ẩn dụ vật lý
  • two views
  • layer stack
  • layer lanes
  • 188 icon thư viện

Ý tưởng

  • vòng nhân quả
  • ma trận 2x2
  • phễu
  • concept map
MVCC Postgres: ảnh chụp lấy lúc nào
MVCC Postgres: ảnh chụp lấy lúc nào
Sequence có khung alt
sequence với khung alt/else
Swimlane nghiệp vụ
swimlane nghiệp vụ ba vai
ER crow's foot
ER với chân quạ và PK/FK
Ẩn dụ xô token
ẩn dụ cái xô token
Layer lanes
layer lanes: tầng nào làm việc gì
Thanh so ngưỡng
thanh vượt ngưỡng nét đứt

Không chỉ cho kỹ thuật

Một ý còn thô, mới chỉ là vài dòng chữ, cũng có hình dạng riêng. Skill tìm câu "ý này thực chất nói rằng...", giữ đúng chữ của người viết, rồi vẽ đúng chỗ căng thẳng của ý đó. Mỗi đoạn trích được Opus và Sonnet vẽ một lần, không chỉnh tay - bấm tên model để đổi hình.

Pitch kinh doanh: "team muốn giảm giá theo. mình thì nghĩ khác … khách quen hài lòng thì họ kéo bạn bè tới … cái vòng đó chậm nhưng nó tự chạy."
Pitch kinh doanh vẽ thành hình
một bên ngõ cụt, một bên vòng tự chạy
Giảng dạy: "điểm tôi muốn học sinh thấy: không con bướm nào đổi màu cả, chỉ là con nào hợp môi trường thì sống sót … nên tỷ lệ trong quần thể thay đổi."
Giảng dạy vẽ thành hình
đếm được từng con qua các thế hệ
Ghi chú lúc 2 giờ sáng: "tiền tiết kiệm đủ sống khoảng 8 tháng nếu startup sập … cái mình sợ là 5 năm nữa vẫn ngồi đây và hối hận vì không thử."
Ghi chú lúc 2 giờ sáng vẽ thành hình
8 tháng có lối ra, 5 năm thì không
Quy trình nội bộ: "khoản dưới 2 triệu thì trưởng nhóm duyệt xong chuyển thẳng kế toán chi. từ 2 triệu trở lên … thiếu hoá đơn đỏ thì trả lại nhân viên bổ sung"
Quy trình nội bộ vẽ thành hình
ba vai, một ngưỡng, một đường trả lại

188 icon dựng sẵn cho sơ đồ hạ tầng

AWS, Azure, GCP, cơ sở dữ liệu và công cụ phổ biến. Gọi theo tên, skill tự tô màu theo chủ đề sáng hoặc tối.

Bộ icon AWS

39 dịch vụ AWS: tính toán, lưu trữ, CSDL, mạng, bảo mật. Luôn ghi tên sản phẩm làm nhãn dưới icon.

Bộ icon Azure

19 dịch vụ Azure: VM, App Service, SQL, Cosmos DB, Key Vault, Event Hubs. Luôn ghi tên sản phẩm làm nhãn dưới icon.

Bộ icon GCP

29 dịch vụ Google Cloud: Compute, GKE, BigQuery, Pub/Sub, Spanner. Luôn ghi tên sản phẩm làm nhãn dưới icon.

Bộ icon Database và công cụ

Logo PostgreSQL, MySQL, Cassandra, Elasticsearch, Redis, Neo4j, Kafka, Kubernetes, Terraform. Luôn ghi tên sản phẩm làm nhãn dưới icon.

{"t":"icon","name":"gcp-bigquery","x":0,"y":0,"h":60,"text":"BigQuery"} - xem đủ danh sách bằng python3 scripts/ve.py --icons

Cùng một skill, bốn model, tám đề

Cách khách quan nhất để đánh giá một skill vẽ hình: bốn model AI vẽ cùng tám đề, mỗi ô đúng một lần, không chỉnh tay. Bấm vào hình để xem cỡ gốc, bật chế độ tối để kiểm tra mọi hình đều sống được trong tối.

ModelThời gian TBToken TBVòng render TB
Sonnet 5.576 giây105 nghìn2.5
Opus 5.5132 giây112 nghìn3.5
Fable 5.2114 giây109 nghìn2.6
GLM 5.3không đokhông đo3.9

Ba model đầu chạy trong một phiên tự động. GLM 5.3 vẽ sau qua một phiên có gián đoạn nên thời gian và token không so sánh được, chỉ giữ số vòng render (tính cả lần lỗi cú pháp).

Cài đặt

# engine, bundle Excalidraw và font đã nằm sẵn trong repo - render không cần mạng
$ pip install -r requirements.txt
$ python3 -m playwright install chromium

# chạy thử ngay một template có sẵn
$ python3 scripts/ve.py examples/03-byte-cells.json --out /tmp/fig
✓ 03-byte-cells: 46 phần tử · 688×282 · chữ nhỏ nhất 14.5px

# đặt vào chỗ Claude Code tìm skill
$ git clone https://github.com/nv-minh/drawing-excalidraw-figures.git ~/.claude/skills/drawing-excalidraw-figures

# Codex CLI đọc cùng chuẩn SKILL.md - một bản dùng cho cả hai
$ ln -s ~/.claude/skills/drawing-excalidraw-figures ~/.codex/skills/drawing-excalidraw-figures

Sau đó chỉ cần nói "vẽ hình cho đoạn này" trong bất kỳ dự án nào - skill tự nhận việc. Codex CLI đọc cùng chuẩn SKILL.md, chỉ khác thư mục cài như trên. Tool khác (Antigravity, Cursor, Gemini CLI, Copilot): thêm vài dòng trỏ về SKILL.md trong file rules của tool đó. Quy trình đầy đủ sáu bước và bộ luật hình nằm trong SKILL.md.