jakubkrehel/skills: bộ skill giúp agent làm giao diện đẹp hơn — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về jakubkrehel/skills — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: jakubkrehel/skills: bộ skill giúp agent làm giao diện đẹp hơn — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
jakubkrehel/skills là bộ skill (chỉ dẫn dạng Markdown) cho agent lập trình AI, giúp xây dựng và rà soát giao diện về typography, màu sắc, bố cục, trợ năng, chuyển động và câu chữ. README chỉ cần một lệnh cài là npx skills add jakubkrehel/skills, nên cài khá dễ. Repo dùng giấy phép MIT và hiện có khoảng 12.000 sao.
jakubkrehel/skills là một bộ skill dành cho agent lập trình AI, tập trung vào việc làm giao diện (UI) cho tốt. Skill ở đây là các file chỉ dẫn bằng Markdown. Agent đọc chúng để biết cần kiểm tra gì và làm theo chuẩn nào khi bạn nhờ làm hoặc rà soát một màn hình. Repo gồm nhiều skill nhỏ, mỗi skill lo một mảng: chữ, màu, bố cục, trợ năng (accessibility), chuyển động, câu chữ trên giao diện.
Bạn nên xem repo này nếu bạn là lập trình viên mới hoặc người làm sản phẩm, đang nhờ AI viết giao diện nhưng kết quả cứ "chạy được mà trông không đẹp". Bạn không cần là designer. Bạn chỉ cần nhờ agent "rà giao diện này" và nhận lại một danh sách vấn đề đã xếp thứ tự ưu tiên. Tác giả cũng viết các skill này dựa trên những chủ đề ông ấy chia sẻ trên website cá nhân và tạp chí về design engineering của mình.
Điểm đáng giá nhất là sự đầy đủ và tính chia nhỏ. Có một skill tổng hợp (better-interface) quét cả sáu mảng rồi trả một báo cáo xếp hạng. Bạn cũng có thể dùng riêng từng skill khi chỉ cần chỉnh màu hay chỉnh chữ. Repo hiện có khoảng 12.000 sao và 468 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.
jakubkrehel/skills
Bộ 14 skill cho agent AI giúp rà soát và làm giao diện tốt hơn: chữ, màu, bố cục, trợ năng, nội dung chữ trên giao diện, chuyển động.
I.Bộ skill này làm được gì
Repo có 14 skill. Mình chia thành ba nhóm cho dễ nhớ.
A.Nhóm nâng chất lượng giao diện
- better-interfacerà một màn hình, một luồng hoặc cả giao diện qua sáu mảng (trợ năng, bố cục, câu chữ, typography, màu sắc, độ hoàn thiện UI) rồi trả về một báo cáo duy nhất đã xếp hạng. Bạn không phải đọc sáu báo cáo rời rạc.
- better-uichỉnh bề mặt, icon và chuyển động với giá trị cụ thể cho bo góc, căn chỉnh theo mắt nhìn, đổ bóng, trạng thái icon và animation. Hữu ích khi giao diện "hơi lệch" mà bạn không biết lệch ở đâu.
- better-typographylo cách chữ hiển thị, từ thang cỡ chữ và khoảng cách đến tính năng font, ngắt dòng, cắt chữ và dấu câu.
- better-colorstạo và kiểm tra hệ màu. Skill tạo bảng màu, đặt tên token theo ngữ nghĩa, chuyển đổi giữa các định dạng màu và đo độ tương phản.
- better-accessibilityrà và sửa phần bàn phím, focus, ARIA, tên truy cập, form, thông báo cho trình đọc màn hình, chuyển động và phóng to, theo WCAG 2.2.
- better-layoutlo nhóm nội dung, căn hàng, thứ tự đọc, cấu trúc responsive và chỗ trống cho chữ khi dịch sang ngôn ngữ khác. Layout nhờ vậy vẫn ổn khi đổi cỡ, dịch hoặc đảo chiều.
- better-writingviết và rà câu chữ trên giao diện (nhãn, thông báo lỗi, trạng thái trống, hộp xác nhận) để đúng giọng sản phẩm và chỉ người dùng việc cần làm tiếp theo.
B.Nhóm dựng giao diện
- build-designdựng UI từ file Figma hoặc ảnh thiết kế sao cho khớp bản thiết kế, dùng token và component sẵn có của dự án.
- variantdựng nhiều biến thể của một component để bạn so sánh và chọn. Skill này do bạn chủ động gọi.
- state-machinevẽ mọi trạng thái của một component trên một trang tạm, kèm dữ liệu giả và công tắc chuyển trạng thái, để bạn làm từng trạng thái một. Cũng do bạn chủ động gọi.
- breakhiển thị component bạn chọn trong mọi tình huống có thể xảy ra, trên một trang tạm, để thử độ bền. Do bạn chủ động gọi.
C.Nhóm rà soát và học hỏi
- interface-reviewrà một nhánh (branch), pull request hoặc thay đổi chưa commit, tìm các lỗi giao diện mới phát sinh hoặc bị thụt lùi. Rất hợp để chặn lỗi trước khi gộp code.
- explain-interfacegiải thích một website, hiệu ứng hay animation được làm thế nào, từ một URL đang chạy hoặc một ảnh chụp màn hình.
- afklàm việc qua dự án trong lúc bạn vắng mặt, tìm chỗ cần cải thiện, thử ý tưởng mới và để lại báo cáo cho bạn xem khi quay lại.
II.Cần chuẩn bị gì
README rất ngắn và không liệt kê yêu cầu hệ thống. Những gì suy ra được từ tư liệu:
- Máy có Node.js để dùng được lệnh
npx. README không ghi phiên bản Node cụ thể. - Một agent lập trình AI để dùng các skill. Repo có thư mục
.claude-plugin/và các fileCLAUDE.md,AGENTS.md,opencode.json, nên rõ ràng nhắm tới Claude Code và các agent tương tự. README không liệt kê chi tiết agent nào được hỗ trợ. - Một dự án giao diện (web) để agent làm việc cùng, nếu bạn muốn dùng các skill rà soát hay dựng UI.
- Skill build-design nhắc tới Figma file hoặc ảnh thiết kế, nên bạn cần có đầu vào đó khi dùng skill này.
Tư liệu không nói gì về API key, tài khoản riêng hay phần cứng cho riêng repo này. Bạn dùng agent nào thì áp dụng điều kiện của agent đó (tài khoản, chi phí).
III.Cài đặt từng bước
- Mở terminalVào đúng thư mục dự án giao diện của bạn
- Chạy lệnh càiDùng npx skills add để thêm bộ skill
- Mở lại agentKhởi động agent trong dự án để nó nạp skill
- Thử một skillNhờ agent rà một màn hình bằng better-interface
A.Mở terminal đúng thư mục
Mở terminal (PowerShell hoặc Terminal trên máy bạn) và đi vào thư mục dự án mà bạn muốn agent làm việc. Người mới hay vấp ở bước này: mở terminal ở thư mục khác thì skill có thể được thêm sai chỗ. README không nói rõ skill được thêm vào đâu, nên bạn cứ đứng trong dự án của mình cho chắc.
cd ten-thu-muc-du-an-cua-banHãy thay ten-thu-muc-du-an-cua-ban bằng tên thư mục thật của bạn.
B.Chạy lệnh cài
Đây là lệnh duy nhất README ghi trong phần cài đặt:
npx skills add jakubkrehel/skillsnpx tải và chạy công cụ skills, còn jakubkrehel/skills là địa chỉ repo trên GitHub (tên người dùng/tên repo). Lần đầu chạy, npx có thể hỏi bạn có đồng ý tải công cụ về không. Nếu terminal hỏi chọn agent hay chọn skill, bạn làm theo hướng dẫn trên màn hình. README không mô tả các câu hỏi này, nên mình không dám nói chắc chúng gồm những gì.
Skill là chỉ dẫn mà agent sẽ làm theo trong dự án của bạn. Trước khi cài, bạn nên mở thư mục skills/ của repo trên GitHub và đọc qua nội dung. Repo dùng giấy phép MIT, mã nguồn mở nên đọc được hết.
C.Khởi động lại agent
Sau khi cài, hãy mở lại agent (ví dụ Claude Code) trong cùng thư mục dự án. README không nói cần khởi động lại hay không, nhưng làm vậy là cách an toàn để agent nạp skill mới. Nếu bạn muốn xem file cấu hình Claude Code của repo, nó nằm trong thư mục .claude-plugin/.
D.Thử ngay một skill
Nhờ agent bằng tiếng thường, nhắc tên skill. Ví dụ:
Dùng skill better-interface rà màn hình đăng nhập của dự án này.Cách gọi chính xác (gõ lệnh hay chỉ nói tên) có thể khác nhau tùy agent. README chỉ ghi một số skill là "User-invoked", tức là bạn phải chủ động gọi chúng. Nếu cần chi tiết, xem file AGENTS.md hoặc CLAUDE.md trong repo, và trang chủ dự án https://jakub.kr/skills.
IV.Kiểm tra đã chạy được chưa
README không đưa ra thông báo "cài thành công" cụ thể. Cách thực tế để kiểm tra:
- Lệnh
npx skills add jakubkrehel/skillskết thúc mà không báo lỗi. - Bạn mở agent và hỏi nó có những skill nào. Danh sách nên có các tên như better-interface, better-ui, better-colors.
- Bạn nhờ agent rà một màn hình đơn giản bằng better-interface. Nếu nó trả về một báo cáo chia theo các mảng như trợ năng, bố cục, câu chữ, chữ, màu, UI và xếp theo mức ưu tiên thì skill đã hoạt động, đúng như README mô tả.
Nếu agent trả lời chung chung mà không nhắc gì tới các mảng trên, hãy nói rõ tên skill trong câu lệnh hoặc xem lại bước cài.
V.Dùng vào việc thật
A.Chủ shop nhỏ có trang bán hàng làm bằng AI
Bạn nhờ AI dựng trang bán hàng và nhìn thì được, nhưng bạn cảm thấy thiếu chuyên nghiệp mà không biết sửa gì. Bạn nhờ agent chạy better-interface lên trang đó.
Dùng better-interface rà trang chi tiết sản phẩm. Cho mình danh sách vấn đề xếp theo mức quan trọng, sửa những lỗi nghiêm trọng nhất trước.Bạn nhận về một báo cáo xếp hạng, gộp từ cả sáu mảng. Bạn không phải học thuật ngữ thiết kế. Bạn chỉ cần duyệt từng mục và cho agent sửa.
Giao diện đẹp phần lớn là chuyện của hàng chục chi tiết nhỏ, và agent giờ có sẵn danh sách để kiểm từng chi tiết.
Ông T
B.Nhân viên văn phòng kiểm tra bảng màu thương hiệu
Công ty bạn có bộ màu thương hiệu và bạn cần đưa vào một công cụ nội bộ. Bạn nhờ better-colors tạo bảng màu từ màu chủ đạo, đặt tên token theo ngữ nghĩa (ví dụ màu cho thành công, cảnh báo, lỗi) và đo độ tương phản giữa chữ và nền.
Dùng better-colors: từ màu chủ đạo này, tạo bảng màu, đặt tên token theo ngữ nghĩa và kiểm tra độ tương phản chữ trên nền.Kết quả là một hệ màu có tên rõ ràng, kèm số đo tương phản để biết cặp nào khó đọc.
C.Lập trình viên mới trước khi gửi pull request
Bạn vừa sửa một form và muốn chắc là mình không làm hỏng trợ năng hay bố cục. Bạn dùng interface-review trên nhánh hiện tại.
Dùng interface-review kiểm tra các thay đổi chưa commit của mình xem có gây lỗi giao diện nào không.Skill xem các thay đổi và chỉ ra vấn đề giao diện mới phát sinh hoặc bị thụt lùi. Bạn sửa trước khi nhờ người khác review, đỡ mất thời gian cả hai bên.
D.Dev muốn học cách một hiệu ứng được làm ra
Bạn thấy một trang web có animation đẹp và muốn làm tương tự. Bạn đưa URL hoặc ảnh chụp màn hình cho skill explain-interface.
Dùng explain-interface giải thích hiệu ứng ở trang này được dựng thế nào: (dán URL hoặc ảnh chụp màn hình)Bạn nhận lời giải thích về cách trang đó được dựng, tiện để học hoặc tái hiện trong dự án của mình.
VI.Lỗi hay gặp và cách xử lý
Báo lỗi npx không nhận ra lệnh. Máy bạn chưa có Node.js, hoặc terminal chưa nhận. Cài Node.js từ trang chính thức, mở terminal mới rồi chạy lại lệnh cài. README không ghi phiên bản Node yêu cầu, nên nếu vẫn lỗi hãy xem trang chủ dự án hoặc các file trong repo.
Cài xong mà agent không thấy skill. Thử đóng agent và mở lại trong đúng thư mục dự án. Nếu vẫn không thấy, chạy lại lệnh cài từ thư mục dự án (không phải thư mục khác) và đọc kỹ thông báo của terminal.
Chạy trong thư mục sai. Đây là lỗi người mới hay gặp nhất. Hãy kiểm tra terminal đang đứng ở đâu trước khi chạy npx. Nếu đã cài nhầm chỗ, hãy xem kỹ cách gỡ trong tài liệu của công cụ skills thay vì xóa file lung tung. Mình chưa có thông tin về lệnh gỡ trong README.
Skill "User-invoked" không tự chạy. Các skill như break, variant, state-machine, interface-review, explain-interface và afk được đánh dấu là do người dùng chủ động gọi. Bạn cần nói rõ tên skill trong yêu cầu thì agent mới dùng.
Báo cáo quá dài, không biết bắt đầu từ đâu. better-interface trả một báo cáo xếp hạng. Hãy nhờ agent chỉ sửa các mục ở mức quan trọng cao nhất trước, rồi chạy lại để kiểm tra. Làm từng đợt nhỏ sẽ an toàn hơn là sửa hàng loạt trong một lần.
VII.Có nên dùng không
Điểm mạnh. Bộ skill phủ gần hết những thứ làm nên giao diện tốt, mỗi mảng một skill riêng nên bạn chọn đúng cái cần. Cài chỉ một lệnh, mã nguồn mở (MIT), được nhiều người quan tâm (khoảng 12.000 sao) và vẫn được cập nhật. Phần rà soát cho bạn một danh sách cụ thể, thay vì lời khuyên chung chung kiểu "làm cho đẹp hơn".
Giới hạn. Đây là các file chỉ dẫn cho agent, không phải phần mềm có giao diện riêng. Chất lượng kết quả phụ thuộc vào agent bạn dùng. README ngắn, không nêu phiên bản Node, danh sách agent được hỗ trợ hay cách gỡ cài. Mình cũng chưa có thông tin về việc skill hoạt động tốt thế nào với từng framework cụ thể. Phần lớn nội dung bằng tiếng Anh, nên nếu giao diện của bạn bằng tiếng Việt, nhất là phần better-writing, bạn nên tự kiểm tra lại giọng văn.
Khi nào nên chọn cách khác. Nếu bạn cần một designer thật để làm nhận diện thương hiệu, hoặc cần kiểm thử trợ năng chính thức với người dùng thật, skill chỉ hỗ trợ chứ không thay thế được. Nếu bạn chỉ cần một công cụ đo tương phản màu nhanh, một công cụ đơn lẻ có thể gọn hơn. Còn nếu bạn đã dùng agent AI để viết giao diện hàng ngày, bộ skill này là cách nhẹ nhàng để nâng chất lượng mà không phải học thêm nhiều thứ.
Câu hỏi thường gặp
jakubkrehel/skills có miễn phí không?
Repo dùng giấy phép MIT, nên mã nguồn mở và dùng tự do. Tư liệu không nói gì về phí riêng của repo. Nếu bạn dùng agent AI có tính phí thì chi phí đó thuộc về agent bạn chọn.
Cài bộ skill này bằng lệnh nào?
README ghi một lệnh duy nhất: npx skills add jakubkrehel/skills. Bạn chạy lệnh này trong terminal, tốt nhất là đứng trong thư mục dự án của mình. README không giải thích thêm về các câu hỏi mà công cụ có thể hiện ra khi cài.
Có cần GPU hay máy mạnh không?
Tư liệu không nhắc tới GPU hay phần cứng. Skill là các file chỉ dẫn bằng Markdown, nên bản thân chúng không nặng. Phần xử lý do agent AI mà bạn dùng đảm nhận.
Chạy được trên Windows không?
README không nêu hệ điều hành. Lệnh cài dùng npx nên cần có Node.js trên máy. Chưa có thông tin chính thức về việc hỗ trợ Windows, bạn nên thử và xem trang chủ dự án nếu gặp vấn đề.
Dùng với agent nào?
Repo có thư mục .claude-plugin cùng các file CLAUDE.md, AGENTS.md và opencode.json, cho thấy nó nhắm tới Claude Code và các agent tương tự. README không có danh sách agent được hỗ trợ đầy đủ.
Bộ skill này khác gì việc tự nhờ AI làm giao diện đẹp hơn?
Skill cho agent một bộ tiêu chí cụ thể về chữ, màu, bố cục, trợ năng, chuyển động và câu chữ, nên kết quả có hệ thống hơn lời nhờ chung chung. Skill better-interface còn gộp các mảng đó thành một báo cáo xếp hạng. Tư liệu không có so sánh với công cụ cụ thể nào khác.
Dữ liệu của mình có an toàn không?
Tư liệu không nói về xử lý dữ liệu. Skill chỉ là chỉ dẫn, còn dữ liệu và mã của bạn do agent AI bạn dùng xử lý. Bạn nên xem chính sách của agent đó, và đọc nội dung thư mục skills trước khi cài.


