# vercel-labs/skills: cài và quản lý kỹ năng cho AI agent

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

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-30 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/vercel-labs-skills-ky-nang-ai-agent

vercel-labs/skills là CLI giúp tìm, cài đặt và quản lý các kỹ năng cho coding agent. Một skill là tập hướng dẫn tái sử dụng, giúp agent thực hiện những loại việc như review code hoặc làm việc với một thư viện.

Công cụ này phù hợp với lập trình viên mới, đội phát triển phần mềm và người dùng các coding agent như OpenCode, Claude Code, Codex hoặc Cursor. Điểm đáng giá nhất là bạn có thể cài skill vào từng dự án hoặc dùng chung cho nhiều dự án, rồi kiểm tra cập nhật và khôi phục phiên bản đã ghi trong lock file.

Repo hiện có khoảng 39209 sao và 3437 fork. Dự án viết chủ yếu bằng TypeScript, dùng giấy phép MIT, có lệnh CLI tên `skills` và vẫn còn được cập nhật.

```repo
- repo | vercel-labs/skills
- kind | CLI
- desc | CLI giúp tìm, cài đặt, cập nhật và sử dụng các kỹ năng cho nhiều coding agent như Claude Code, Codex, Cursor và OpenCode.
- stars | 39k
- lang | TypeScript
- license | MIT
```

## skills làm được gì

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

Bạn có thể tìm các skill có sẵn bằng `npx skills find`. Đây là cách bắt đầu khi bạn chưa biết chính xác skill nào phù hợp với công việc. Kết quả giúp bạn duyệt danh sách trước khi chọn cài.

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

Lệnh `npx skills add` 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ó bộ quy tắc hoặc hướng dẫn riêng. Skill được đặt trong phạm vi dự án, nên các thành viên cùng làm việc trên dự án có thể dùng cùng cấu hình nếu phần đó được quản lý chung.

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

Thêm tùy chọn `-g` để skill có thể dùng trên nhiều dự án. Đây là lựa chọn tiện cho một người thường xuyên làm cùng một loại công việc ở nhiều thư mục khác nhau.

### Chọn skill và coding agent đích

Bạn có thể chỉ định một skill bằng `--skill` và chỉ định agent bằng `-a`. Ví dụ trong README cài `web-design-guidelines` cho Claude Code. CLI phát hiện các agent được hỗ trợ và cho phép bạn chọn nơi cài tương ứng.

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

Lệnh `npx skills use` có thể tạo prompt cho một skill hoặc khởi chạy coding agent được hỗ trợ cùng skill đó. Nếu bỏ `--agent`, CLI in prompt ra thay vì khởi chạy agent. Cách này hữu ích khi bạn chỉ muốn xem hoặc dùng một skill cho một lần.

### Quản lý vòng đời skill

CLI có các lệnh để liệt kê skill đã cài, kiểm tra bản cập nhật, cập nhật và gỡ skill. Nhờ vậy, bạn không phải tự nhớ từng thư mục đã cài hay tự thay file hướng dẫn bằng tay.

### Ghi nhận trạng thái bằng lock file

`skills-lock.json` phiên bản 2 ghi lại `computedHash` của từng skill trong dự án. Hash được tính từ các file mà CLI cài vào `.agents/skills/<name>`, giúp lệnh `list`, `check` và cài đặt với `--frozen-lockfile` phát hiện nội dung trên máy có khớp hay không.

Với nguồn Git, lock file còn ghi commit mà skill được lấy từ đó. Khi khôi phục, CLI lấy đúng commit đã ghi thay vì tự động lấy commit mới nhất. Điều này giúp môi trường của các thành viên ổn định hơn khi repo nguồn thay đổi.

### Tạo khung skill mới

Lệnh `npx skills init my-skill` tạo một template skill. Sau đó bạn chỉnh file `SKILL.md` để viết hướng dẫn cho agent. Tính năng này phù hợp với đội muốn chuẩn hóa quy trình riêng, chẳng hạn quy tắc review code hoặc cách làm việc với một thư viện nội bộ.

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

Repo có hai tính năng thử nghiệm. `experimental_sync` đồng bộ các hướng dẫn được đóng gói cùng npm dependency vào dự án. `experimental_install` khôi phục các project skill được ghi trong `skills-lock.json`. Các lệnh này có thể thay đổi hoặc bị xóa 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 trở lên. Đây là yêu cầu được ghi trong README và cũng là yêu cầu của `package.json`.

Bạn cần một project để chạy lệnh cài skill nếu muốn cài theo phạm vi dự án. README hướng dẫn chạy lệnh từ project hiện tại. Nếu dùng tùy chọn `-g`, skill được cài để dùng trên nhiều project.

Bạn cần có coding agent được CLI hỗ trợ nếu muốn cài skill vào agent hoặc khởi chạy agent bằng `skills use`. README nêu các agent gồm OpenCode, Claude Code, Codex, Cursor và 75 agent khác, nhưng không liệt kê toàn bộ tên hay yêu cầu cài đặt riêng của từng agent.

Bạn không cần API key theo phần tư liệu được cung cấp. README cũng không nêu yêu cầu GPU, tài khoản trả phí hay phần cứng đặc biệt.

CLI có thu thập dữ liệu sử dụng ẩn danh và gửi các yêu cầu kiểm tra bảo mật. Nếu không muốn dùng telemetry, bạn có thể tắt bằng biến môi trường `DISABLE_TELEMETRY=1` hoặc `DO_NOT_TRACK=1`.

```note
Skill là các file hướng dẫn được đưa vào coding agent. Hãy xem nội dung skill trước khi dùng trong dự án quan trọng, vì hướng dẫn của skill có thể ảnh hưởng đến cách agent thực hiện công việc.
```

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

```steps
- Kiểm tra Node.js | Bảo đảm máy dùng Node.js 22.20 trở lên
- Chọn project | Mở terminal tại project muốn cài skill
- Tìm và cài skill | Duyệt skill rồi thêm skill vào project hoặc dùng chung
- Kiểm tra và sử dụng | Liệt kê, chạy thử hoặc tạo prompt từ skill
```

### Kiểm tra môi trường Node.js

Cài Node.js 22.20 trở lên trước khi chạy CLI. README chỉ nêu yêu cầu phiên bản, không đưa lệnh cài Node.js cho từng hệ điều hành. Bạn nên kiểm tra phiên bản trong terminal mà mình sẽ dùng để chạy các lệnh tiếp theo.

```bash
node --version
```

Nếu phiên bản thấp hơn 22.20, hãy nâng cấp Node.js trước. Người mới thường mở nhầm terminal cũ sau khi nâng cấp, nên nếu kết quả chưa đổi thì đóng và mở lại terminal rồi kiểm tra lại.

### Mở terminal tại project

README yêu cầu chạy lệnh cài skill từ project. Trên Windows, bạn có thể mở PowerShell tại thư mục project. Trên macOS hoặc Linux, mở Terminal rồi chuyển đến thư mục project bằng lệnh `cd` quen thuộc.

Nếu bạn đã có source repo của riêng mình, hãy đứng trong thư mục chứa file dự án trước khi chạy `npx skills add`. README không yêu cầu clone repo `vercel-labs/skills` để dùng CLI; `npx` sẽ chạy gói CLI `skills`.

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

Dùng lệnh sau để duyệt các skill có sẵn:

```bash
npx skills find
```

Bạn cũng có thể tìm theo truy vấn:

```bash
npx skills find [query]
```

Thay `[query]` bằng từ khóa phù hợp với công việc. Đây là placeholder trong cú pháp CLI, không phải chuỗi cần gõ nguyên văn. Nếu chưa biết tên skill, chạy lệnh không có truy vấn trước để xem danh sách.

### Cài skill vào project

Lệnh cài cơ bản được README cung cấp là:

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

Chạy lệnh này khi terminal đang ở project muốn sử dụng skill. CLI sẽ cho bạn chọn skill và coding agent đích. Theo README, skill được cài vào project hiện tại theo mặc định.

Nếu muốn cài một skill cụ thể cho một agent cụ thể, dùng ví dụ có sẵn:

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

Trong ví dụ này, `web-design-guidelines` là tên skill và `claude-code` là agent đích. Chỉ thay các giá trị này khi bạn biết tên skill và tên agent được CLI hỗ trợ. Người mới hay nhầm `-a` là tên tài khoản; ở đây nó dùng để chọn coding agent.

Muốn dùng skill trên nhiều project, thêm `-g` theo hướng dẫn README:

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

README không đưa ví dụ kết hợp `-g` với mọi tùy chọn khác, nên hãy xem phần installation reference hoặc chạy trợ giúp nếu cần thêm cờ.

### Dùng skill không cần cài

Bạn có thể dùng một skill trực tiếp bằng lệnh:

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

Lệnh này dùng skill `web-design-guidelines` cùng Claude Code. Nếu bỏ phần `--agent claude-code`, CLI sẽ in prompt ra màn hình:

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

Cách này thích hợp khi bạn chỉ muốn lấy prompt hoặc thử skill trước khi quyết định cài vào project.

### Xem trợ giúp và quản lý skill

README liệt kê các lệnh quản lý chính:

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

`list` liệt kê skill đã cài. `check` kiểm tra bản cập nhật. `update [skills...]` cập nhật các skill được chỉ định; placeholder `[skills...]` đại diện cho một hoặc nhiều skill. `remove [skills...]` gỡ skill đã chọn.

Khi quên cú pháp, chạy:

```bash
npx skills --help
```

### Tạo skill riêng

Nếu muốn viết hướng dẫn riêng cho agent, chạy:

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

CLI tạo template có tên `my-skill`. Bạn chỉnh file `SKILL.md` được tạo ra theo hướng dẫn trong tài liệu của repo. README không cung cấp nội dung mẫu hoàn chỉnh cho `SKILL.md`, nên hãy xem phần creating skills trong tài liệu của dự án trước khi chia sẻ skill cho người khác.

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

README đưa ví dụ cho tính năng thử nghiệm này:

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

Lệnh đầu tiên cài `skills` và `agent-browser` dưới dạng development dependency. Lệnh thứ hai đồng bộ các skill được đóng gói cùng dependency. Vì đây là tính năng experimental, tên lệnh hoặc tùy chọn có thể thay đổi.

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

Cách đơn giản nhất là chạy lệnh trợ giúp:

```bash
npx skills --help
```

Nếu CLI chạy được và hiển thị các lệnh, môi trường Node.js đã gọi được gói `skills`.

Sau khi cài skill, chạy:

```bash
npx skills list
```

Kết quả mong đợi là danh sách skill đã được cài. Bạn cũng có thể chạy `npx skills check` để xem skill có bản cập nhật hay không. README không đưa ảnh màn hình hoặc một output cố định, nên không nên đối chiếu theo đúng từng dòng chữ.

Nếu dùng cách không cài, chạy lệnh `skills use` và kiểm tra xem CLI in prompt hoặc khởi chạy agent đã chọn. Khi bỏ `--agent`, kết quả mong đợi là prompt được in ra màn hình.

Nếu tạo skill riêng, kiểm tra thư mục template được tạo và file `SKILL.md` bên trong. README xác nhận CLI tạo skill template, nhưng không mô tả toàn bộ danh sách file đầu ra.

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

### Lập trình viên muốn chuẩn hóa thiết kế giao diện

Một dev đang làm project web và muốn coding agent tuân theo bộ hướng dẫn thiết kế có sẵn. Người đó đứng trong thư mục project rồi chạy:

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

Sau khi chọn xong, Claude Code có thể sử dụng skill đã cài khi làm việc trong project. Kết quả cụ thể phụ thuộc vào nội dung skill và agent, nhưng quy trình cài đặt đã gắn đúng skill với Claude Code theo ví dụ chính thức.

### Nhân viên văn phòng muốn thử prompt trước

Một nhân viên dùng coding agent để hỗ trợ một project nhỏ nhưng chưa muốn cài thêm file vào project. Họ chạy:

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

CLI in prompt của skill ra màn hình. Người dùng có thể xem prompt và đưa nó vào quy trình làm việc phù hợp. Đây là cách thử một skill mà không cần cài trực tiếp vào project.

### Chủ shop có người quản lý website

Chủ shop không trực tiếp viết code nhưng muốn đội làm website dùng chung một bộ hướng dẫn. Người phụ trách có thể cài skill ở phạm vi project bằng:

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

Sau đó chọn skill và agent trong phần tương tác của CLI. Cách cài theo project giúp bộ hướng dẫn gắn với đúng website thay vì tự động áp dụng cho mọi thư mục trên máy.

### Đội phát triển muốn tự tạo quy trình riêng

Một đội dev muốn agent tuân theo quy tắc nội bộ. Họ tạo khung skill:

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

Tiếp theo, họ chỉnh `SKILL.md` với hướng dẫn review code của đội. README cho biết đây là file hướng dẫn agent, nên kết quả là một skill template có thể tiếp tục hoàn thiện theo format của dự án.

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

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

### Node.js quá cũ

Lỗi dễ gặp nhất là chạy CLI trên Node.js thấp hơn 22.20. Hãy kiểm tra bằng `node --version` và nâng cấp Node.js. Sau khi nâng cấp, mở terminal mới rồi chạy lại lệnh.

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

README yêu cầu chạy lệnh cài từ project. Nếu cài nhầm ở thư mục khác, skill có thể không xuất hiện ở project bạn đang làm. Hãy chuyển terminal về đúng thư mục project rồi chạy lại lệnh cài.

### Nhầm tên skill hoặc agent

Tên skill và tên agent trong lệnh phải khớp với những gì CLI hỗ trợ. Hãy chạy `npx skills find` để duyệt skill và dùng `npx skills --help` khi cần xem cú pháp. Không nên tự đoán thêm tên tùy chọn chưa được tài liệu xác nhận.

### Skill chưa được cập nhật

Nếu nội dung skill cũ, chạy:

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

`check` giúp kiểm tra trước, còn `update` cập nhật skill được chọn. Nếu project dùng lock file, hãy lưu ý việc khôi phục có thể lấy đúng commit đã ghi thay vì commit mới nhất.

### Không muốn gửi telemetry

CLI thu thập dữ liệu sử dụng ẩn danh và có các yêu cầu kiểm tra bảo mật. Nếu chính sách công ty không cho phép, đặt `DISABLE_TELEMETRY=1` hoặc `DO_NOT_TRACK=1` theo README trước khi chạy CLI. Tư liệu không mô tả chi tiết từng loại dữ liệu được thu thập.

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

Nên dùng nếu bạn thường xuyên làm việc với coding agent và muốn quản lý các bộ hướng dẫn theo cách có tổ chức. CLI hỗ trợ tìm, cài, dùng thử, cập nhật, gỡ và tạo skill. Việc hỗ trợ nhiều agent cũng giúp bạn không phải xây lại cùng một quy trình từ đầu khi đổi công cụ.

Tính năng lock file là điểm mạnh cho team. Việc ghi hash và commit giúp phát hiện skill đã thay đổi, đồng thời giúp khôi phục đúng phiên bản nguồn. Repo cũng có API lập trình với hàm `installSkills`, phù hợp nếu bạn muốn tích hợp quản lý skill vào công cụ riêng.

Giới hạn là yêu cầu Node.js khá mới, từ 22.20 trở lên. README không nói chi tiết cách cài Node.js trên Windows, macOS hoặc Linux, cũng không mô tả đầy đủ output của từng lệnh. Một số tính năng như `experimental_sync` và `experimental_install` chưa ổn định theo tuyên bố của chính dự án.

Bạn nên chọn công cụ khác hoặc cách thủ công nếu chỉ cần một file hướng dẫn đơn giản cho một agent duy nhất, hoặc nếu môi trường không thể dùng Node.js 22.20 trở lên. Nếu cần kiểm soát nghiêm ngặt, hãy đọc nội dung từng skill, kiểm tra quyền mà agent có thể sử dụng và cân nhắc telemetry trước khi đưa vào project quan trọng.

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

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

Repo được phát hành theo giấy phép MIT. Tư liệu được cung cấp không nêu phí sử dụng dịch vụ hay chi phí của từng coding agent, nên chưa thể khẳng định toàn bộ quy trình luôn miễn phí.

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

README không nêu yêu cầu GPU hay API key. Điều kiện được ghi rõ là Node.js 22.20 trở lên và một coding agent được hỗ trợ nếu bạn muốn cài hoặc khởi chạy skill cùng agent.

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

Tư liệu không nêu danh sách hệ điều hành được hỗ trợ. README chỉ yêu cầu Node.js 22.20 trở lên và hướng dẫn chạy lệnh từ project, nên chưa có đủ thông tin để xác nhận riêng cho Windows.

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

Theo README, skill được cài vào project hiện tại theo mặc định. Thêm `-g` để làm skill có sẵn trên nhiều project.

### Dữ liệu dùng CLI có an toàn không?

CLI có thu thập dữ liệu sử dụng ẩn danh và gửi các yêu cầu kiểm tra bảo mật. README cho phép tắt bằng `DISABLE_TELEMETRY=1` hoặc `DO_NOT_TRACK=1`, nhưng không mô tả chi tiết toàn bộ dữ liệu được thu thập.

### Có thể dùng skill mà không cài không?

Có. Lệnh `npx skills use vercel-labs/agent-skills@web-design-guidelines` tạo prompt nếu bạn không thêm `--agent`; thêm tùy chọn này để khởi chạy coding agent được hỗ trợ cùng skill.

### Repo này khác gì việc tự chép file hướng dẫn vào project?

CLI cung cấp thêm tìm kiếm, chọn agent, cập nhật, gỡ, kiểm tra hash và ghi commit vào lock file. README không đưa so sánh trực tiếp với một công cụ khác, nhưng các tính năng này giúp việc quản lý skill có quy trình rõ ràng hơn.
