Bỏ qua tới nội dung
Ông T.vn

humanlayer/skills: bộ skill Claude Code cho nghiên cứu, viết PR — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

Bài này là một góc nhìn khác về humanlayer/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: humanlayer/skills: bộ skill Claude Code cho nghiên cứu, PR và CLAUDE.md — hướng dẫn cài và dùng →

humanlayer/skills: bộ skill Claude Code cho nghiên cứu, viết PR — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

humanlayer/skills là bộ skill (lệnh gạch chéo) cho Claude Code do HumanLayer viết, giấy phép MIT. Mỗi skill cài bằng một dòng npx và gọi bằng /tên-skill, ví dụ /rpi để nghiên cứu rồi làm một thay đổi code. Cài khá dễ, nhưng bạn cần đã có Claude Code và một dự án để thử.

humanlayer/skills là một bộ skill cho Claude Code, do nhóm HumanLayer viết và để giấy phép MIT. Skill hiểu đơn giản là một lệnh gạch chéo (ví dụ /rpi) mà bạn gõ vào Claude Code để nó làm việc theo một quy trình có sẵn, thay vì bạn phải tự viết lại hướng dẫn dài mỗi lần.

Bộ này gồm nhiều skill nhỏ, mỗi skill lo một việc: nghiên cứu rồi làm một thay đổi trong code, giải thích một chủ đề bằng sơ đồ, tạo pull request có phác thảo trực quan, viết lại file CLAUDE.md, và vài skill nâng cao hơn về vòng lặp agent. Bạn không phải cài hết. Cần skill nào thì cài đúng skill đó.

Điểm đáng giá nhất là skill rpi: nó tách việc thành các phase (nghiên cứu, bàn thiết kế, làm), mỗi phase mặc định chạy trong một phiên mới, và lưu kết quả thành tài liệu trong máy. Bạn dễ kiểm soát AI đang làm gì hơn là giao cả một việc lớn trong một cuộc trò chuyện dài. Repo hiện có khoảng 5763 sao và 205 fork, và vẫn được cập nhật trong vài tháng gần đây.

Skill

humanlayer/skills

Bộ skill Claude Code của HumanLayer: nghiên cứu và làm tính năng theo từng phase (rpi), giải thích bằng sơ đồ, tạo PR có phác thảo trực quan, viết lại CLAUDE.md.

★ 5.8kTypeScriptMIT
Xem repo trên GitHub

I.Bộ skill này làm được gì

Mỗi skill là một việc riêng. Dưới đây là những gì README mô tả.

A.rpi: nghiên cứu, bàn thiết kế, rồ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 làm dựa trên các tài liệu lưu trong máy. Bạn chọn được kiểu làm: bàn thiết kế, viết PRD rồi làm theo TDD, viết thiết kế kỹ thuật, hoặc nghiên cứu rồi làm luôn. Lợi ích thực tế: bạn không bị đẩy vào việc sửa code ngay khi chưa hiểu hệ thống. Mỗi phase mặc định chạy trong một phiên mới, nên AI không bị rối vì cuộc trò chuyện quá dài.

B.show-me: giải thích bằng hình

Skill này giải thích chủ đề đang bàn bằng sơ đồ gọn, phác thảo hình dạng của code và các tệp HTML tập trung vào một ý. Hợp khi bạn nhận một dự án lạ và cần hiểu nhanh nó nối với nhau thế nào.

C.visual-pr: pull request dễ duyệt hơn

Tạo hoặc cập nhật pull request kèm một phác thảo trực quan ngắn, giúp người duyệt hiểu thay đổi mà không phải đọc từng dòng diff ngay từ đầu.

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> để Claude tuân thủ chỉ dẫn tốt hơn. Dùng khi bạn thấy Claude hay bỏ qua quy tắc đã ghi.

E.narrow-react-prop-types: gọn kiểu dữ liệu React

Thu hẹp kiểu prop của component React cho khớp với các luồng code thật đang chạy, thay vì các trạng thái chỉ có trong Storybook, test hay mock.

F.build-iterated-agentic-loop và design-control-loop

Hai skill nâng cao hơn. Skill đầu dựng một skill trong repo của bạn cùng workflow GitHub Actions cho coding agent chạy lặp, kèm prompt, file ghi nhớ và các mẫu tham khảo. Skill sau phỏng vấn bạn để thiết kế một vòng điều khiển (cảm biến, bộ điều khiển, cơ cấu tác động, nhiễu) rồi dựng thành các thành phần chạy được trên máy cùng workflow chạy theo lịch. Hai skill này dành cho người đã quen GitHub Actions. Bài này không đi sâu vào chúng.

II.Cần chuẩn bị gì

README chỉ ghi vài thứ, nên mình chỉ nêu những gì có trong đó:

  • Một công cụ coding agent dùng được skill. README nói đây là skill cho Claude Code, và có nhắc cách dùng trong Codex (gõ $rpi thay vì /rpi).
  • Máy chạy được lệnh npx, vì cách cài là npx skills add .... README không ghi phiên bản Node cần thiết, nên mình không đoán.
  • Một dự án (thư mục code) để thử. Các skill như rpi hay improve-claude-md làm việc trên dự án của bạn.

README không nói gì về hệ điều hành, API key hay phần cứng riêng cho bộ skill này. Chi phí dùng AI phụ thuộc vào gói Claude Code bạn đang có, mình chưa có thông tin cụ thể từ repo.

III.Cài đặt từng bước

  1. Mở terminalMở cửa sổ dòng lệnh, đứng trong thư mục dự án của bạn
  2. Cài skillChạy npx skills add humanlayer/skills --skill TÊN-SKILL
  3. Mở Claude CodeKhởi động Claude Code trong dự án như bình thường
  4. Gọi skillGõ /rpi (hoặc tên skill khác) kèm yêu cầu của bạn

A.Mở terminal đúng chỗ

README không nói bạn phải đứng ở thư mục nào khi cài. Cách an toàn cho người mới là mở terminal ngay trong thư mục dự án bạn định dùng, để sau đó mở Claude Code ở đúng chỗ đó. Không có bước nào khác phải làm trước.

B.Cài một skill

Lệnh chung của repo, trong đó SKILLNAME là tên skill bạn chọn:

Terminal
npx skills add humanlayer/skills --skill SKILLNAME

Ví dụ cài skill rpi:

Terminal
npx skills add humanlayer/skills --skill rpi

Chỗ người mới hay vấp: phải thay SKILLNAME bằng tên thật. Đừng gõ nguyên chữ SKILLNAME. Tên các skill có trong README là rpi, show-me, visual-pr, improve-claude-md, narrow-react-prop-types, build-iterated-agentic-loop, design-control-loop.

Muốn cài thêm skill khác, chạy lại lệnh với tên khác:

Terminal
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

README không giải thích lệnh này lưu skill vào thư mục nào. Nếu muốn biết, bạn xem thư mục .claude-plugin và plugins trong repo trên GitHub.

C.Mở Claude Code và gọi skill

Mở Claude Code trong dự án, rồi gõ lệnh gạch chéo của skill. Với rpi, README đưa các ví dụ:

text
/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-change

Bốn dòng này theo thứ tự: nhờ nghiên cứu một vấn đề, làm PRD, hỏi bước tiếp theo, rồi bắt tay làm. Phần sau /rpi là yêu cầu của bạn, README viết bằng tiếng Anh nhưng bạn có thể thử viết tiếng Việt. Mình chưa có thông tin chính thức là nó hoạt động tốt thế nào với tiếng Việt, nên bạn thử và xem kết quả.

Các skill còn lại gọi đơn giản hơn:

text
/show-me
/visual-pr
/improve-claude-md
/narrow-react-prop-types
/build-iterated-agentic-loop
/design-control-loop

D.Nếu bạn dùng Codex

README ghi: trong Codex, dùng $rpi thay cho /rpi, ví dụ:

text
$rpi research how the collections connect to the database

Trong Codex, sandbox mặc định có thể khiến thư mục .agents bị chỉ-đọc. Khi đó hãy cấp quyền ghi cho .agents/artifacts, hoặc đưa một thư mục tác vụ ghi được như artifacts/my-change. RPI sẽ hỏi lại trước khi thay đổi một nơi đang bị chặn.

IV.Kiểm tra đã chạy được chưa

README không mô tả kết quả mong đợi sau khi cài. Cách kiểm tra hợp lý nhất, dựa trên chính cách dùng trong README:

  • Mở Claude Code trong dự án và gõ / rồi xem tên skill vừa cài có xuất hiện trong danh sách lệnh không. Đây là cách mình gợi ý, README không ghi.
  • Thử skill nhẹ nhất là /show-me khi đang bàn một chủ đề. Nếu nó trả về sơ đồ hoặc bản giải thích trực quan thì skill đã chạy.
  • Với rpi, thử một yêu cầu chỉ nghiên cứu, không sửa code, ví dụ /rpi research ... về một phần trong dự án. Nếu có tài liệu nghiên cứu được tạo ra thì ổn.

Nếu lệnh npx báo lỗi ngay lúc cài, xem phần lỗi hay gặp bên dưới.

V.Dùng vào việc thật

A.Dev mới nhận một dự án lạ

Bạn vừa vào công ty, được giao sửa một chỗ trong hệ thống mà chưa ai giải thích. Trước khi sửa, hãy cho Claude nghiên cứu:

text
/rpi research how the collections connect to the database

Thay phần sau research bằng chỗ bạn cần hiểu. Kết quả là một tài liệu nghiên cứu lưu trong máy, bạn đọc để nắm luồng chạy trước khi chạm vào code. Sau đó có thể dùng /show-me để xin thêm sơ đồ cho phần còn mờ.

Đừng bắt AI sửa code khi chính bạn còn chưa hiểu nó đang sửa cái gì.

Ông T

B.Làm một tính năng nhỏ có kế hoạch

Bạn là lập trình viên tự do, khách yêu cầu thêm một chức năng. Thay vì ném cả yêu cầu cho AI, bạn đi từng bước:

text
/rpi make a PRD
/rpi what's next .agents/artifacts/my-change
/rpi implement .agents/artifacts/my-change

Bước đầu tạo PRD (tài liệu mô tả yêu cầu). Bước hai hỏi skill nên làm gì tiếp. Bước ba mới thực sự làm, dựa trên các tài liệu đã lưu trong thư mục my-change. Kết quả: bạn có sẵn giấy tờ để đưa khách xem, và biết chính xác AI đã làm theo điều gì.

C.Gửi PR mà người duyệt không phải đoán

Bạn làm xong thay đổi và cần gửi pull request. Trong Claude Code gõ:

text
/visual-pr

Skill tạo hoặc cập nhật pull request kèm một phác thảo trực quan ngắn. Đồng nghiệp mở PR sẽ nhìn thấy bức tranh tổng thể trước khi đọc từng dòng thay đổi. Mình chưa có thông tin về việc skill cần quyền gì với GitHub, nên hãy đọc kỹ những gì nó hỏi trước khi đồng ý.

D.Làm Claude nghe lời hơn trong dự án

Bạn đã có file CLAUDE.md nhưng Claude hay bỏ qua vài quy tắc (ví dụ quy ước đặt tên, cách chạy test). Trong dự án đó gõ:

text
/improve-claude-md

Skill viết lại CLAUDE.md bằng các khối <important if> để các quy tắc được áp dụng đúng lúc hơn. Nên lưu hoặc commit bản CLAUDE.md cũ trước khi chạy, phòng khi bạn muốn quay lại.

VI.Lỗi hay gặp và cách xử lý

README không có mục xử lý lỗi, nên các lỗi dưới đây là những tình huống rất dễ xảy ra với loại công cụ này. Mình không dám khẳng định thông báo lỗi chính xác.

A.Lệnh npx không chạy hoặc báo không tìm thấy

Thường do máy chưa cài Node (npx đi kèm Node). Hãy cài Node từ trang chính thức, đóng và mở lại terminal rồi chạy lại lệnh. Repo không nêu phiên bản Node tối thiểu, nên nếu lỗi vẫn còn, hãy dùng bản Node mới ổn định.

B.Gõ /rpi nhưng Claude không nhận ra

Có thể skill chưa được cài, hoặc bạn cài ở một dự án khác với dự án đang mở Claude Code. Hãy chạy lại lệnh cài, rồi mở lại Claude Code trong đúng thư mục dự án và thử lại. Cũng kiểm tra bạn đã thay SKILLNAME bằng tên thật chưa.

C.Trong Codex, rpi không ghi được tài liệu

Đây là trường hợp README có nói rõ: sandbox mặc định có thể làm .agents thành chỉ-đọc. Hãy cấp quyền ghi cho .agents/artifacts, hoặc chỉ định một thư mục tác vụ ghi được như artifacts/my-change. Skill sẽ hỏi trước khi đổi chỗ bị chặn, nên đọc kỹ câu hỏi rồi mới đồng ý.

D.Skill sửa nhiều hơn bạn muốn

Với các skill có làm việc trên code hoặc file như rpi, improve-claude-md, narrow-react-prop-types, kết quả có thể thay đổi nhiều file. Nếu dự án chưa dùng git, hãy khởi tạo git và commit trước khi chạy để xem được khác biệt và hoàn tác khi cần. Với việc lớn, đi từng phase của rpi thay vì làm một lèo.

E.Làm theo yêu cầu tiếng Việt nhưng kết quả lệch ý

Ví dụ trong README đều bằng tiếng Anh. Nếu kết quả lệch, hãy mô tả cụ thể hơn: nói rõ thư mục, tên bảng, tên hàm liên quan, hoặc thử viết yêu cầu bằng tiếng Anh ngắn gọn.

VII.Có nên dùng không

Điểm mạnh:

  • Cài từng skill bằng một dòng lệnh, dùng bằng một lệnh gạch chéo, không phải dựng hạ tầng.
  • Quy trình của rpi buộc có bước nghiên cứu và thiết kế trước khi làm, giúp bạn kiểm soát được việc AI đang làm.
  • Mỗi skill độc lập, thử một cái thấy không hợp thì bỏ.
  • Giấy phép MIT và repo còn được cập nhật.

Giới hạn:

  • Đây là công cụ cho người làm việc với code. Nếu bạn làm văn phòng thuần túy, không có dự án code, hầu hết skill ở đây sẽ ít có ích.
  • README ngắn, chỉ mô tả mỗi skill vài dòng. Muốn hiểu sâu cách rpi hay hai skill vòng lặp agent hoạt động, bạn phải đọc thêm trong thư mục plugins của repo.
  • README không nói về chi phí, phiên bản Node hay xử lý lỗi. Hãy thử trên dự án nhỏ trước.
  • Skill rpi có thể làm bạn chậm hơn ở việc rất nhỏ, vì nó đi qua nhiều phase. Sửa một dòng thì cứ nhờ Claude trực tiếp là đủ.

Nếu bạn là lập trình viên đã dùng Claude Code và muốn một quy trình có kỷ luật hơn cho việc nghiên cứu, thiết kế và gửi PR, bộ này đáng thử, bắt đầu từ rpi hoặc show-me. Nếu bạn chỉ cần trả lời nhanh hoặc viết văn bản, một cuộc trò chuyện thường với AI đã đủ.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

humanlayer/skills có miễn phí không?

Repo dùng giấy phép MIT, nên bạn được dùng, sửa và chia sẻ mã nguồn. Tuy nhiên README không nói gì về chi phí khi chạy skill. Việc dùng Claude Code hay Codex có thể tính phí theo gói của bạn, repo chưa có thông tin cụ thể.

Cài bộ skill này bằng lệnh nào?

Dùng lệnh `npx skills add humanlayer/skills --skill SKILLNAME`, thay SKILLNAME bằng tên skill, ví dụ `rpi`. Mỗi skill cài riêng một lần, không cần cài hết cả bộ.

Dùng skill rpi như thế nào?

Sau khi cài, mở Claude Code trong dự án và gõ `/rpi` kèm yêu cầu, ví dụ `/rpi research how the collections connect to the database`. Bạn cũng có thể yêu cầu từng bước như `/rpi make a PRD` hay `/rpi implement .agents/artifacts/my-change`. Mỗi phase mặc định chạy trong một phiên mới.

Có dùng được với Codex không?

Có, README nói trong Codex bạn gõ `$rpi` thay cho `/rpi`. Lưu ý sandbox mặc định của Codex có thể khiến `.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.

Có cần GPU hay máy cấu hình cao không?

README không nêu yêu cầu phần cứng nào. Các skill này là chỉ dẫn cho Claude Code chạy, nên phần xử lý nặng nằm ở dịch vụ AI chứ không phải máy bạn, nhưng repo chưa khẳng định điều này.

Chạy được trên Windows không?

README không ghi hệ điều hành hỗ trợ. Cách cài dùng npx nên về nguyên tắc cần có Node, nhưng repo chưa có thông tin chính thức về Windows. Bạn nên thử trên một dự án nhỏ trước.

Bộ skill này khác gì việc tự viết prompt cho Claude?

Skill đóng gói sẵn một quy trình, ví dụ nghiên cứu rồi bàn thiết kế rồi mới làm, để bạn gọi bằng một lệnh thay vì viết lại hướng dẫn mỗi lần. Kết quả được lưu thành tài liệu trong máy. README chưa so sánh trực tiếp với cách khác nên chỉ nói được đến đó.

Chuyển nhanh tới mục

  1. I.Bộ skill này làm được gì
    1. A.rpi: nghiên cứu, bàn thiết kế, rồi làm
    2. B.show-me: giải thích bằng hình
    3. C.visual-pr: pull request dễ duyệt hơn
    4. D.improve-claude-md: viết lại CLAUDE.md
    5. E.narrow-react-prop-types: gọn kiểu dữ liệu React
    6. F.build-iterated-agentic-loop và design-control-loop
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở terminal đúng chỗ
    2. B.Cài một skill
    3. C.Mở Claude Code và gọi skill
    4. D.Nếu bạn dùng Codex
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới nhận một dự án lạ
    2. B.Làm một tính năng nhỏ có kế hoạch
    3. C.Gửi PR mà người duyệt không phải đoán
    4. D.Làm Claude nghe lời hơn trong dự án
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh npx không chạy hoặc báo không tìm thấy
    2. B.Gõ /rpi nhưng Claude không nhận ra
    3. C.Trong Codex, rpi không ghi được tài liệu
    4. D.Skill sửa nhiều hơn bạn muốn
    5. E.Làm theo yêu cầu tiếng Việt nhưng kết quả lệch ý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.