ui-kit-from-code
Installation
SKILL.md
Skill: ui-kit-from-code
WHAT
Purpose và context
- Purpose: dựng một file HTML độc lập để người (designer, dev, agent) tra cứu và dùng lại hệ thiết kế THẬT của dự án như một Figma UI kit: xem mọi token và component, đổi theme tại chỗ, copy thẳng token hoặc markup đem đi.
- Trigger: "bóc nó ra thành UI kit", "figma ui kit bằng html", "trang tham chiếu design system", "component gallery để tái dùng". Thường gặp sau khi dự án đã có token và component ổn định nhưng chưa có trang nào gom chúng lại.
- Non-goals: sáng tác hệ mới hoặc chỉnh thẩm mỹ (→
hallmark); clone nguyên trang để chạy lại (→extract-site/web-clone); xuất file Figma thật, Storybook hay package npm; sửa code component của dự án.
Mental model
nguồn token (TS/CSS/Tailwind/Compose…) ──chạy thật──▶ JSON token ──▶ CSS vars --<ns>-<role> + --k
component trong code (kích thước, variant, tên kind) ──đọc──▶ class .<ns>-* chỉ dựa vào vars
URL gốc ──discover.mjs (link BFS · mở phần ẩn · chữ ký · bão hoà)──▶ inventory.json + crops ──▶ danh mục phải dựng
kit.html + inventory.json ──--coverage──▶ phủ 100% (data-sig / ui-kit-skip)
└──▶ ui-kit.html (7 phần bắt buộc) ──Playwright──▶ bằng chứng
Kit là bản sao có kiểm chứng của hệ trong code: mọi màu và số đo đều truy ngược được về một hằng số hoặc hàm trong repo. Chỗ nào phải vẽ theo spec vì code không nói rõ thì phải khai ra (RULE-04).