close

make-interfaces-feel-better

Mã nguồn mở bởi jakubkrehel

make-interfaces-feel-better là một agent skill của Jakub Krehel, tập trung vào các chi tiết nhỏ khiến giao diện có cảm giác chỉn chu hơn. Skill đưa cho AI coding agent 19 nguyên tắc về animation, typography, icon, bo góc, đổ bóng và vùng bấm để áp dụng khi viết hoặc rà soát mã giao diện.

make-interfaces-feel-better dùng để làm gì?

  • Rà soát mã giao diện theo 19 nguyên tắc và nhận bảng lỗi có mức độ, vị trí file:dòng, mã trước và sau
  • Sửa bo góc lồng nhau theo công thức bán kính ngoài bằng bán kính trong cộng padding
  • Chỉnh animation vào, ra, hiệu ứng nhấn nút và chuyển trạng thái icon theo các giá trị cụ thể
  • Áp các thiết lập chữ như tabular-nums cho số thay đổi liên tục, text-wrap: balance cho tiêu đề
  • Kiểm tra vùng bấm tối thiểu 44×44px trên cảm ứng và 40×40px trên giao diện desktop dày đặc

Giao diện

Ả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.

Cần biết trước khi dùng

  • Lưu ýRepo chưa có bản phát hành (release) chính thức: phiên bản cài đặt là mã mới nhất trên nhánh chính.
  • Lưu ýChỉ có 1 người đóng góp: dự án phụ thuộc vào một người duy trì.
  • Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
  • Lưu ýTino chưa kiểm thử dự án này.

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.

make-interfaces-feel-better là gì?

Skill này không sinh ra thiết kế mới. Nó là một bộ nguyên tắc design engineering để agent đánh bóng giao diện đã có: những chi tiết nhỏ mà từng cái riêng lẻ khó nhận ra nhưng cộng lại quyết định cảm giác của sản phẩm. README của repo rất ngắn; phần nội dung nằm trong file SKILL.md và năm file tham chiếu: typography.md, surfaces.md, animations.md, icons.md, performance.md.

SKILL.md nêu 19 nguyên tắc. Về bề mặt: bo góc đồng tâm, căn chỉnh theo thị giác thay vì hình học, dùng box-shadow nhiều lớp cho độ nổi và giữ border cho cấu trúc, viền 1px độ mờ thấp cho ảnh, vùng bấm tối thiểu. Về chuyển động: dùng CSS transition cho thay đổi trạng thái để có thể ngắt giữa chừng, chia nhỏ và so le animation vào khoảng 100ms, animation ra nhẹ hơn animation vào, scale(0.96) khi nhấn, không chạy animation lúc tải trang, không gắn animation riêng cho thao tác lặp lại liên tục. Về chữ và icon: font smoothing trên macOS, số tabular, text-wrap, nét icon khớp độ đậm của chữ bên cạnh, một SVG dùng currentColor cho mọi trạng thái. Về hiệu năng: không dùng transition: all, dùng will-change có chừng mực.

Trước khi sửa, skill yêu cầu agent nhận diện hệ thống style của dự án và viết bản sửa trong chính hệ thống đó: Tailwind trong dự án Tailwind, CSS thuần trong dự án CSS, không thêm hệ thống thứ hai. Khi rà soát, skill hướng dẫn phát lại chuyển động ở 10% tốc độ trong bảng Animations của trình duyệt và đi qua mọi trạng thái: hover, focus, active, loading, empty.

Kết quả rà soát có định dạng cố định. Có hai chế độ: quick (luồng chính, tối đa 5 phát hiện, chỉ mức HIGH và MEDIUM) và full (toàn bộ phạm vi, tối đa 15 phát hiện, mặc định khi không chỉ định). Báo cáo gồm bảng phạm vi theo năm nhóm, bảng phát hiện, mục các đề xuất đã cân nhắc nhưng loại, phần kiểm chứng và kết luận Block, Needs changes hoặc Approve. Repo theo giấy phép MIT.

Nên dùng khi

  • Giao diện đã chạy được nhưng có cảm giác chưa ổn và bạn muốn agent chỉ ra từng chi tiết cụ thể
  • Bạn muốn một lượt review giao diện có định dạng rõ ràng trước khi gộp PR frontend
  • Bạn cần skill nhẹ, chỉ gồm file Markdown, không kèm script chạy trên máy
  • Bạn làm việc với React, Tailwind hoặc CSS thuần và muốn agent giữ đúng hệ thống style đang dùng

Không nên dùng khi

  • Bạn cần thiết kế từ đầu: skill không cung cấp theme, bố cục, bảng màu hay design system, chỉ đánh bóng chi tiết
  • Bạn cần kiểm tra tự động chạy trong CI: đây là hướng dẫn cho agent, không phải linter, kết quả phụ thuộc vào model và agent đang dùng
  • Đội của bạn đã có quy chuẩn chuyển động riêng: skill đặt sẵn giá trị cứng như scale(0.96) khi nhấn, spring với bounce bằng 0, có thể lệch với design system hiện có
  • Dự án không phải giao diện web: nguyên tắc viết cho CSS, nhiều ví dụ dùng Tailwind, React và thư viện motion hoặc framer-motion
  • Bạn cần soát khả năng truy cập đầy đủ: skill chỉ chạm tới vùng bấm, focus và cảnh báo về chuyển động, không thay cho một lượt kiểm tra theo WCAG

Tính năng chính

  • 19 nguyên tắc cốt lõi trong SKILL.md, kèm bảng lỗi thường gặp và cách sửa
  • Năm file tham chiếu: typography.md, surfaces.md, animations.md, icons.md, performance.md
  • Hai chế độ review: quick (tối đa 5 phát hiện) và full (tối đa 15 phát hiện, mặc định)
  • Bảng phát hiện có cột Severity, Location, Before, After, Why; vị trí ghi theo path/to/file:line
  • Ba mức độ HIGH, MEDIUM, LOW; kết luận Block, Needs changes hoặc Approve
  • Mục Considered but Rejected ghi các đề xuất đã cân nhắc và lý do loại
  • Yêu cầu ghi rõ phần nào chưa kiểm chứng, không ngầm coi phần chưa xem là đã review
  • Giữ nguyên hệ thống style của dự án, không đưa thêm hệ thống thứ hai
  • Giấy phép MIT, có trang trên skills.sh

Cách cài đặt make-interfaces-feel-better

  1. Cài skill Chạy trong thư mục dự án. Lệnh npx cần Node.js và sẽ tải công cụ skills về chạy; README không nêu phiên bản Node.js tối thiểu hay agent nào được hỗ trợ.
    npx skills add jakubkrehel/make-interfaces-feel-better

Lệ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.

Cách tích hợp và sử dụng

  1. Gọi skill bằng lời thườngTheo mô tả trong SKILL.md, skill kích hoạt khi bạn làm component giao diện, review mã frontend hoặc nói kiểu make it feel better, feels off, hay nhắc tới bo góc, đổ bóng, hover, animation.
  2. Chọn chế độ reviewNói rõ quick nếu chỉ cần soát luồng chính với tối đa 5 phát hiện. Không nói gì thì skill dùng full, soát cả năm nhóm với tối đa 15 phát hiện.
  3. Đọc bảng phát hiệnMỗi dòng có mức độ, vị trí file:dòng, mã hiện tại, mã thay thế và nguyên tắc bị vi phạm. Lỗi lặp lại có hệ thống được gom thành một dòng kèm mọi vị trí.
  4. Tự kiểm tra chuyển độngMở bảng Animations trong DevTools của trình duyệt, phát lại ở 10% tốc độ và đi qua các trạng thái hover, focus, active, loading, empty để đối chiếu với báo cáo.

Cập nhật và sao lưu

README không nêu cách cập nhật. Skill chỉ gồm các file Markdown, nên cập nhật là lấy bản mới của các file này, ví dụ chạy lại lệnh cài.

Không có dữ liệu cần sao lưu.

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

Skill này có chạy script hay cài thêm thư viện vào dự án không?

Thư mục skill chỉ có SKILL.md và các file Markdown tham chiếu. Skill cũng dặn agent không thêm thư viện motion nếu dự án chưa có: khi đó dùng CSS transition thay thế.

Dự án không dùng Tailwind thì có áp dụng được không?

Được. Skill yêu cầu agent viết bản sửa theo hệ thống style sẵn có của dự án, gồm CSS thuần hoặc CSS-in-JS. Ví dụ trong SKILL.md có cả phiên bản Tailwind và CSS thuần.

Vì sao skill cấm transition: all?

SKILL.md yêu cầu luôn chỉ rõ thuộc tính cần chuyển, ví dụ transition-property: scale, opacity, thay vì để mọi thuộc tính cùng chuyển. Phần giải thích chi tiết nằm trong performance.md.

Khi nào kết quả review là Block?

Khi còn ít nhất một phát hiện mức HIGH, tức lỗi khiến một tương tác không dùng được, gây hiểu sai, khó đọc hoặc gây phiền lặp lại. Chỉ còn MEDIUM hoặc LOW thì kết luận là Needs changes.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với make-interfaces-feel-better hay nhóm phát triển jakubkrehel. 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.

make-interfaces-feel-better được phân phối theo giấy phép MIT 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.