humanlayer/skills: bộ skill Claude Code cho nghiên cứu, PR và CLAUDE.md — hướng dẫn cài và dùng

Tóm tắt nhanh
humanlayer/skills là bộ skill cho Claude Code do HumanLayer viết, gồm 7 skill như rpi, show-me, visual-pr, improve-claude-md. Bạn cài từng skill bằng một lệnh npx, rồi gọi bằng dấu gạch chéo trong Claude Code. Cài đặt khá đơn giản nếu máy đã có Node và Claude Code.
humanlayer/skills là một kho skill (kỹ năng mở rộng) cho Claude Code, do đội HumanLayer viết và để giấy phép MIT. Mỗi skill là một "công thức làm việc" đóng gói sẵn. Bạn cài một lệnh, rồi gõ /tên-skill trong Claude Code là AI làm theo quy trình đó. Repo hiện có khoảng 5.763 sao và 205 fork, và vẫn được cập nhật trong 3 tháng gần đây.
Vấn đề nó giải quyết rất quen thuộc. Bạn giao một việc lớn cho AI, nó lao vào sửa code ngay, không hiểu hệ thống, không hỏi lại bạn, và cuối cùng bạn phải đọc một đống thay đổi khó hiểu. Các skill ở đây ép AI đi theo từng pha: tìm hiểu trước, bàn phương án với bạn, rồi mới làm. Nó cũng có skill giúp người review hiểu pull request nhanh hơn.
Người nên dùng là lập trình viên (kể cả người mới) đang dùng Claude Code hằng ngày, và những ai quản lý một dự án có file CLAUDE.md. Điểm đáng giá nhất là skill rpi: nó biến "nhờ AI sửa code" thành một quy trình có tài liệu ghi lại từng bước, nên bạn kiểm soát được thay vì phó mặc.
humanlayer/skills
Bộ skill Claude Code của HumanLayer: nghiên cứu rồi code theo tài liệu (rpi), giải thích bằng sơ đồ, tạo PR trực quan, viết lại CLAUDE.md.
I.Bộ skill này làm được gì
Repo hiện có 7 skill. Mỗi skill cài riêng, bạn chỉ lấy cái mình cần.
A.rpi: nghiên cứu, thiết kế, rồi mới làm
Skill này nghiên cứu một thay đổi, cùng bạn cân nhắc các lựa chọn thiết kế, rồi triển khai dựa trên các tài liệu lưu trong máy. Bạn chọn được cách đi: thảo luận thiết kế, viết PRD (tài liệu yêu cầu) rồi làm theo TDD (viết kiểm thử trước), thiết kế kỹ thuật, hoặc nghiên cứu xong thì triển khai. Mỗi pha mặc định chạy trong một phiên mới, nên AI không bị "rối" vì ngữ cảnh quá dài.
B.show-me: giải thích bằng hình
Giải thích chủ đề đang bàn bằng sơ đồ gọn, bản phác "hình dạng" của code và các trang HTML tập trung. Hữu ích khi bạn đọc một đoạn code lạ và muốn nhìn tổng thể thay vì đọc chữ dài.
C.visual-pr: pull request có phần phác thảo trực quan
Tạo hoặc cập nhật pull request kèm một phần phác thảo hình ảnh ngắn gọn, giúp người review hiểu thay đổi mà không phải đọc từng dòng.
D.improve-claude-md: viết lại CLAUDE.md
Viết lại file CLAUDE.md của bạn bằng các khối <important if> để AI tuân thủ chỉ dẫn tốt hơn. Nếu bạn thấy Claude hay "quên" quy tắc dự án, đây là skill đáng thử.
E.narrow-react-prop-types: thu hẹp kiểu prop React
Thu hẹp kiểu dữ liệu prop của component React cho khớp với các luồng chạy thật, thay vì các trạng thái chỉ có trong Storybook, test hay mock.
F.build-iterated-agentic-loop: vòng lặp agent trên GitHub Actions
Dựng một skill nằm trong repo của bạn, cộng với workflow GitHub Actions chạy agent lập trình lặp đi lặp lại, kèm prompt, file ghi nhớ và các mẫu tham khảo.
G.design-control-loop: thiết kế vòng điều khiển cho agent
Phỏng vấn bạn để thiết kế một vòng điều khiển cho agent (gồm cảm biến, bộ điều khiển, cơ cấu thực thi và các yếu tố gây nhiễu) phù hợp với codebase của bạn. Sau đó nó dựng thành các thành phần chạy được trên máy, kèm workflow chạy theo lịch. Hai skill cuối này khá nâng cao, người mới nên làm quen với rpi trước.
II.Cần chuẩn bị gì
README không liệt kê yêu cầu hệ thống riêng. Từ những gì README viết, bạn cần:
- Claude Codecác skill được gọi bằng
/tên-skilltrong Claude Code. README cũng nhắc Codex, nơi bạn dùng$rpithay cho/rpi. - Node.jslệnh cài dùng
npx, nên máy phải có Node (npx đi kèm Node). README không ghi phiên bản Node tối thiểu. - Một dự án đang làm việcnhiều skill chạy "trong dự án của bạn", nên hãy mở terminal tại thư mục dự án.
README không nhắc tới API key hay phần cứng riêng cho repo này. Tuy nhiên bạn vẫn cần tài khoản dùng được Claude Code (hoặc Codex) như bình thường.
III.Cài đặt từng bước
- Mở terminalVào đúng thư mục dự án của bạn
- Chọn skillQuyết định cài skill nào, ví dụ rpi
- Chạy lệnh càiDùng npx skills add với tên skill
- Gọi skillGõ /rpi (hoặc $rpi trong Codex) kèm yêu cầu
A.Mở terminal tại thư mục dự án
Với Windows, bạn có thể mở PowerShell rồi dùng cd để vào thư mục dự án. Người mới hay vấp ở đây: nếu mở terminal sai thư mục, bạn sẽ cài hoặc chạy nhầm chỗ. Ví dụ:
cd D:\duong-dan\du-an-cua-banĐường dẫn trên chỉ là ví dụ, bạn thay bằng đường dẫn thật của mình.
B.Cài skill bạn muốn
Cú pháp chung trong README là:
npx skills add humanlayer/skills --skill SKILLNAMEBạn thay SKILLNAME bằng tên skill. Ví dụ cài skill rpi:
npx skills add humanlayer/skills --skill rpiCác skill còn lại cài theo đúng kiểu đó:
npx skills add humanlayer/skills --skill show-me
npx skills add humanlayer/skills --skill visual-pr
npx skills add humanlayer/skills --skill improve-claude-md
npx skills add humanlayer/skills --skill narrow-react-prop-types
npx skills add humanlayer/skills --skill build-iterated-agentic-loop
npx skills add humanlayer/skills --skill design-control-loopLệnh trên dùng npx, nên nếu lần đầu máy hỏi có tải gói về không, bạn đọc kỹ rồi mới đồng ý. README không mô tả skill được lưu ở thư mục nào sau khi cài. Nếu bạn muốn biết, hãy xem thư mục plugins/ và .claude-plugin/ trong repo.
C.Gọi skill trong Claude Code
Mở Claude Code trong dự án, rồi gõ lệnh gạch chéo. Với rpi, README đưa các ví dụ:
/rpi research how the collections connect to the database
/rpi make a PRD
/rpi what's next .agents/artifacts/my-change
/rpi implement .agents/artifacts/my-changeVới Codex, dùng $rpi thay cho /rpi:
$rpi research how the collections connect to the databaseCác skill khác gọi đơn giản hơn:
/show-me
/visual-pr
/improve-claude-md
/narrow-react-prop-types
/build-iterated-agentic-loop
/design-control-loopTrong Codex, môi trường chạy mặc định (sandbox) có thể khiến thư mục .agents chỉ đọc. Khi đó hãy cấp quyền ghi cho .agents/artifacts, hoặc đưa một thư mục tác vụ có thể ghi được như artifacts/my-change. RPI sẽ hỏi trước khi thay đổi một nơi bị chặn. Hãy đọc kỹ câu hỏi đó trước khi đồng ý, và chỉ cấp quyền ghi cho đúng thư mục cần thiết.
IV.Kiểm tra đã chạy được chưa
README không có mục kiểm tra cài đặt riêng, nên mình chỉ nói được những gì suy ra từ cách dùng:
- Lệnh
npx skills add ...chạy xong mà không báo lỗi đỏ là dấu hiệu tốt. - Mở Claude Code trong dự án, gõ
/và xem skill vừa cài (ví dụrpi) có xuất hiện trong danh sách lệnh không. Đây là cách kiểm tra do mình gợi ý, README không nói thẳng. - Thử một lệnh an toàn, không sửa gì:
/rpi research ...hỏi về một phần code bạn muốn hiểu. Nếu skill chạy và bắt đầu tìm hiểu dự án, tức là đã dùng được.
Nếu gõ /rpi mà Claude Code không nhận ra, xem phần lỗi thường gặp bên dưới.
V.Dùng vào việc thật
A.Dev mới vào một dự án lạ, cần hiểu code trước khi sửa
Bạn mới nhận một dự án có sẵn, được giao sửa phần kết nối cơ sở dữ liệu nhưng chưa biết nó chạy thế nào. Thay vì bảo AI "sửa đi", bạn bắt đầu bằng pha nghiên cứu:
/rpi research how the collections connect to the databaseSkill tìm hiểu code và ghi kết quả thành tài liệu trong máy. Bạn đọc tài liệu đó, hỏi lại chỗ chưa rõ, rồi mới quyết định làm tiếp. Kết quả là bạn hiểu hệ thống trước khi thay đổi bất cứ dòng nào.
Đừng để AI sửa code khi bạn chưa hiểu nó định sửa cái gì.
Ông T
B.Chủ sản phẩm nhỏ muốn viết yêu cầu rõ ràng rồi mới giao làm
Bạn là người làm sản phẩm kiêm lập trình, có ý tưởng tính năng nhưng hay bị lan man. Bạn gọi:
/rpi make a PRDSkill giúp bạn đi qua các lựa chọn thiết kế và viết thành PRD, sau đó theo TDD (kiểm thử trước). Khi đã có tài liệu, bạn hỏi bước tiếp theo hoặc cho triển khai bằng hai lệnh README đưa ra:
/rpi what's next .agents/artifacts/my-change
/rpi implement .agents/artifacts/my-changeKết quả là một thư mục tài liệu cho mỗi thay đổi, dễ đọc lại, dễ giao cho người khác tiếp tục. Thư mục my-change là tên ví dụ, bạn đặt tên theo thay đổi của mình.
C.Dev gửi pull request và muốn người review đỡ mệt
Bạn vừa làm xong một thay đổi khá lớn. Người review thường chán đọc diff dài. Bạn gõ:
/visual-prSkill tạo hoặc cập nhật pull request kèm phần phác thảo trực quan, để người review nắm ý chính của thay đổi trước khi đi vào chi tiết. README không mô tả chính xác định dạng hình, nên bạn hãy thử trên một PR nhỏ trước.
D.Người giữ CLAUDE.md mà Claude cứ bỏ qua quy tắc
Dự án của bạn có file CLAUDE.md dài, nhưng AI thỉnh thoảng làm trái các quy tắc trong đó. Bạn chạy trong dự án:
/improve-claude-mdSkill viết lại CLAUDE.md bằng các khối <important if> để tăng khả năng AI tuân theo. Trước khi chạy, hãy sao lưu file CLAUDE.md gốc hoặc đảm bảo nó đã nằm trong Git để so sánh và hoàn tác nếu bản mới không ưng ý.
Nếu bạn làm React và hay thấy kiểu prop quá rộng vì phải chiều theo Storybook hay mock, thử /narrow-react-prop-types theo cách tương tự.
VI.Lỗi hay gặp và cách xử lý
A.Báo không tìm thấy lệnh npx
Nghĩa là máy chưa có Node.js, hoặc terminal chưa nhận Node. Cài Node từ trang chủ của nó, đóng terminal đi mở lại, rồi chạy lại lệnh. README không ghi phiên bản Node cụ thể, nên nếu gặp lỗi lạ, hãy thử bản Node mới ổn định.
B.Gõ /rpi mà Claude Code không nhận
Có thể bạn cài ở thư mục khác với thư mục đang mở Claude Code, hoặc chưa khởi động lại phiên. Hãy kiểm tra lại bạn đang đứng đúng thư mục dự án, chạy lại lệnh cài, rồi mở phiên Claude Code mới. Cách chắc chắn nhất là xem hướng dẫn trong thư mục plugins/ của repo.
C.Trong Codex không ghi được vào .agents
Đây là lỗi chính README đã cảnh báo: sandbox mặc định có thể làm .agents chỉ đọc. Cách xử lý an toàn là cấp quyền ghi riêng cho .agents/artifacts, hoặc dùng một thư mục tác vụ ghi được như artifacts/my-change. Đừng mở quyền ghi rộng hơn mức cần.
D.Dùng sai ký hiệu gọi skill
Trong Claude Code dùng /rpi, còn trong Codex dùng $rpi. Gõ nhầm sẽ không chạy. Kiểm tra lại bạn đang ở công cụ nào.
E.AI sửa quá tay sau khi implement
Bất kỳ skill nào cho AI sửa code đều có thể thay đổi nhiều hơn bạn nghĩ. Hãy làm việc trên một nhánh Git riêng, đọc lại tài liệu của pha trước, và xem diff trước khi gộp.
VII.Có nên dùng không
Điểm mạnh:
- Quy trình rõ ràng: nghiên cứu, thiết kế rồi mới triển khai, có tài liệu ghi lại từng bước.
- Cài từng skill riêng bằng một lệnh, không phải lấy cả bộ.
- Giấy phép MIT, mã nguồn mở, repo còn được cập nhật và có lượng người quan tâm lớn (khoảng 5.763 sao).
- Có skill rất thực dụng cho công việc hằng ngày như
visual-prvàimprove-claude-md.
Giới hạn:
- Dành cho người lập trình. Nếu bạn làm văn phòng hay kinh doanh và không dùng Claude Code, các skill này sẽ ít hữu ích.
- README khá ngắn: không ghi yêu cầu phiên bản, không có phần kiểm tra cài đặt, không giải thích chi tiết từng skill. Bạn sẽ phải tự thử và đọc thêm trong repo.
- Chạy theo từng pha nên mất nhiều bước hơn so với một câu lệnh "sửa luôn". Với việc nhỏ vài dòng, cách đó có thể thừa.
- Hai skill về vòng lặp agent (
build-iterated-agentic-loop,design-control-loop) khá nâng cao và liên quan GitHub Actions. Người mới nên bỏ qua lúc đầu.
Khi nào chọn cách khác: nếu chỉ cần sửa nhanh một lỗi nhỏ, cứ nhờ Claude Code trực tiếp. Còn nếu bạn thay đổi lớn, làm việc nhóm, hoặc muốn có tài liệu để người khác theo dõi, rpi và visual-pr đáng để cài thử.
Câu hỏi thường gặp
humanlayer/skills có miễn phí không?
Repo dùng giấy phép MIT, là mã nguồn mở nên bạn dùng được mà không mất phí cho repo. Tuy nhiên bạn vẫn cần công cụ chạy skill như Claude Code hoặc Codex, và chi phí của các công cụ đó README không đề cập.
Cài bộ skill này bằng lệnh nào?
Dùng lệnh `npx skills add humanlayer/skills --skill TÊN_SKILL`, thay TÊN_SKILL bằng skill bạn muốn, ví dụ `rpi`. Mỗi skill cài riêng bằng một lệnh. Sau đó bạn gọi skill bằng `/tên-skill` trong Claude Code.
Có dùng được trên Windows không?
README không nói rõ về hệ điều hành. Lệnh cài dùng npx, nên máy cần có Node.js. Chưa có thông tin chính thức về việc kiểm thử trên Windows, bạn nên thử trên một dự án nhỏ trước.
Cần GPU hay API key không?
README không nhắc yêu cầu GPU hay API key riêng cho repo này. Bạn chỉ cần môi trường dùng được Claude Code hoặc Codex như bình thường.
Có dùng được trong Codex không?
Có. README nói trong Codex bạn dùng `$rpi` thay cho `/rpi`. Lưu ý sandbox mặc định của Codex có thể làm thư mục .agents chỉ đọc, nên cần cấp quyền ghi cho .agents/artifacts hoặc dùng một thư mục tác vụ ghi được như artifacts/my-change.
Skill rpi khác gì việc bảo Claude Code sửa thẳng?
Theo README, rpi nghiên cứu thay đổi, cùng bạn bàn các lựa chọn thiết kế rồi mới triển khai dựa trên tài liệu trong máy. Mỗi pha mặc định chạy trong một phiên mới. Nhờ vậy bạn có tài liệu để xem lại và kiểm soát hơn so với giao việc một lần.
Skill có tự gửi dữ liệu dự án đi đâu không?
README không có thông tin về việc này. Các skill chạy trong công cụ AI bạn dùng, nên dữ liệu đi theo chính sách của công cụ đó. Nếu dự án nhạy cảm, hãy đọc mã nguồn skill trong thư mục plugins/ trước khi dùng.


