Oil UI
Hướng dẫn Agent · Claude Code

Thiết kế UI với Claude Code: Cài đặt Oil UI, Prompt & Review trực quan

Claude Code rất mạnh trong việc đọc cấu trúc repository, chia nhỏ công việc nhiều bước và khởi tạo subagent. Tuy nhiên, nếu thiếu định hướng thiết kế, những prompt như "tạo một landing page hiện đại" vẫn dễ tạo ra dải chuyển màu tím, thẻ lồng nhau và các huy hiệu KPI tự bịa. Cài đặt Oil UI giúp Claude Code có một quy trình thiết kế bài bản: nghiên cứu đúng danh mục sản phẩm, đặt các hướng thị giác khác biệt cạnh nhau để so sánh và kiểm tra trang đã render trên các viewport thực tế.

Điểm chính

Điểm chính 1

Chạy npx skills add oil-oil/oil-ui để cài đặt skill mã nguồn mở miễn phí vào Claude Code mà không khóa dự án vào một thư viện component cố định nào.

Điểm chính 2

Mở đầu prompt bằng sản phẩm, đối tượng người dùng, tác vụ cốt lõi, nội dung thật và viewport mục tiêu (như 1440×900 hoặc 390×844) thay vì các tính từ phong cách mơ hồ.

Điểm chính 3

Với trang mới hoặc làm lại giao diện, hãy yêu cầu Claude Code tạo bảng so sánh HTML đặt cạnh nhau gồm 3 đến 4 hướng thiết kế khác biệt trước khi viết các trạng thái production.

Điểm chính 4

Dùng subagent của Claude Code để chạy blind review trực quan không ngữ cảnh ở mức 100% và 200%, giúp sửa các lỗi giãn cách, độ tương phản và phân cấp trước khi bàn giao.

Oil UIPROBảo tàng Thanh Nhai · Ánh sáng & Đồ gốm

Giúp khách tham quan xem lịch triển lãm, phòng trưng bày và hiện vật của Ánh sáng & Đồ gốm rồi đặt lịch.

Đồ gốm men ngọc bên hồ lúc hoàng hôn
BẢO TÀNG THANH NHAITRIỂN LÃM MÙA THU

Ánh sáng
& Đồ gốm.

2026.11.14 — 2027.02.28Phòng 02
Đã chọnNhấp để xem riêng · kích thước thật
01

Chạng vạng trên mặt nước

Để ánh chiều phủ kín khung hình. Giữ hiện vật ở gần và tiêu đề serif ở một góc tĩnh lặng.

Bảo tàng Thanh NhaiÁnh sáng & Đồ gốm · Mùa thu

NHẬT KÝÁNH SÁNG

Gốm men ngọc và vải lanh dưới ánh nắng lọc qua rặng liễu

Nắng trên mặt nước.
Nắng trên đất gốm.

Một triển lãm về đồ vật thường ngày và ánh sáng tự nhiên.

11.14 — 02.28Phòng 02
Đã chọnNhấp để xem riêng · kích thước thật
02

Nhật ký buổi sáng

Mở một tập san triển lãm: lưới báo gom nắng mai, đồ gốm và thông tin tham quan.

Bảo tàng Thanh Nhai

Sương sớm.
Ánh sáng êm.

Bộ trà men ngọc bên khung cửa phủ sương
11.14 — 02.28Phòng 02
Đã chọnNhấp để xem riêng · kích thước thật
03

Khung cửa sương mờ

Đặt bức tranh vào một khung cửa giấy mở rộng để gốm men ngọc và mặt nước nhạt có khoảng thở.

Cài đặt Oil UI Skill mã nguồn mở miễn phí cho Claude Code
npx skills add oil-oil/oil-ui

Hoặc gửi trực tiếp cho Claude Code: "Hãy cài đặt skill này giúp tôi: chạy npx skills add oil-oil/oil-ui".

Vì sao Claude Code cần một Skill thiết kế chuyên biệt

Khi bạn yêu cầu Claude Code làm một "giao diện SaaS sạch sẽ, hiện đại" mà không có phương pháp đi kèm, model sẽ rơi về giá trị trung bình thống kê từ dữ liệu huấn luyện: một tiêu đề căn giữa kèm nhãn pill phía trên, ba thẻ rộng bằng nhau ở dưới, cùng biểu đồ sparkline trang trí hoặc bộ đếm "+24%" ở góc. Mã nguồn biên dịch bình thường, nhưng giao diện trông giống hệt mọi bản demo AI khác.

Oil UI thay đổi trình tự làm việc đó. Thay vì nhảy thẳng từ prompt sang mã HTML/CSS cuối cùng, Claude Code sẽ nghiên cứu điều gì giúp danh mục sản phẩm dễ hiểu, đưa các hướng thị giác khác biệt lên cùng một bảng so sánh và kiểm tra kết quả render trên trình duyệt thật trước khi chốt hoàn thành.

Prompt một lần so với Claude Code dùng Oil UI Skill
Giai đoạnPrompt một lần trong Claude CodeQuy trình Claude Code + Oil UI
Điểm xuất phátMặc định rơi về lưới thẻ SaaS rập khuôn và bảng màu an toànBắt đầu từ danh mục sản phẩm, tác vụ người dùng và nội dung thật
Chọn hướng thiết kếChỉ ra một phương án; lệch ý phải prompt lại từ đầuTích hợp trang so sánh đặt cạnh nhau ở 1440px hoặc 390px
Dữ liệu & nội dungThường tự bịa phần trăm và nhãn lấp chỗXây dựng phân cấp quanh trường dữ liệu chuyên ngành thật và lược bỏ chi tiết thừa
Kiểm tra chất lượngDừng lại ngay khi mã biên dịch xongKhởi tạo subagent blind review để soi toàn trang và ảnh cắt phóng đại 200%

Thiết lập trong ba bước

Bạn có thể cài Oil UI ở mức toàn cục cho tài khoản người dùng hoặc cài cục bộ trong repository để cả nhóm dùng chung một quy trình.

  1. Chạy trình cài đặt skill và chọn Claude Code

    Chạy lệnh bên dưới trong terminal và làm theo hướng dẫn tương tác để chọn Claude Code cùng phạm vi cài đặt mong muốn.

    npx skills add oil-oil/oil-ui
  2. Đảm bảo trình duyệt cục bộ có thể render và chụp trang

    Việc review trực quan cần ảnh chụp màn hình thật chứ không đoán qua mã nguồn. Hãy chắc chắn Playwright hoặc công cụ tự động hóa trình duyệt trên máy mở được dev server ở kích thước 1440×900 (desktop) và 390×844 (di động).

  3. Nâng cấp lên Oil UI Pro khi cần trọn bộ quy trình

    Nếu bạn đã mua Oil UI Pro, hãy cài đặt qua CLI. Khi đã cài Pro, bạn không cần giữ thêm bản mã nguồn mở song song.

    npx github:oil-oil/oil-cli install oil-ui-pro

Cách viết UI Prompt giàu tín hiệu cho Claude Code

Hãy xem các tác phẩm dựng bằng Claude trong thư viện — như Margins (trình đọc sách máy tính bảng bởi Claude Opus 5.5), Echo (trợ lý giọng nói bởi Claude Opus 5.5), Pickup (ứng dụng gọi xe bởi Claude Sonnet 5.5) và Pinch Checkout (module thanh toán bởi Claude Sonnet 5.5). Mỗi prompt đều nêu rõ người dùng là ai, tương tác nào giữ vai trò trung tâm và những trạng thái nào bắt buộc phải chạy được.

Nêu rõ người dùng và tác vụ bằng ngôn ngữ trực diện
Thay vì yêu cầu một "ứng dụng di chuyển mượt mà", hãy chỉ rõ "luồng gọi xe 390×844 gồm xác nhận ghim điểm đón, theo dõi tài xế đang tới trực tiếp và đổi điểm đến giữa chuyến".
Chỉ tên tương tác trọng tâm
Cho Claude Code biết điều khiển hoặc chuyển đổi nào quan trọng nhất: tính lại giá trực tiếp khi áp mã giảm giá, ngăn ghi chú trong trình đọc bài dài hay phản hồi dạng sóng âm ở trợ lý giọng nói.
Xác định viewport và các trạng thái cụ thể
Liệt kê đúng kích thước viewport và ba hoặc bốn trạng thái bạn muốn render để agent kiểm tra từng trạng thái trên trình duyệt thật.
Mẫu UI prompt tái sử dụng cho Claude Code
Dùng Oil UI để thiết kế giao diện cho [loại sản phẩm, ví dụ: module thanh toán cho hiệu sách độc lập].
- Đối tượng & tác vụ chính: [ví dụ: độc giả xem lại giỏ hàng, chuyển đổi giữa nhận tại cửa hàng và giao tận nơi, áp dụng mã giảm giá và hoàn tất thanh toán]
- Tương tác trọng tâm & trạng thái: Tập trung vào [tương tác chính]. Bao phủ [Trạng thái 1: biểu mẫu mặc định], [Trạng thái 2: tính lại phí giao hàng và giảm giá trực tiếp], và [Trạng thái 3: báo lỗi kiểm tra thẻ tại chỗ và khôi phục].
- Ràng buộc: Giữ nguyên tech stack hiện tại. Nhắm tới 1440×900 trên desktop và responsive xuống chiều rộng 390px.
Hãy đề xuất các hướng thiết kế khác biệt trước để chúng tôi so sánh trước khi tinh chỉnh hướng đã chọn.

Thay phần trong ngoặc vuông bằng thông tin thực tế của dự án và dán vào Claude Code.

Chạy Blind Review bằng Subagent trên ảnh chụp thực tế

Một agent vừa viết xong 600 dòng CSS hiếm khi tự nhận ra hai nhãn chữ đang đè lên nhau hay chữ phụ bị thiếu tương phản. Oil UI giải quyết điều này bằng cách để agent chính chụp ảnh màn hình trang đang chạy và chuyển cho một subagent Claude Code hoàn toàn mới, không biết gì về quá trình triển khai.

Subagent đánh giá sẽ kiểm tra ảnh toàn trang ở mức 100%, ảnh cắt 200% tại các cụm điều khiển dày đặc và ảnh làm mờ khối bố cục nhằm lộ ra các bố cục nặng đầu hoặc đơn điệu. Agent chính sẽ sửa các lỗi được báo cáo trước khi bàn giao kết quả cho bạn.

Ví dụ thực tế & prompt trong thư viện

Xem bộ sưu tập →
Oil UI Pro

Khi nào nên chuyển từ bản miễn phí sang Oil UI Pro

Skill miễn phí đưa một trang hoàn toàn mới từ khung trống đến một thiết kế sắc nét. Hãy nâng cấp lên Oil UI Pro ($19.99 mua một lần) khi bạn dùng Claude Code để cải tạo ứng dụng production sẵn có, xây dựng workspace desktop mật độ cao hoặc chạy tùy chọn tinh chỉnh sâu blind review tối đa 3 vòng kèm kiểm thử tác vụ đếm lượt bấm.

Khám phá Oil UI Pro →
Sao chép prompt cài đặt Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Câu hỏi thường gặp

Oil UI có khóa Claude Code vào React, Tailwind hay thư viện UI cụ thể nào không?

Không. Oil UI cung cấp phương pháp thiết kế, tư duy bố cục và các bước kiểm tra trực quan. Claude Code vẫn viết mã và giao diện theo đúng stack hiện có của bạn, dù là Next.js, Vue, Svelte, HTML/CSS thuần hay design system nội bộ.

Claude Opus và Claude Sonnet khác nhau thế nào khi dùng Oil UI?

Opus thường đưa ra quyết định chắc tay hơn về tỷ lệ chữ, nhịp trang và phân cấp biên tập trên toàn trang. Sonnet nhanh hơn và rất hợp để làm các module tập trung, hoàn thiện trạng thái và mở rộng một hướng thiết kế đã chốt.

Tôi có thể đưa cho Claude Code một ảnh chụp tham chiếu để bám theo hoặc biến tấu không?

Có. Hãy truyền đường dẫn ảnh và nói rõ bạn muốn tái tạo sát từng pixel (pixel-diff) hay chỉ mượn tinh thần typography và khoảng thở cho nội dung sản phẩm của mình. Oil UI có quy trình riêng cho cả hai cách.

Làm sao biết Claude Code đang thực sự áp dụng Oil UI?

Hãy đưa cụm "Use Oil UI" (hoặc "Dùng Oil UI") vào prompt. Thay vì đổ ngay mã mẫu chưa chỉnh trang, Claude Code sẽ định khung tác vụ người dùng, đề xuất các hướng thị giác khác biệt hoặc mở bảng so sánh, rồi kiểm tra ảnh chụp màn hình trước khi kết thúc.

Hướng dẫn liên quan

Hướng dẫn thiết kế UI trên Codex ↗So sánh hướng thiết kế song song ↗Blind Review màn hình thật ↗