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

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

9 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 để nghiên cứu, viết PRD và mở PR — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

humanlayer/skills là bộ skill cho Claude Code do HumanLayer chia sẻ, gồm các skill như rpi, show-me, visual-pr và improve-claude-md. Mỗi skill cài bằng một lệnh npx và gọi bằng lệnh gạch chéo trong Claude Code. Cài đặt khá đơn giản nếu bạn đã có Node.js và Claude Code.

humanlayer/skills là một bộ "skill" (kỹ năng đóng gói sẵn) cho Claude Code, do HumanLayer chia sẻ. Mỗi skill là một bộ hướng dẫn giúp Claude làm một việc cụ thể theo quy trình bài bản, thay vì bạn phải gõ lại một đoạn prompt dài mỗi lần. Repo dùng giấy phép MIT và hiện có khoảng 5759 sao, 205 fork.

Bạn nên đọc bài này nếu đang dùng Claude Code để viết phần mềm, kể cả khi mới bắt đầu. Nhóm nhân viên văn phòng có đụng đến dự án code, hoặc chủ doanh nghiệp nhỏ thuê người làm web và muốn hiểu họ đang làm gì, cũng dùng được vài skill trong bộ này.

Điểm đáng giá nhất là skill rpi. Nó chia một thay đổi thành các pha: nghiên cứu, bàn phương án thiết kế với bạn, rồi mới triển khai. Mỗi pha chạy trong một phiên mới theo mặc định. Ngoài ra còn show-me (giải thích bằng sơ đồ), visual-pr (tạo pull request có phần tóm tắt trực quan) và improve-claude-md (viết lại file CLAUDE.md của bạn).

Skill

humanlayer/skills

Bộ skill Claude Code của HumanLayer: nghiên cứu và triển khai thay đổi (rpi), giải thích bằng sơ đồ, tạo PR trực quan, viết lại CLAUDE.md.

★ 5.8kTypeScriptMIT
Xem repo trên GitHub

I.humanlayer/skills làm được gì

Repo hiện liệt kê bảy skill. Bạn chỉ cần cài skill nào mình cần, không bắt buộc cài hết.

A.rpi: nghiên cứu, bàn thiết kế, rồi triển khai

rpi nghiên cứu một thay đổi, cùng bạn đi qua các lựa chọn thiết kế, rồi triển khai dựa trên các tài liệu cục bộ. Bạn chọn một trong bốn hướng: thảo luận thiết kế, PRD rồi TDD, thiết kế kỹ thuật, hoặc nghiên cứu rồi triển khai. Lợi ích thực tế là bạn không để Claude lao vào sửa code ngay. Bạn có tài liệu để đọc và chỉnh trước khi có dòng code nào thay đổi.

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

show-me giải thích chủ đề đang bàn bằng sơ đồ gọn, bản phác thảo hình dạng code và các tệp HTML tập trung. Nếu bạn là người đọc hiểu bằng hình nhiều hơn chữ, skill này tiết kiệm khá nhiều thời gian.

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

visual-pr tạo hoặc cập nhật một pull request kèm phần tóm tắt trực quan ngắn gọn. Mục đích là giúp người duyệt hiểu thay đổi nhanh hơn, đỡ phải đọc từng dòng diff.

D.improve-claude-md: viết lại CLAUDE.md

improve-claude-md viết lại file CLAUDE.md của dự án bằng các khối <important if>, nhằm giúp Claude tuân thủ chỉ dẫn tốt hơn. Nếu bạn thấy Claude hay bỏ qua quy tắc đã ghi, đây là skill đáng thử.

E.narrow-react-prop-types: thu hẹp kiểu prop React

Skill này thu hẹp kiểu dữ liệu prop của component React cho khớp với các đường chạy thật của code, thay vì khớp với trạng thái chỉ có trong Storybook, test hoặc mock. Skill này dành cho dev React.

F.build-iterated-agentic-loop

Skill này dựng một skill nằm trong repo của bạn, cộng với workflow GitHub Actions chạy coding agent lặp đi lặp lại, kèm prompt, file bộ nhớ và các mẫu tham chiếu.

G.design-control-loop

Skill này 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 chấp hành và các nhiễu loạn, 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 một workflow coding agent theo lịch. Hai skill cuối thiên về người đã quen CI và tự động hoá.

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

README không có mục yêu cầu hệ thống riêng. Dựa vào những gì README viết, bạn cần:

  • Claude Code, vì các skill được gọi bằng lệnh gạch chéo như /rpi ngay trong Claude Code. README cũng nhắc Codex: ở đó bạn gõ $rpi thay cho /rpi.
  • Công cụ npx để chạy lệnh cài. npx đi kèm Node.js, nên bạn cần cài Node.js trước. README không nêu phiên bản Node cụ thể.
  • Một thư mục dự án để chạy skill. Phần lớn skill làm việc trên codebase của bạn, nên hãy mở terminal ngay trong thư mục dự án.

README không nhắc đến API key, phần cứng hay hệ điều hành riêng cho repo này. Chi phí dùng Claude Code phụ thuộc gói tài khoản của bạn, repo không nói gì thêm.

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

  1. Mở terminalVào đúng thư mục dự án của bạn
  2. Chọn skillQuyết định cần skill nào (ví dụ rpi)
  3. Chạy lệnh npxCài skill bằng npx skills add
  4. Gọi skillGõ lệnh gạch chéo trong Claude Code

A.Mở terminal trong thư mục dự án

Với người mới, đây là chỗ hay vấp nhất. Bạn cần mở terminal (PowerShell hoặc Terminal) rồi chuyển vào thư mục dự án. Nếu chưa có dự án, bạn có thể tải repo skill về xem thử bằng lệnh phổ thông sau (không bắt buộc để cài skill):

Terminal
git clone https://github.com/humanlayer/skills.git
cd skills

git clone tải mã nguồn về máy, cd skills đi vào thư mục vừa tải. Để cài skill dùng cho dự án của bạn, hãy cd vào thư mục dự án đó thay vì thư mục skills.

B.Cài skill bằng npx

Cú pháp chung theo README:

Terminal
npx skills add humanlayer/skills --skill SKILLNAME

Thay SKILLNAME bằng tên skill. Ví dụ cài rpi:

Terminal
npx skills add humanlayer/skills --skill rpi

Các skill còn lại cài tương tự, chỉ đổi tên sau --skill:

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
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-loop

Lưu ý: phải gõ đúng tên skill. Gõ sai tên thì lệnh sẽ không tìm thấy skill.

C.Gọi skill trong Claude Code

Sau khi cài, mở Claude Code trong thư mục dự án và gõ lệnh gạch chéo. Ví dụ:

text
/show-me

Với rpi, bạn đưa kèm nhiệm vụ:

text
/rpi research how the collections connect to the database

README không mô tả thêm các bước cấu hình khác, nên bạn không cần làm gì thêm ngoài việc cài rồi gọi.

Khi dùng Codex, README cho biết sandbox mặc định có thể khiến thư mục .agents chỉ đọc. Bạn cần cấp quyền ghi cho .agents/artifacts, hoặc chỉ định một thư mục làm việc ghi được như artifacts/my-change. Đừng tự mở quyền rộng hơn mức cần thiết.

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

README không có mục kiểm tra riêng, nhưng cách kiểm tra đơn giản là gọi thử một skill:

  1. Mở Claude Code trong thư mục dự án.
  2. Gõ /show-me (hoặc /rpi kèm một yêu cầu nghiên cứu).
  3. Nếu Claude nhận ra lệnh và bắt đầu làm theo skill, bạn đã cài xong.

Nếu Claude báo không nhận ra lệnh, xem phần lỗi thường gặp bên dưới. Với rpi, kết quả mong đợi theo README là các tài liệu được lưu ở thư mục như .agents/artifacts/my-change, vì skill làm việc từ tài liệu cục bộ.

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

A.Lập trình viên mới muốn hiểu một codebase lạ

Bạn vừa nhận một dự án và chưa biết dữ liệu đi từ đâu đến đâu. Thay vì tự lần từng file, hãy để skill nghiên cứu:

text
/rpi research how the collections connect to the database

Bạn nhận được tài liệu nghiên cứu về cách các phần của dự án nối với nhau. Từ đó bạn có thể hỏi tiếp hoặc chuyển sang bước thiết kế. Để xem bước kế tiếp của một thay đổi đã có, README cho dùng:

text
/rpi what's next .agents/artifacts/my-change

Đừng để AI viết code trước khi bạn kịp hiểu nó định làm gì.

Ông T

B.Người phụ trách sản phẩm muốn có PRD trước khi giao việc

Bạn là chủ shop online đang thuê dev, hoặc nhân viên văn phòng đứng ra điều phối một tính năng mới. Bạn muốn có tài liệu yêu cầu rõ ràng trước khi ai đó bắt tay làm. Gõ:

text
/rpi make a PRD

README mô tả hướng "PRD rồi TDD": viết yêu cầu sản phẩm trước, sau đó làm theo hướng kiểm thử. Khi đã ưng ý với tài liệu, bạn chuyển sang bước làm:

text
/rpi implement .agents/artifacts/my-change

Kết quả là bạn có tài liệu để cả nhóm đọc, và phần triển khai bám theo tài liệu đó. Tốc độ và chất lượng cụ thể phụ thuộc dự án của bạn, README không đưa số liệu.

C.Người mới muốn hiểu một đoạn code bằng hình

Bạn đang đọc một đoạn code khó và chữ giải thích dài không vào đầu. Trong Claude Code, khi đang bàn về chủ đề đó, bạn gõ:

text
/show-me

Skill giải thích chủ đề hiện tại bằng sơ đồ gọn, bản phác thảo hình dạng code và các tệp HTML tập trung. Bạn có thể mở tệp HTML trong trình duyệt để xem.

D.Dev muốn PR dễ duyệt và CLAUDE.md nghe lời hơn

Sau khi sửa xong, bạn tạo pull request bằng:

text
/visual-pr

Skill tạo hoặc cập nhật PR kèm phần tóm tắt trực quan để người duyệt nắm ý nhanh. Ngoài ra, nếu Claude hay bỏ sót quy tắc trong CLAUDE.md, chạy trong dự án:

text
/improve-claude-md

Skill viết lại CLAUDE.md bằng các khối <important if>. Bạn nên xem lại bản mới trước khi giữ lại.

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

Phần này là các lỗi rất dễ xảy ra với loại công cụ này. README của repo không liệt kê chúng.

A.Báo không có lệnh npx

Nguyên nhân thường là máy chưa cài Node.js, hoặc bạn chưa mở lại terminal sau khi cài. Hãy cài Node.js từ trang chính thức, đóng terminal, mở lại rồi chạy lại lệnh.

B.Gõ lệnh gạch chéo mà Claude không nhận ra

Kiểm tra ba điều: bạn đã cài đúng skill chưa, đã gõ đúng tên chưa (/rpi, /show-me, /visual-pr), và có đang mở Claude Code trong đúng thư mục dự án nơi bạn cài không. Thử cài lại skill đó bằng lệnh npx skills add rồi mở phiên Claude Code mới.

C.Dùng Codex mà gõ /rpi không được

README nói trong Codex bạn dùng $rpi thay cho /rpi, ví dụ $rpi research how the collections connect to the database.

D.Không ghi được tài liệu vào .agents

Trong Codex, sandbox mặc định có thể làm .agents chỉ đọc. Cách xử lý theo README: cấp cho phiên quyền ghi vào .agents/artifacts, hoặc chỉ định một thư mục ghi được như artifacts/my-change. README cũng cho biết RPI sẽ hỏi trước khi thay đổi một đích bị chặn, nên bạn cứ đọc kỹ câu hỏi rồi mới đồng ý.

E.Kết quả không như ý vì yêu cầu quá chung chung

Skill chỉ làm tốt khi bạn nói rõ việc cần làm. Thay vì gõ /rpi làm tính năng giỏ hàng, hãy mô tả cụ thể phần nào, dùng dữ liệu nào, kết quả mong muốn ra sao. Đọc tài liệu skill tạo ra và chỉnh trước khi chuyển sang triển khai.

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

Điểm mạnh: cài nhanh bằng một lệnh, mỗi skill độc lập nên bạn chọn cái mình cần, giấy phép MIT, và repo còn được cập nhật trong vài tháng gần đây. Cách làm của rpi (nghiên cứu, bàn thiết kế, rồi mới triển khai, mỗi pha một phiên mới) phù hợp với những thay đổi không nhỏ, nơi bạn muốn kiểm soát hướng đi.

Giới hạn: README khá ngắn, không giải thích chi tiết từng skill chạy thế nào bên trong, và không có phần xử lý sự cố. Mấy skill như build-iterated-agentic-loop và design-control-loop đòi hỏi bạn đã quen với GitHub Actions và coding agent, người mới nên bắt đầu với show-me, rpi hoặc improve-claude-md. Repo viết bằng TypeScript và hướng tới người làm phần mềm, nên nếu bạn không đụng đến code thì lợi ích sẽ hạn chế.

Nếu bạn chỉ cần một việc đơn lẻ như sửa nhanh một lỗi nhỏ, không cần cả quy trình nhiều pha, bạn cứ nhờ Claude Code trực tiếp cho gọn. Còn nếu muốn có quy trình rõ ràng cho thay đổi lớn hơn, bộ skill này đáng để thử.

4.8/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 dùng được tự do. Tuy nhiên các skill chạy trên Claude Code (hoặc Codex), và README không nói gì về chi phí của các dịch vụ đó. Bạn cần xem gói tài khoản của mình.

Cài bằng cách nào?

Dùng lệnh npx skills add humanlayer/skills --skill SKILLNAME, thay SKILLNAME bằng tên skill, ví dụ rpi hoặc show-me. Sau đó gọi skill bằng lệnh gạch chéo trong Claude Code, ví dụ /rpi hoặc /show-me.

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

README không nêu yêu cầu phần cứng nào. Skill là các bộ chỉ dẫn cho Claude Code, nên chưa có thông tin cho thấy cần GPU.

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

README không nói riêng về hệ điều hành. Lệnh cài dùng npx nên cần Node.js, vốn có bản cho Windows. Chưa có thông tin chính thức hơn về Windows trong tư liệu.

Dùng với Codex được không?

Có nhắc đến. README cho biết trong Codex bạn dùng $rpi thay cho /rpi. Sandbox mặc định của Codex có thể khiến thư mục .agents chỉ đọc, nên bạn cần cấp quyền ghi cho .agents/artifacts hoặc chỉ định thư mục ghi được như artifacts/my-change.

Skill nào nên thử đầu tiên?

Người mới nên thử show-me để được giải thích bằng sơ đồ, hoặc rpi để nghiên cứu một phần code trước khi sửa. Các skill build-iterated-agentic-loop và design-control-loop dành cho người đã quen workflow tự động hoá.

Dữ liệu và code của tôi có an toàn không?

README không có thông tin về bảo mật dữ liệu. Skill chạy trong phiên Claude Code của bạn và làm việc với tài liệu cục bộ, nên cách xử lý dữ liệu phụ thuộc vào cài đặt Claude Code bạn đang dùng. Bạn nên xem lại những gì skill ghi hoặc thay đổi trước khi chấp nhận.

Chuyển nhanh tới mục

  1. I.humanlayer/skills làm được gì
    1. A.rpi: nghiên cứu, bàn thiết kế, rồi triển khai
    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: thu hẹp kiểu prop React
    6. F.build-iterated-agentic-loop
    7. G.design-control-loop
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở terminal trong thư mục dự án
    2. B.Cài skill bằng npx
    3. C.Gọi skill trong Claude Code
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Lập trình viên mới muốn hiểu một codebase lạ
    2. B.Người phụ trách sản phẩm muốn có PRD trước khi giao việc
    3. C.Người mới muốn hiểu một đoạn code bằng hình
    4. D.Dev muốn PR dễ duyệt và CLAUDE.md nghe lời hơn
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo không có lệnh npx
    2. B.Gõ lệnh gạch chéo mà Claude không nhận ra
    3. C.Dùng Codex mà gõ /rpi không được
    4. D.Không ghi được tài liệu vào .agents
    5. E.Kết quả không như ý vì yêu cầu quá chung chung
  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ỏ.