Mã nguồn mở bởi pbakaus
Impeccable là một skill thiết kế cho AI coding agent như Claude Code, Cursor, Codex CLI. Nó cho agent một bộ lệnh có tên rõ ràng để chỉnh, rà soát và hoàn thiện giao diện, kèm bộ dò 62 luật cố định để bắt các dấu hiệu giao diện do AI làm đại trà trước khi phát hành.
Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.
Kiểm tra tự động ngày 21/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.
Khi giao cho agent dựng một trang mà không có hướng dẫn thiết kế, kết quả thường lặp lại cùng vài lựa chọn: font Inter cho mọi thứ, gradient tím sang xanh, thẻ lồng trong thẻ, chữ xám trên nền màu, ô icon bo góc trên mỗi tiêu đề. Impeccable gọi nhóm dấu hiệu này là AI slop và xử lý theo ba hướng: cho người dùng từ vựng để nói đúng thứ mình muốn, cho agent một vai người rà soát, và một bộ dò chạy bằng luật cố định.
Cách làm việc: chạy /impeccable init một lần cho mỗi dự án. Lệnh này đọc mã nguồn, hỏi những điều nó không suy ra được (sản phẩm cho ai, cần làm gì, ràng buộc nào) rồi ghi file PRODUCT.md. Lệnh /impeccable document ghi hệ thống hình ảnh hiện có vào DESIGN.md. Các lệnh sau đều đọc hai file này. Sau đó người dùng gọi tên lệnh kèm mục tiêu, ví dụ /impeccable critique the onboarding flow. README khuyên chọn mục tiêu hẹp: một phần của trang được xem kỹ cho kết quả tốt hơn cả trang xem lướt.
Bộ dò chạy được ở ba nơi. Trong agent, design hook quét mọi file giao diện mà agent sửa và trả phát hiện về trước khi agent báo xong; hook có trên Claude Code, Cursor, Codex, GitHub Copilot, Grok Build và Hermes Agent. Trong terminal hoặc CI, lệnh npx impeccable detect quét thư mục hoặc URL mà không cần agent. Trên trình duyệt, tiện ích Chrome hiển thị cùng các phát hiện đó lên trang bất kỳ.
README nói rõ Impeccable mạnh hơn khi làm trên giao diện đã có: trỏ vào một trang hoặc component rồi lặp. Dựng trang mới cũng được nhưng là chế độ khó hơn. Với ứng dụng native, đặt mục Platform trong PRODUCT.md là ios, android hoặc adaptive thì các lệnh thiết kế làm theo Apple HIG hoặc Material 3; bộ dò, live mode và hook chỉnh sửa vẫn chỉ dùng cho web.
Dự án do Paul Bakaus tạo, phát hành theo giấy phép Apache 2.0 và khởi đầu từ skill frontend-design của Anthropic. Ảnh so sánh có và không có Impeccable trong README là ví dụ do tác giả tự dựng, nên xem như minh hoạ chứ chưa phải kết quả đo độc lập.
npx impeccable install/impeccable init/plugin marketplace add pbakaus/impeccablegit submodule add https://github.com/pbakaus/impeccable vendor/impeccable
npx impeccable link --source=vendor/impeccable --providers=claude,cursornpx impeccable updateLệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.
| Mục | Ý nghĩa |
|---|---|
IMPECCABLE_LIVE_COPY_AGENT | Đặt chat để nút Apply của live mode luôn gửi về phiên chat đang mở, hoặc off để tắt Apply. Server đọc biến này một lần khi khởi động live mode. |
DO_NOT_TRACK | Đặt bằng 1 để tắt telemetry ẩn danh. Yêu cầu lấy danh mục hướng thiết kế từ impeccable.style vẫn được gửi. |
Cập nhật bằng npx impeccable update. Nếu cài qua git submodule: chạy git submodule update --remote vendor/impeccable, chạy lại lệnh link rồi commit.
Nên giữ trong repo: PRODUCT.md, DESIGN.md và các file dùng chung trong .impeccable/ gồm config.json, live/config.json, design.json, surfaces/*.md, critique/ignore.md. Phần còn lại trong .impeccable/ là ảnh chụp, cache và trạng thái tạm; README có sẵn đoạn .gitignore để loại ra.
Theo README, 62 luật là luật cố định, chạy không cần LLM và không cần API key. Khi quét file HTML, ảnh nền cục bộ được đọc trực tiếp còn ảnh từ xa không bao giờ được tải về.
Vẫn còn yêu cầu lấy danh mục hướng thiết kế từ impeccable.style mỗi khi bắt đầu một thiết kế mới. Tắt telemetry chỉ dừng bản ghi ẩn danh về hướng nào được hiển thị và hướng nào được chọn. README ghi tên dự án, file, mã nguồn và PRODUCT.md không bao giờ được gửi.
Chạy npx impeccable ignores add-value overused-font Inter --reason "Brand font". Muốn tắt một luật cho riêng một file thì thêm chú thích dạng impeccable-disable trong file đó; lệnh detect --report-unused-ignores chỉ ra các chú thích bỏ qua đã hết tác dụng.
Tải file ZIP cho công cụ của bạn từ impeccable.style hoặc clone repo, rồi chép thư mục skills/impeccable vào đúng thư mục skill của công cụ. Cách chép tay bỏ qua design hook và subagent.
Với Claude Code, README hướng dẫn truyền --settings '{"disableAllHooks": true}' để tắt toàn bộ hook trong lần chạy đó. Nên xem lại các hook đã cài trước khi cho agent chạy không người giám sát.
Tino không phát triển, không sở hữu và không liên kết với Impeccable hay nhóm phát triển pbakaus. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.
Impeccable được phân phối theo giấy phép Apache-2.0 của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.
Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.