# 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

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

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-23 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/humanlayer-skills-bo-skill-claude-code-rpi-visual-pr

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

```repo
- repo | humanlayer/skills
- kind | Skill
- desc | 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.
- stars | 5.8k
- lang | TypeScript
- license | MIT
```

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

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

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

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

### 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ử.

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

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

### 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á.

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

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

```steps
- Mở terminal | Vào đúng thư mục dự án của bạn
- Chọn skill | Quyết định cần skill nào (ví dụ rpi)
- Chạy lệnh npx | Cài skill bằng npx skills add
- Gọi skill | Gõ lệnh gạch chéo trong Claude Code
```

### 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):

```bash
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`.

### Cài skill bằng npx

Cú pháp chung theo README:

```bash
npx skills add humanlayer/skills --skill SKILLNAME
```

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

```bash
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`:

```bash
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.

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

```note
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.
```

## 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ộ.

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

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

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

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

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

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

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

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

### 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`.

### 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 ý.

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

## 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ử.

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