# vercel-labs/skills: cài kỹ năng cho AI lập trình bằng một lệnh — hướng dẫn cài đặt và dùng

> vercel-labs/skills là công cụ dòng lệnh (gói npm tên skills) để cài và quản lý các agent skill, tức bộ hướng dẫn dạy trợ lý AI lập trình làm một việc cụ thể. Bạn chỉ cần Node.js 22.20 trở lên và gõ npx skills add kèm tên repo là cài được. Cài không khó, nhưng phải mở terminal đúng thư mục dự án.

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

**vercel-labs/skills là công cụ dòng lệnh (chạy bằng `npx skills`) để tìm, cài, cập nhật và gỡ các "agent skill"** — tức những bộ hướng dẫn có thể dùng lại, dạy trợ lý AI lập trình cách làm một việc cụ thể, từ review code đến dùng đúng một thư viện nào đó. Repo hiện có khoảng 39.150 sao và 3.432 fork, giấy phép MIT, viết bằng TypeScript.

Nếu bạn đang dùng Claude Code, Codex, Cursor hay OpenCode, bạn sẽ gặp một chuyện: mỗi trợ lý để file hướng dẫn ở một thư mục khác nhau, tự copy rất rối. Công cụ này lo phần đó. Bạn chọn skill, chọn trợ lý, nó đặt file vào đúng chỗ. README ghi hỗ trợ OpenCode, Claude Code, Codex, Cursor và 75 trợ lý khác.

Điểm đáng giá nhất là bạn không phải tự viết skill từ đầu. Có sẵn một thư viện skill để duyệt tại skills.sh, và một lệnh duy nhất là cài xong. Bài này hướng dẫn từ cài Node, chạy lệnh đầu tiên, đến các tình huống dùng thật.

```repo
- repo | vercel-labs/skills
- kind | CLI
- desc | Công cụ dòng lệnh npx skills giúp tìm, cài, cập nhật và gỡ các agent skill cho Claude Code, Codex, Cursor, OpenCode và hơn 70 trợ lý AI khác.
- stars | 39k
- lang | TypeScript
- license | MIT
```

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

**Cài skill từ một repo GitHub bằng một lệnh.** Bạn đưa tên repo cho `npx skills add`, công cụ cho bạn chọn skill nào, cài cho trợ lý nào. Không cần clone tay hay copy file.

**Cài theo dự án hoặc cài chung cho mọi dự án.** Mặc định skill được cài vào dự án hiện tại. Thêm `-g` thì skill dùng được ở mọi dự án trên máy. Dự án cần quy tắc riêng thì cài theo dự án; thói quen cá nhân thì cài chung.

**Tìm skill ngay trong terminal.** Lệnh `npx skills find` giúp bạn duyệt và tìm kiếm mà không cần mở trình duyệt.

**Quản lý vòng đời skill.** Có lệnh xem skill đã cài (`list`), kiểm tra có bản mới không (`check`), cập nhật (`update`) và gỡ (`remove`). Skill cũng giống phần mềm: tác giả sửa lỗi thì bạn nên cập nhật.

**Dùng thử mà không cài.** Lệnh `npx skills use` tạo ra một prompt từ skill, hoặc mở thẳng trợ lý được hỗ trợ kèm skill đó. Hợp khi bạn chỉ muốn thử một lần.

**Tự tạo skill của mình.** `npx skills init` sinh ra một khung skill, bạn chỉ việc viết hướng dẫn vào file `SKILL.md`. Công ty có quy trình riêng có thể đóng gói thành skill cho cả nhóm dùng.

**Khóa phiên bản bằng `skills-lock.json`.** Công cụ ghi lại mỗi skill của dự án kèm mã băm nội dung (và commit nếu nguồn là Git). Nhờ đó cả nhóm cài lại được đúng bản cũ, kể cả khi repo gốc đã đổi. Phần này hơi kỹ thuật, người mới có thể bỏ qua lúc đầu.

**Có tính năng thử nghiệm.** Hai lệnh `experimental_sync` và `experimental_install` đồng bộ skill đi kèm gói npm và khôi phục skill từ file khóa. README nói rõ tên và hành vi của chúng có thể đổi hoặc bị bỏ bất cứ lúc nào, nên đừng dựa vào chúng cho việc quan trọng.

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

- **Node.js từ 22.20 trở lên.** README và `package.json` đều yêu cầu mức này. Bản Node cũ hơn có thể không chạy được.
- **Một trợ lý AI lập trình** trong danh sách hỗ trợ (Claude Code, Codex, Cursor, OpenCode…). Công cụ này chỉ đặt skill vào chỗ; nó không thay thế trợ lý.
- **Một terminal.** Trên Windows là PowerShell hoặc Terminal; trên macOS/Linux là Terminal.
- **Thư mục dự án** nếu bạn muốn cài theo dự án (cách mặc định).

Tư liệu không nói gì về GPU, cấu hình máy tối thiểu hay API key riêng của công cụ này. Bản thân trợ lý bạn dùng có thể cần tài khoản hoặc key riêng, việc đó nằm ngoài repo này.

```note
Công cụ có thu thập dữ liệu sử dụng ẩn danh. Muốn tắt, đặt biến môi trường DISABLE_TELEMETRY=1 hoặc DO_NOT_TRACK=1 (README ghi cả hai). Ngoài ra, skill thực chất là hướng dẫn cho AI làm việc trên máy bạn, nên chỉ cài skill từ nguồn bạn tin tưởng và đọc qua SKILL.md trước khi dùng.
```

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

Ý chính: công cụ này chạy bằng `npx`, nên bạn không cần cài gì lâu dài, chỉ cần có Node.js.

```steps
- Kiểm tra Node.js | Chạy node -v, cần từ 22.20 trở lên
- Mở terminal đúng thư mục | Vào thư mục dự án của bạn
- Chạy npx skills add | Chọn skill và trợ lý muốn cài
- Thêm -g nếu cần | Để skill dùng được ở mọi dự án
- Kiểm tra bằng npx skills list | Xem skill đã vào chưa
```

### Kiểm tra Node.js

Mở terminal và gõ lệnh dưới. Nếu số phiên bản nhỏ hơn 22.20, bạn cần cài Node mới trước (README không hướng dẫn cách cài Node, hãy tải từ trang chủ Node.js).

```bash
node -v
```

Lệnh `node -v` chỉ in ra phiên bản Node, ví dụ v22.x.x. Báo lỗi "không nhận ra lệnh" nghĩa là máy chưa có Node.

### Mở terminal ở thư mục dự án

Đây là chỗ người mới hay vấp nhất. Mặc định skill được cài vào dự án **hiện tại**, nên bạn phải đứng đúng thư mục trước khi chạy. Ví dụ:

```bash
cd đường-dẫn-tới-dự-án-của-bạn
```

Thay phần sau `cd` bằng đường dẫn thật của bạn. Trong VS Code, bạn có thể mở terminal tích hợp, nó tự đứng đúng thư mục.

### Cài skill đầu tiên

Lệnh mẫu trong README dùng repo skill của Vercel:

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

Lần đầu, `npx` có thể hỏi có tải gói `skills` về không; cứ đồng ý. Sau đó công cụ hiện danh sách để bạn chọn skill và trợ lý. Dùng phím mũi tên và theo hướng dẫn trên màn hình.

Muốn chọn sẵn một skill và một trợ lý, không cần hỏi lại:

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

`--skill` là tên skill, `-a` là tên trợ lý (ở đây là `claude-code`). Tên các trợ lý được hỗ trợ có trong tài liệu "Supported agents" của repo.

### Cài dùng chung cho mọi dự án

Thêm `-g`:

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

Cách này hợp với skill bạn muốn dùng ở mọi nơi. README chỉ nói `-g` giúp skill "dùng được ở nhiều dự án"; chi tiết thư mục đích xem ở tài liệu Supported agents trong repo.

### Duyệt skill có sẵn

```bash
npx skills find
```

Bạn cũng có thể truyền từ khóa: `npx skills find [query]`, trong đó `[query]` thay bằng chủ đề bạn quan tâm. Danh mục đầy đủ có ở skills.sh.

Với repo riêng tư hoặc các kiểu nguồn khác, README chỉ trỏ tới "installation reference" trong tài liệu repo (thư mục `docs/`). README chưa ghi chi tiết ở phần chính, bạn xem ở đó.

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

Sau khi cài xong, chạy:

```bash
npx skills list
```

Lệnh này liệt kê các skill đã cài. Thấy tên skill vừa chọn là thành công. README không mô tả chính xác dòng chữ hiện ra, nên bạn hãy so tên skill với cái mình đã chọn.

Bước kiểm tra thứ hai: mở trợ lý AI trong cùng dự án và nhờ nó làm đúng việc skill hướng dẫn (ví dụ nhờ review giao diện nếu bạn cài `web-design-guidelines`). Nếu trợ lý làm theo các quy tắc của skill, mọi thứ đã khớp.

Cần xem các lựa chọn của từng lệnh thì chạy:

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

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

> Skill là cách biến một lần dặn AI thành một thói quen mà cả nhóm cùng dùng.
>
> — Ông T

### Lập trình viên mới muốn review giao diện web

Bạn vừa làm xong một trang web và không chắc nó có tuân thủ nguyên tắc thiết kế tốt không. Ở thư mục dự án, bạn cài skill mẫu:

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

Sau đó mở Claude Code và nhờ nó rà soát giao diện. Kết quả là trợ lý đánh giá dựa trên bộ hướng dẫn của skill thay vì chỉ theo cảm tính của nó. (Nội dung chi tiết của skill này README không mô tả, bạn nên mở `SKILL.md` đọc.)

### Người muốn thử trước khi quyết định cài

Bạn chưa chắc skill có hợp không. Dùng lệnh `use`, không cài gì vào dự án:

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

Có `--agent`, công cụ mở trợ lý được hỗ trợ kèm skill. Bỏ `--agent` đi, nó in ra prompt để bạn tự dán vào trợ lý bất kỳ. Rất tiện khi bạn dùng một trợ lý chưa hỗ trợ trực tiếp hoặc chỉ cần dùng một lần.

### Trưởng nhóm muốn cả team dùng chung một quy trình

Công ty bạn có quy trình review riêng. Bạn tạo khung skill:

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

Rồi mở file `SKILL.md` vừa sinh ra và viết hướng dẫn cho trợ lý: kiểm tra những gì, theo thứ tự nào, báo cáo thế nào. Hướng dẫn về định dạng (frontmatter, cấu trúc repo) nằm ở tài liệu "Creating skills" trong repo. Đưa skill lên một repo GitHub, đồng nghiệp chỉ cần `npx skills add <tên-repo>` là có cùng bộ quy tắc. Skill cài theo dự án còn được ghi vào `skills-lock.json` để mọi người cùng dùng đúng một phiên bản.

### Người dùng lâu ngày muốn giữ skill luôn mới

Sau vài tuần, bạn muốn biết skill nào có bản mới:

```bash
npx skills check
npx skills update
```

`check` chỉ báo có cập nhật hay không; `update` mới thực sự cập nhật (có thể thêm tên skill cụ thể). Skill nào không dùng nữa thì gỡ bằng `npx skills remove`, thêm tên skill nếu chỉ muốn gỡ một cái.

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

### Báo lỗi phiên bản Node hoặc chạy không lên

Nguyên nhân thường là Node cũ hơn 22.20. Chạy `node -v` để xem, rồi cài bản Node mới hơn. Đây là yêu cầu chính thức trong README và `package.json`.

### Skill cài xong mà trợ lý không thấy

Có hai khả năng hay gặp: bạn chọn nhầm trợ lý khi cài, hoặc bạn cài theo dự án ở thư mục này nhưng lại mở trợ lý ở thư mục khác. Chạy `npx skills list` trong đúng thư mục để kiểm tra. Nếu muốn dùng ở mọi nơi, cài lại với `-g`. Tên trợ lý đúng nằm trong tài liệu Supported agents.

### Gõ sai tên repo hoặc tên skill

Tên repo có dạng `chủ-sở-hữu/tên-repo`, tên skill phải đúng chính tả. Dùng `npx skills find` để xem tên có thật, hoặc cài không kèm `--skill` để chọn từ danh sách hiện ra.

### Dùng lệnh thử nghiệm rồi hành vi thay đổi

Các lệnh bắt đầu bằng `experimental_` có thể đổi tên, đổi tùy chọn hoặc bị xóa mà không báo trước. Nếu bạn dùng chúng trong quy trình của nhóm, hãy ghi chú phiên bản và đọc lại tài liệu mỗi khi nâng cấp.

### Muốn tắt thu thập dữ liệu nhưng không biết làm sao

Đặt biến môi trường `DISABLE_TELEMETRY=1` hoặc `DO_NOT_TRACK=1` trước khi chạy. Trong PowerShell bạn có thể gõ `$env:DISABLE_TELEMETRY = "1"` rồi chạy `npx skills ...` trong cùng cửa sổ. Biến này chỉ có hiệu lực trong cửa sổ đó; muốn đặt vĩnh viễn thì thêm vào cấu hình môi trường của hệ điều hành. README nói biến này tắt cả telemetry lẫn các yêu cầu kiểm tra bảo mật (security-audit).

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

**Điểm mạnh.** Một lệnh là cài được, hỗ trợ rất nhiều trợ lý, có đủ vòng đời tìm, cài, cập nhật, gỡ. Giấy phép MIT, repo còn được cập nhật trong vài tháng gần đây, và có cả thư viện skill công khai để tham khảo. Với người mới, đây là cách nhanh nhất để "dạy" trợ lý AI những quy tắc chuẩn mà không phải tự viết từ số không.

**Giới hạn.** Công cụ chỉ là người giao hàng: chất lượng còn lại phụ thuộc vào skill bạn cài. Skill kém hoặc không đáng tin có thể hướng dẫn trợ lý làm điều không mong muốn, nên hãy đọc `SKILL.md` trước. Bạn cần Node 22.20 trở lên, và công cụ có thu thập dữ liệu ẩn danh mặc định (tắt được). Một số tính năng còn ở mức thử nghiệm. Tư liệu cũng chưa nói gì về chi phí hay về cách chạy offline.

**Khi nào chọn cách khác.** Nếu bạn chỉ có một file hướng dẫn nhỏ cho một dự án và dùng đúng một trợ lý, tự đặt file vào đúng thư mục có thể đơn giản hơn. Nếu bạn không dùng trợ lý AI lập trình nào, công cụ này chưa có việc cho bạn. Còn lại, nếu bạn dùng một hoặc nhiều trợ lý và muốn quản lý skill gọn gàng, đây là lựa chọn rất đáng thử.

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

### skills của Vercel Labs có miễn phí không?

Repo dùng giấy phép MIT, nên bạn được dùng tự do theo giấy phép này. Tư liệu không nhắc đến phí cho chính công cụ. Tuy nhiên trợ lý AI bạn dùng cùng nó (Claude Code, Codex…) có thể có chi phí riêng, README không đề cập.

### Agent skill là gì?

Theo README, agent skill là những hướng dẫn có thể dùng lại, dạy trợ lý AI lập trình cách làm một việc, từ review code đến làm việc với một thư viện. Mỗi skill có một file SKILL.md chứa hướng dẫn đó.

### Cần cài gì trước khi dùng?

Bạn cần Node.js từ 22.20 trở lên, vì lệnh chạy qua npx. README không nêu yêu cầu nào khác như GPU hay API key riêng cho công cụ này.

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

README không nói riêng về hệ điều hành. Công cụ là gói npm chạy bằng Node.js nên về nguyên tắc chạy ở nơi có Node phù hợp, nhưng tư liệu chưa xác nhận cụ thể từng hệ điều hành, bạn nên thử và xem mục Troubleshooting trong tài liệu repo.

### Công cụ hỗ trợ những trợ lý AI nào?

README ghi hỗ trợ OpenCode, Claude Code, Codex, Cursor và 75 trợ lý khác. Danh sách đầy đủ, tên gọi và thư mục cài đặt nằm trong tài liệu Supported agents của repo.

### Công cụ có gửi dữ liệu của tôi đi đâu không?

Có thu thập dữ liệu sử dụng ẩn danh. Bạn tắt được bằng cách đặt DISABLE_TELEMETRY=1 hoặc DO_NOT_TRACK=1, việc này cũng tắt các yêu cầu kiểm tra bảo mật. Danh sách cụ thể dữ liệu thu thập nằm trong tài liệu của repo, bài này không có thông tin chi tiết.

### Cài skill theo dự án và cài với -g khác nhau thế nào?

Mặc định skill chỉ được cài vào dự án hiện tại. Thêm -g thì skill dùng được ở nhiều dự án. Nếu cần skill riêng cho từng dự án, đừng thêm -g.
