# vercel-labs/skills: cài skill cho coding agent — hướng dẫn cài đặt và dùng

> vercel-labs/skills là CLI cho hệ sinh thái open agent skills. Công cụ giúp bạn tìm, cài, cập nhật và dùng các bộ hướng dẫn tái sử dụng cho coding agent; chỉ cần Node.js 22.20 trở lên và chạy bằng npx nên cài khá đơn giản.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-01 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/vercel-labs-skills-cai-skill-cho-coding-agent

vercel-labs/skills là CLI giúp bạn tìm, cài đặt và quản lý các agent skill cho nhiều coding agent khác nhau. Một skill là bộ hướng dẫn có thể tái sử dụng, giúp agent biết cách xử lý những việc như review code, làm việc với thư viện hoặc thực hiện một quy trình kỹ thuật cụ thể.

Công cụ phù hợp với lập trình viên, nhóm phát triển và người dùng đang dùng Claude Code, Codex, Cursor, OpenCode hoặc các coding agent được hỗ trợ. Điểm đáng giá nhất là bạn không phải tự chép từng file hướng dẫn vào từng dự án. CLI có thể cài skill vào dự án hiện tại, dùng skill tạm thời, kiểm tra bản cập nhật và quản lý phiên bản qua lock file.

Repo được viết chủ yếu bằng TypeScript, có giấy phép MIT và hiện có khoảng 39.209 sao cùng 3.437 fork. README cũng cho biết dự án vẫn còn được cập nhật. Bạn có thể chạy CLI trực tiếp bằng npx mà không cần tự build mã nguồn trong repo.

```repo
- repo | vercel-labs/skills
- kind | CLI
- desc | CLI giúp tìm, cài, dùng và quản lý các agent skill cho Claude Code, Codex, Cursor, OpenCode và nhiều coding agent khác.
- stars | 39k
- lang | TypeScript
- license | MIT
```

## vercel-labs/skills làm được gì

### Tìm skill phù hợp

Bạn có thể dùng lệnh tìm kiếm để duyệt các skill có sẵn trong hệ sinh thái. Điều này hữu ích khi bạn biết mình muốn agent hỗ trợ một công việc, nhưng chưa biết bộ hướng dẫn nào phù hợp.

Ví dụ, người mới có thể tìm skill liên quan đến thiết kế giao diện, review code hoặc làm việc với một thư viện. Kết quả giúp bạn xem các lựa chọn trước khi cài vào dự án.

### Cài skill cho một dự án

CLI cài skill vào dự án hiện tại theo mặc định. Cách này phù hợp khi mỗi dự án có quy trình riêng. Skill chỉ nằm trong phạm vi dự án đó, nên cấu hình của một dự án không tự động làm thay đổi các dự án khác.

Bạn cũng có thể chọn coding agent và chọn một skill cụ thể. Ví dụ trong README, skill `web-design-guidelines` được cài cho Claude Code bằng tùy chọn `--skill` và `-a`.

### Cài skill dùng chung cho nhiều dự án

Tùy chọn `-g` cho phép đưa skill vào phạm vi dùng chung giữa các dự án. Cách này tiện khi bạn thường xuyên dùng cùng một bộ hướng dẫn cho nhiều thư mục.

Tuy vậy, skill dùng chung có thể khiến bạn khó nhận biết dự án nào đang phụ thuộc vào nó. Với nhóm phát triển, cài theo từng dự án thường dễ kiểm soát hơn.

### Dùng skill mà không cài

Lệnh `skills use` có thể tạo prompt cho một skill hoặc khởi chạy một coding agent được hỗ trợ cùng skill đó. Bạn có thể bỏ `--agent` để chỉ in prompt ra màn hình.

Tính năng này phù hợp khi bạn muốn thử một skill trước, hoặc chỉ cần lấy hướng dẫn để đưa vào quy trình hiện tại mà chưa muốn lưu skill vào dự án.

### Quản lý skill đã cài

CLI có các lệnh để liệt kê, kiểm tra, cập nhật và gỡ skill. Nhờ vậy, bạn có thể biết dự án đang có những skill nào, skill nào có bản cập nhật và loại bỏ skill không còn cần thiết.

Việc quản lý tập trung cũng giảm tình trạng một agent dùng phải bộ hướng dẫn cũ mà bạn không biết.

### Ghi nhận phiên bản bằng skills-lock.json

Lock file ghi lại hash nội dung của skill đã cài. Hash này dựa trên các file thực tế được đưa vào thư mục `.agents/skills/<name>`, giúp CLI so sánh nội dung trên máy với nội dung đã ghi nhận.

Với skill lấy từ Git, lock file còn ghi commit mà skill sử dụng. Khi khôi phục, CLI lấy đúng commit đó thay vì luôn lấy commit mới nhất. Điều này giúp kết quả giữa các máy hoặc các lần cài đặt ổn định hơn.

### Tạo skill mới

Lệnh `skills init` tạo một mẫu skill mới. Sau đó, bạn chỉnh sửa file `SKILL.md` để viết hướng dẫn cho agent.

Tính năng này phù hợp với nhóm có quy trình nội bộ, chẳng hạn quy tắc review code, cách đặt tên file hoặc checklist triển khai. README cũng có tài liệu riêng về frontmatter, bố cục repository và quy tắc discovery.

### Đồng bộ skill từ npm dependency

Các tính năng thử nghiệm cho phép đồng bộ những instruction được đóng gói cùng npm dependency vào dự án. CLI có thể tạo liên kết đến skill và cài các skill pack được khai báo trong `package.json`.

Đây là phần nâng cao. Tên lệnh và tùy chọn của các tính năng thử nghiệm có thể thay đổi hoặc bị loại bỏ mà không báo trước.

## Cần chuẩn bị gì

Bạn cần Node.js phiên bản 22.20.0 trở lên. README ghi rõ yêu cầu này cho việc cài skill. Nếu Node.js thấp hơn, lệnh npx có thể không chạy đúng.

Bạn cần mở terminal tại thư mục dự án muốn cài skill. CLI cài skill vào dự án hiện tại theo mặc định. Nếu muốn cài dùng chung, bạn thêm tùy chọn `-g` trong lệnh phù hợp.

Bạn không cần API key, tài khoản riêng, GPU hoặc phần cứng đặc biệt nào được README nhắc đến. Tư liệu cũng không nêu yêu cầu hệ điều hành cụ thể.

Repo có tên gói npm là `skills` và có lệnh CLI. README hướng dẫn chạy qua `npx`, vì vậy bạn không cần tự build TypeScript từ mã nguồn để bắt đầu dùng.

CLI có thu thập dữ liệu sử dụng ẩn danh. Nếu muốn tắt telemetry và các yêu cầu security audit, README nêu hai biến môi trường là `DISABLE_TELEMETRY=1` và `DO_NOT_TRACK=1`.

```note
Skill có thể chứa hướng dẫn được coding agent thực thi trong dự án. Hãy xem nội dung skill trước khi dùng, nhất là skill từ nguồn bên ngoài. Nếu không muốn gửi telemetry, đặt DISABLE_TELEMETRY=1 hoặc DO_NOT_TRACK=1 theo README.
```

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

```steps
- Kiểm tra Node.js | Đảm bảo máy dùng Node.js 22.20.0 trở lên
- Mở thư mục dự án | Chọn đúng nơi muốn cài skill
- Tìm skill | Duyệt các skill có sẵn bằng CLI
- Cài skill | Chọn skill và coding agent phù hợp
- Kiểm tra cài đặt | Liệt kê hoặc kiểm tra skill đã có
```

### Kiểm tra phiên bản Node.js

Cài Node.js trước rồi mở terminal. README chỉ nêu yêu cầu Node.js 22.20 trở lên; bạn cần bảo đảm phiên bản đang dùng đáp ứng yêu cầu này trước khi chạy npx.

Nếu terminal đang mở ở thư mục khác, bạn có thể chuyển đến thư mục dự án trước. README cho phép chạy lệnh cài từ project hiện tại.

```bash
node --version
```

Lệnh trên là lệnh kiểm tra phổ thông để xem phiên bản Node.js. Nếu kết quả thấp hơn 22.20.0, hãy nâng cấp Node.js rồi mở lại terminal.

### Mở hoặc tải mã nguồn repo

Nếu bạn chỉ muốn dùng CLI, có thể chạy npx trong dự án của mình mà không cần clone repo. Nếu muốn đọc mã nguồn, test hoặc xem các tài liệu trong repo, bạn có thể tải repo bằng Git.

```bash
git clone https://github.com/vercel-labs/skills.git
cd skills
```

Lệnh đầu tiên tải repo về máy. Lệnh thứ hai đi vào thư mục repo. Đây là cách xem các thư mục như `docs/`, `src/`, `tests/` và file `package.json`. README không yêu cầu bạn phải clone repo để cài skill.

### Tìm skill trước khi cài

Đứng trong thư mục dự án mà bạn muốn sử dụng skill, sau đó chạy lệnh tìm kiếm. Bạn có thể bắt đầu bằng cách duyệt toàn bộ danh sách.

```bash
npx skills find
```

README cũng cho phép tìm theo truy vấn bằng cách thêm từ khóa sau `find`. Nếu bạn chưa biết chính xác tên skill, hãy bắt đầu với lệnh không có truy vấn rồi chọn từ danh sách hiển thị.

### Cài một skill cho coding agent

README dùng repo nguồn `vercel-labs/agent-skills` trong ví dụ cài đặt. Lệnh này chạy từ project hiện tại và cho phép bạn chọn skill cùng coding agent.

```bash
npx skills add vercel-labs/agent-skills
```

Khi CLI hỏi, bạn chọn skill và coding agent muốn cài. Skill được cài vào project hiện tại theo mặc định. Nếu terminal đang ở sai thư mục, skill sẽ được đưa vào sai project.

Để chọn thẳng một skill và agent, dùng ví dụ có trong README:

```bash
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
```

Ở đây, `--skill web-design-guidelines` chỉ định skill cần cài. Tùy chọn `-a claude-code` chỉ định Claude Code là agent nhận skill. Nếu bạn dùng agent khác, hãy xem danh sách agent được hỗ trợ trong tài liệu của repo trước khi chọn tên.

Muốn cài skill dùng chung cho nhiều dự án, README nêu tùy chọn `-g`. Tư liệu không đưa một lệnh đầy đủ có `-g`, nên bạn nên xem installation reference để ghép tùy chọn đúng với nguồn và skill cần dùng.

### Dùng skill mà không cài

Nếu chỉ muốn thử skill hoặc tạo prompt, dùng `skills use` với tên skill. README có ví dụ chạy skill từ repo nguồn:

```bash
npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-code
```

Tùy chọn `--agent claude-code` yêu cầu CLI khởi chạy agent được chỉ định cùng skill. Nếu bỏ `--agent`, CLI chỉ in prompt ra màn hình. Đây là lựa chọn phù hợp khi bạn chưa muốn thay đổi danh sách skill đã cài trong project.

### Xem và cập nhật skill

Sau khi cài, bạn có thể xem danh sách skill, kiểm tra bản cập nhật hoặc cập nhật các skill đã chọn.

```bash
npx skills list
npx skills check
npx skills update [skills...]
```

`list` liệt kê skill đã cài. `check` kiểm tra các bản cập nhật có sẵn. `update [skills...]` cập nhật những skill được chỉ định; phần `[skills...]` là chỗ đặt tên skill theo cú pháp CLI.

Khi không còn cần một skill, README cung cấp lệnh remove:

```bash
npx skills remove [skills...]
```

Hãy kiểm tra tên skill trước khi gỡ để tránh xóa nhầm hướng dẫn mà các thành viên khác đang dùng trong dự án.

### Tạo skill riêng

Để tạo bộ hướng dẫn mới, chạy:

```bash
npx skills init my-skill
```

CLI tạo một skill template tên `my-skill`. Sau đó, bạn chỉnh sửa `SKILL.md` được tạo ra để thêm hướng dẫn cho agent. README yêu cầu xem tài liệu creating skills để biết format và quy tắc discovery đầy đủ.

### Dùng tính năng đồng bộ thử nghiệm

Nếu dự án đã có npm dependency chứa instruction cho agent, README đưa ví dụ cài dependency rồi đồng bộ:

```bash
npm install -D skills agent-browser
npx skills experimental_sync -y
```

`experimental_sync` là tính năng preview. README cảnh báo các lệnh bắt đầu bằng `experimental_` có thể thay đổi hoặc bị xóa. Chỉ dùng khi bạn hiểu dependency nào đang cung cấp skill và chấp nhận việc cấu hình có thể thay đổi.

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

Cách đơn giản nhất là chạy lệnh tìm kiếm:

```bash
npx skills find
```

Nếu CLI mở được danh sách hoặc giao diện chọn skill, npx và CLI đã chạy. Sau khi cài, dùng:

```bash
npx skills list
```

Kết quả mong đợi là danh sách các skill đã được cài trong project hoặc phạm vi tương ứng. Bạn cũng có thể chạy `npx skills check` để xem CLI có phát hiện bản cập nhật hay vấn đề liên quan đến skill hay không.

Nếu project có `skills-lock.json`, file này ghi nhận thông tin hash của skill. Với Git source, file còn ghi commit nguồn. Đây là dấu hiệu giúp bạn kiểm tra việc cài đặt đang được khóa theo phiên bản nào.

Một cách kiểm tra khác là dùng skill trực tiếp:

```bash
npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-code
```

Nếu CLI tạo prompt hoặc khởi chạy agent được chỉ định, lệnh đã hoạt động đúng theo README. Khi bạn bỏ `--agent`, kết quả mong đợi là prompt được in ra để bạn xem hoặc đưa vào quy trình khác.

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

### Chủ shop cần làm lại giao diện trang bán hàng

Một chủ shop có project web và muốn coding agent chú ý đến các hướng dẫn thiết kế giao diện. Bạn mở terminal trong thư mục project, tìm skill rồi cài skill `web-design-guidelines` cho agent phù hợp.

```bash
npx skills find
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
```

Sau đó dùng Claude Code trong project. Skill được đưa vào phạm vi project, giúp agent có thêm bộ hướng dẫn khi xử lý công việc giao diện. Kết quả cụ thể phụ thuộc vào nội dung skill và agent bạn chọn.

### Nhân viên văn phòng muốn thử prompt có sẵn

Một nhân viên đang dùng coding agent để tự động hóa một tác vụ nhỏ nhưng chưa muốn cài thêm skill vào project. Người này dùng lệnh `skills use` và bỏ `--agent`.

```bash
npx skills use vercel-labs/agent-skills@web-design-guidelines
```

CLI in prompt ra màn hình. Người dùng có thể đọc prompt, đánh giá cách skill hướng dẫn agent rồi quyết định có cài chính thức hay không. Cách này giảm thay đổi không cần thiết trong project.

### Dev muốn giữ quy trình ổn định giữa các máy

Một nhóm dev dùng chung project và muốn các thành viên cài đúng nội dung skill. Nhóm commit `skills-lock.json` cùng project, sau đó dùng các lệnh list, check và update để quản lý skill.

```bash
npx skills list
npx skills check
npx skills update [skills...]
```

Lock file ghi computed hash của các file được cài. Với skill từ Git, commit nguồn cũng được ghi lại. Nhờ đó, khi khôi phục project, CLI có thể lấy đúng commit đã ghi thay vì tự động lấy phiên bản mới nhất.

### Nhóm phát triển tạo checklist nội bộ

Một nhóm muốn agent tuân thủ cách review code hoặc quy tắc làm việc riêng. Người phụ trách tạo template skill:

```bash
npx skills init team-review
```

Sau đó, họ chỉnh sửa `SKILL.md` theo tài liệu creating skills. Skill này có thể trở thành một bộ hướng dẫn dùng lại cho các thành viên và các project phù hợp.

> Skill tốt biến quy trình lặp lại của cả nhóm thành hướng dẫn mà coding agent có thể dùng lại.
>
> — Ông T

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

### Node.js quá cũ

Đây là lỗi dễ gặp nhất vì README yêu cầu Node.js 22.20.0 trở lên. Kiểm tra phiên bản bằng `node --version`, sau đó nâng cấp Node.js nếu kết quả thấp hơn yêu cầu. Mở terminal mới sau khi nâng cấp để npx nhận đúng phiên bản.

### Chạy lệnh ở sai thư mục

Skill được cài vào project hiện tại theo mặc định. Nếu bạn đang đứng ở thư mục cá nhân hoặc một project khác, kết quả sẽ không nằm ở nơi mong muốn. Hãy dùng `cd` để vào đúng thư mục trước khi chạy `npx skills add`.

### Chọn sai coding agent

README cho biết CLI phát hiện agent đã cài và cho phép chọn nơi cài skill. Nếu chọn một agent chưa có trên máy hoặc dùng sai tên agent, quá trình cài có thể không đem lại kết quả như mong đợi. Hãy xem danh sách agent được hỗ trợ trong tài liệu của repo và kiểm tra agent đó đã được cài.

### Không thấy skill sau khi cài

Dùng `npx skills list` để kiểm tra danh sách. Nếu bạn cài ở project hiện tại nhưng lại kiểm tra từ project khác, bạn có thể đang nhìn nhầm phạm vi. Nếu dùng skill dùng chung, kiểm tra lại tùy chọn `-g` và đường dẫn cài đặt trong tài liệu.

### Lock file báo nội dung không khớp

`skills-lock.json` dùng computed hash để so sánh nội dung skill trên máy. Nếu file skill bị chỉnh sửa, hash có thể không còn khớp. Với version 1 lock, README cho biết việc nâng cấp được thực hiện khi đọc mà không cần network; các entry không thể xác minh có thể nhận hash rỗng và cần cài lại bằng `skills install` trước khi dùng `--frozen-lockfile`.

### Telemetry không phù hợp với chính sách nhóm

CLI thu thập dữ liệu sử dụng ẩn danh và có các yêu cầu security audit. Nếu chính sách nội bộ không cho phép, README hướng dẫn đặt `DISABLE_TELEMETRY=1` hoặc `DO_NOT_TRACK=1`. Hãy thống nhất biến môi trường này trong nhóm trước khi đưa vào script dùng chung.

## Có nên dùng không

Nên dùng nếu bạn đang làm việc với coding agent và muốn quản lý instruction theo project thay vì tự sao chép file. CLI có đủ luồng cơ bản: tìm skill, cài cho agent, dùng tạm, liệt kê, kiểm tra, cập nhật, gỡ và tạo skill mới. Việc chạy bằng npx cũng giúp người mới bắt đầu nhanh.

Điểm mạnh khác là lock file ghi hash nội dung và commit Git. Đây là phần hữu ích với nhóm cần kết quả có thể lặp lại. Repo cũng hỗ trợ nhiều coding agent, gồm OpenCode, Claude Code, Codex, Cursor và nhiều agent khác.

Giới hạn là README không mô tả chi tiết yêu cầu hệ điều hành, không cung cấp đầy đủ danh sách skill trong phần tư liệu này và không nói rõ chi phí của từng coding agent. Các tính năng `experimental_` có thể thay đổi hoặc bị loại bỏ. Bạn cũng cần tự kiểm tra nội dung skill trước khi cho agent dùng trong project quan trọng.

Nếu bạn chỉ cần một prompt đơn lẻ, `skills use` có thể phù hợp hơn việc cài skill lâu dài. Nếu nhóm không dùng coding agent hoặc không cần chia sẻ instruction, CLI này có thể là thêm một lớp quản lý không cần thiết. Còn nếu bạn muốn chuẩn hóa cách agent làm việc trong nhiều project, vercel-labs/skills là lựa chọn đáng thử, miễn là máy đáp ứng Node.js 22.20.0 trở lên và nhóm chấp nhận cách quản lý skill theo lock file.

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

### vercel-labs/skills có miễn phí không?

Repo có giấy phép MIT. README không nêu chi phí sử dụng CLI hoặc chi phí của các coding agent và skill riêng lẻ, nên chưa thể kết luận toàn bộ hệ sinh thái đều miễn phí.

### Có cần GPU hoặc API key không?

README chỉ yêu cầu Node.js 22.20 trở lên và không nêu yêu cầu GPU hay API key. Các yêu cầu riêng của coding agent bạn dùng có thể khác, nhưng không được mô tả trong tư liệu này.

### Có chạy được trên Windows không?

Tư liệu được cung cấp không nêu hệ điều hành được hỗ trợ. README chỉ đưa các lệnh CLI và yêu cầu Node.js 22.20 trở lên, nên chưa có thông tin xác nhận riêng cho Windows.

### Có phải clone repo mới dùng được không?

Không bắt buộc. README hướng dẫn chạy CLI bằng npx trong project hiện tại. Clone repo chỉ cần thiết nếu bạn muốn xem hoặc phát triển mã nguồn của chính dự án.

### Skill được cài ở đâu?

Theo README, skill được cài vào project hiện tại theo mặc định. Tùy chọn `-g` giúp skill dùng được ở nhiều project. Đường dẫn cụ thể phụ thuộc coding agent và được mô tả trong tài liệu supported agents.

### Dữ liệu sử dụng có được gửi đi không?

README cho biết CLI thu thập dữ liệu sử dụng ẩn danh và thực hiện các yêu cầu security audit. Có thể tắt bằng `DISABLE_TELEMETRY=1` hoặc `DO_NOT_TRACK=1`.

### vercel-labs/skills khác gì việc tự chép file hướng dẫn vào project?

CLI cung cấp luồng tìm, cài, dùng, cập nhật và gỡ skill, đồng thời ghi hash và commit trong lock file. Nhờ vậy việc quản lý instruction có cấu trúc và dễ kiểm tra hơn, thay vì tự sao chép thủ công.
