# agent-skills: bộ kỹ năng kỹ thuật chuẩn production cho AI viết code — hướng dẫn cài đặt và dùng

> agent-skills là bộ 25 skill dạng Markdown của Addy Osmani, dạy AI viết code (Claude Code, Cursor, Codex, Gemini CLI...) làm theo quy trình của kỹ sư lâu năm. Bộ này có 9 lệnh slash như /spec, /plan, /build, /test, /review, /ship. Cài bằng một lệnh npx, khá dễ nếu bạn đã có sẵn một công cụ AI viết code.

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

agent-skills là một bộ "kỹ năng" (skill) dành cho AI viết code. Mỗi skill là một quy trình làm việc viết bằng Markdown, mô tả cách một kỹ sư phần mềm lâu năm làm từng việc: hỏi cho rõ yêu cầu, viết đặc tả, chia nhỏ việc, viết code kèm test, review, rồi mới đưa lên chạy thật. Repo do Addy Osmani chia sẻ, giấy phép MIT, hiện có khoảng 116.700 sao và khoảng 12.200 fork.

Vấn đề nó giải quyết rất quen thuộc. Bạn nhờ AI viết một tính năng, nó lao vào code ngay, bỏ qua test, không hỏi lại yêu cầu, và mỗi lần làm một kiểu. Bộ skill này ép AI đi qua cùng một chuỗi bước mỗi lần, với các "cổng kiểm tra" ở giữa. Bạn không phải nhắc đi nhắc lại, vì quy trình đã nằm sẵn trong skill.

Bộ này hợp với lập trình viên mới muốn AI làm việc có kỷ luật, với người làm kinh doanh hay văn phòng đang tự dựng công cụ nhỏ bằng AI, và với nhóm dev đang thấy AI viết ra nhiều code hơn mức ai đó đọc nổi. Điểm đáng giá nhất: chỉ một lệnh là cài được vào hàng chục công cụ AI khác nhau, và có sẵn 9 lệnh gõ tắt theo đúng vòng đời làm phần mềm.

```repo
- repo | addyosmani/agent-skills
- kind | Skill
- desc | Bộ 25 skill và 9 lệnh slash giúp AI viết code theo quy trình của kỹ sư lâu năm: đặc tả, lập kế hoạch, code, kiểm thử, review và phát hành.
- stars | 117k
- lang | JavaScript
- license | MIT
```

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

### Chín lệnh slash theo vòng đời làm phần mềm

Repo gói quy trình thành 9 lệnh. Mỗi lệnh tự kích hoạt đúng các skill cần thiết, nên bạn không phải nhớ tên từng skill.

- `/spec`: viết đặc tả trước khi viết code. Nguyên tắc: spec trước, code sau.
- `/plan`: chia việc thành các tác vụ nhỏ, độc lập.
- `/build`: làm từng lát một, xong lát nào chắc lát đó.
- `/test`: coi test là bằng chứng rằng code chạy đúng.
- `/constraints`: đặt ra chuẩn chất lượng một lần rồi áp dụng ở mọi nơi.
- `/review`: review trước khi gộp code.
- `/webperf`: kiểm tra hiệu năng web, đo trước rồi mới tối ưu.
- `/code-simplify`: đơn giản hoá code, ưu tiên dễ hiểu hơn là "khôn lỏi".
- `/ship`: đưa lên chạy thật.

Có thêm `/build auto`. Lệnh này tạo kế hoạch và làm hết các tác vụ trong một lượt. Bạn duyệt kế hoạch một lần, sau đó AI tự chạy. Theo README, nó chỉ bỏ bước con người bấm tiếp giữa các tác vụ, không bỏ bước kiểm chứng. Mỗi tác vụ vẫn làm theo kiểu viết test trước và được commit riêng, và AI sẽ dừng lại khi gặp lỗi hoặc bước rủi ro.

### 25 skill tự kích hoạt theo việc bạn đang làm

Ngoài lệnh gõ tay, skill tự bật theo ngữ cảnh. README nêu ví dụ: thiết kế API thì bật `api-and-interface-design`, làm giao diện thì bật `frontend-ui-engineering`. Có 24 skill theo vòng đời cộng một skill "chỉ đường" là `using-agent-skills`, giúp AI biết việc nào dùng skill nào. Các nhóm chính:

- **Làm rõ cần làm gì**: `interview-me` hỏi bạn từng câu một cho đến khi hiểu khoảng 95% bạn muốn gì. `idea-refine` biến ý tưởng mơ hồ thành đề xuất cụ thể. `spec-driven-development` viết tài liệu yêu cầu trước khi có code. `constraint-driven-development` phỏng vấn bạn về chuẩn chất lượng, ghi ra file CONSTRAINTS.md và bắt lỗi khi AI tắt kiểm tra hay bỏ test cho "xanh".
- **Viết code**: làm theo lát mỏng, viết test trước (`test-driven-development`), bám tài liệu chính thức khi dùng framework (`source-driven-development`), và `doubt-driven-development` cho phép nghi ngờ phản biện từng quyết định quan trọng.
- **Kiểm chứng**: `browser-testing-with-devtools` dùng Chrome DevTools MCP để xem dữ liệu chạy thật trong trình duyệt. `debugging-and-error-recovery` đi theo năm bước: tái hiện, khoanh vùng, thu gọn, sửa, chặn tái phát.
- **Review và bảo mật**: review theo năm trục, đơn giản hoá code, bảo mật theo OWASP Top 10, tối ưu hiệu năng theo đo đạc.
- **Phát hành**: quy trình Git, CI/CD, ghi lại quyết định kiến trúc, theo dõi hệ thống khi chạy thật, danh sách kiểm tra trước khi ra mắt.

### Nhân vật chuyên gia và danh sách kiểm tra

Repo có 4 "persona" cho việc review chuyên sâu: `code-reviewer` (kỹ sư cấp cao), `test-engineer` (chuyên kiểm thử), `security-auditor` (bảo mật) và `web-performance-auditor` (hiệu năng web, chạy qua `/webperf`). Ngoài ra có thư mục `references/` chứa các checklist như định nghĩa hoàn thành, bảo mật, hiệu năng, khả năng truy cập, quan sát hệ thống. Skill sẽ lấy ra dùng khi cần.

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

Theo README, bạn cần một công cụ AI viết code mà bộ skill hỗ trợ: Claude Code (được khuyến nghị), Cursor, Codex, GitHub Copilot, Gemini CLI, Antigravity CLI, Windsurf, OpenCode, Kiro, Command Code. Với các công cụ khác, skill là file Markdown thường nên dùng được với bất kỳ agent nào nhận system prompt hoặc file hướng dẫn.

Những thứ cụ thể README nhắc tới:

- Cách cài nhanh nhất dùng `npx`, nên máy bạn cần có `npx` (đi kèm Node.js). README không ghi số phiên bản Node.
- Nếu cài vào Codex bằng plugin: cần Codex CLI phiên bản 0.122 trở lên.
- Nếu cài qua marketplace của Claude Code và máy chưa có khoá SSH trên GitHub, bạn sẽ gặp lỗi. Cách xử lý nằm ở phần Lỗi hay gặp bên dưới.
- Muốn dùng bản clone về máy thì cần có `git`.

Tư liệu không nói gì về API key riêng cho bộ skill này, cũng không đòi GPU. Bạn vẫn cần tài khoản hoặc gói dùng của công cụ AI bạn chọn, cái đó nằm ngoài repo.

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

```steps
- Chọn công cụ AI | Xác định bạn dùng Claude Code, Cursor, Codex hay công cụ khác
- Cài nhanh bằng npx | Một lệnh cài cả 25 skill vào công cụ bạn dùng
- Hoặc cài bản gốc | Dùng plugin marketplace của Claude Code hoặc Codex
- Mở lại công cụ | Khởi động lại để skill và lệnh slash xuất hiện
- Thử một lệnh | Gõ /spec để xem skill có phản hồi không
```

### Bước 1: Chọn công cụ AI bạn đang dùng

Nếu bạn dùng Claude Code, README khuyên cài theo cách native (bước 3). Nếu dùng công cụ khác, hoặc chưa rõ, cứ dùng lệnh `npx` ở bước 2. README cho biết lệnh này cài được vào hơn 70 agent, gồm Claude Code, Cursor, Codex, Copilot, Cline và nhiều công cụ nữa.

### Bước 2: Cài nhanh bằng npx

Mở terminal (PowerShell hoặc Terminal trên máy bạn), đứng ở thư mục dự án của bạn rồi chạy:

```bash
npx skills add addyosmani/agent-skills            # install all 25 skills
npx skills add addyosmani/agent-skills --list     # browse before installing
```

Lệnh đầu cài cả 25 skill. Lệnh thứ hai chỉ liệt kê để bạn xem trước, chưa cài gì. Phần sau dấu `#` là ghi chú, bạn có thể bỏ khi gõ. Bạn cũng có thể cài từng skill riêng:

```bash
npx skills add addyosmani/agent-skills --skill code-review-and-quality   # five-axis review before merge
npx skills add addyosmani/agent-skills --skill interview-me              # requirements interrogation, one question at a time
npx skills add addyosmani/agent-skills --skill test-driven-development   # red-green-refactor, enforced
```

```note
Cài lẻ từng skill bằng npx chỉ chép thư mục skills/<tên>/, không chép thư mục references/ dùng chung. Skill vẫn chạy, nhưng các đường dẫn tới checklist dùng chung sẽ không có. Muốn đủ bộ, hãy cài cả repo, clone repo, hoặc chép checklist cần thiết vào thư mục references/ bên trong skill đã cài.
```

### Bước 3: Cài bản native cho Claude Code

Trong Claude Code, gõ lần lượt hai lệnh sau. Đây là lệnh của Claude Code chứ không phải lệnh terminal thường, nên bạn gõ ngay trong khung chat của nó:

```
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```

Lệnh đầu đăng ký "chợ" plugin, lệnh sau cài plugin. Nếu báo lỗi SSH, README hướng dẫn dùng đường dẫn HTTPS đầy đủ:

```bash
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
```

Nếu `/plugin install` vẫn báo `git@github.com: Permission denied (publickey)` trên Windows hoặc macOS, README khuyên cấu hình Git một lần để đổi địa chỉ SSH của GitHub sang HTTPS:

```bash
git config --global url."https://github.com/".insteadOf git@github.com:
```

Muốn dùng bản trong máy để thử nghiệm hoặc chỉnh sửa, clone repo rồi trỏ Claude Code tới thư mục đó:

```bash
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills
```

Chỗ người mới hay vấp: `/path/to/agent-skills` chỉ là ví dụ. Bạn phải thay bằng đường dẫn thật tới thư mục vừa clone trên máy mình.

### Bước 4: Cài cho công cụ khác (nếu bạn không dùng Claude Code)

- **Codex** (CLI từ v0.122): chạy hai lệnh sau. Lệnh đầu đăng ký marketplace, lệnh sau cài plugin. Xong thì gọi skill trong chat bằng dấu `@`, ví dụ `@spec-driven-development`.

```bash
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
```

- **Gemini CLI**: cài trực tiếp từ repo bằng lệnh dưới đây. Hoặc cài từ bản clone bằng `gemini skills install ./agent-skills/skills/`.

```bash
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
```

- **Antigravity CLI**: dùng `agy plugin install`.

```bash
agy plugin install https://github.com/addyosmani/agent-skills.git
```

- **Command Code**: dùng `cmd skills add`. Thêm `--global` để cài cho mọi dự án, hoặc `-s` để chọn một skill.

```bash
cmd skills add addyosmani/agent-skills            # pick skills to install (project)
cmd skills add addyosmani/agent-skills --global   # install for all projects (~/.commandcode/skills/)
cmd skills add addyosmani/agent-skills -s spec-driven-development  # install a specific skill
```

- **Cursor, Windsurf, OpenCode, GitHub Copilot, Kiro**: README không có lệnh cài một dòng. Với Cursor, bạn chép skill vào `.cursor/skills/` trong dự án. Với OpenCode, chép vào `.opencode/skills/`. Với Kiro, skill nằm trong `.kiro/skills/`. Chi tiết xem các file `docs/cursor-setup.md`, `docs/windsurf-setup.md`, `docs/opencode-setup.md`, `docs/copilot-setup.md` trong repo.

Với công cụ không có trong danh sách, README chỉ ra `docs/getting-started.md` và `docs/other-hosts.md`.

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

Cách đơn giản nhất: mở lại công cụ AI của bạn trong thư mục dự án rồi thử một lệnh. Trong Claude Code, bạn gõ `/spec`. Nếu cài đúng, AI sẽ bắt đầu quy trình viết đặc tả thay vì trả lời chung chung.

Có vài điểm cần biết để khỏi nhầm:

- Trong Claude Code, các lệnh cài dưới dạng plugin command. Với lệnh trùng tên có sẵn như `/review`, hãy dùng dạng có tiền tố: `/agent-skills:review`.
- Trong Codex, skill gọi bằng `@`, ví dụ `@spec-driven-development`.
- Trong GitHub Copilot, các lệnh vòng đời như `/spec`, `/plan` không xuất hiện. Bạn gọi skill theo tên, ví dụ `/spec-driven-development`.
- Với Antigravity CLI, README cho biết ở một số bản, các lệnh bọc ngoài được báo là đã chuyển đổi nhưng không tìm thấy. Khi đó hãy gọi trực tiếp skill theo tên.

Nếu cài bằng `npx skills add ... --list` bạn sẽ thấy danh sách skill hiện ra, đó cũng là cách xem nhanh repo có tải được không.

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

Các tình huống dưới đây là ví dụ minh hoạ cách dùng các lệnh có trong README. Câu lệnh mẫu do mình đặt, bạn đổi theo việc của bạn.

### Chủ shop muốn dựng công cụ nhỏ mà không biết bắt đầu từ đâu

Chị Lan bán đồ handmade, muốn một trang nhỏ để khách tra tình trạng đơn hàng. Chị chỉ có ý tưởng mơ hồ. Thay vì bảo AI "làm giúp tôi trang tra đơn", chị gõ:

```
/spec Tôi muốn một trang cho khách nhập mã đơn và xem tình trạng đơn hàng
```

Theo README, `/spec` đi theo nguyên tắc "spec trước khi code". Skill `spec-driven-development` viết một bản đặc tả gồm mục tiêu, cấu trúc, phong cách code, cách kiểm thử và ranh giới. Nếu chị còn lúng túng, skill `interview-me` sẽ hỏi từng câu một cho tới khi hiểu đủ. Kết quả là một bản yêu cầu rõ ràng mà chị đọc và chỉnh được trước khi AI viết dòng code nào. Sau đó chị gõ `/plan` để chia việc thành các bước nhỏ.

> Quyết định một lần, ép áp dụng ở mọi nơi — AI viết nhiều đến đâu cũng không lọt qua chuẩn bạn đã đặt.
>
> — Ông T

### Dev mới cần review code trước khi gộp

Bạn là lập trình viên mới, vừa xong một tính năng và chưa chắc code đã ổn. Trước khi gửi cho đồng nghiệp, bạn chạy:

```
/agent-skills:review
```

Dùng dạng có tiền tố vì Claude Code đã có lệnh `/review` riêng. Skill `code-review-and-quality` review theo năm trục, gợi ý giữ thay đổi quanh 100 dòng và gắn nhãn mức độ như Nit, Optional, FYI. Bạn nhận được danh sách góp ý có phân loại, biết chỗ nào bắt buộc sửa, chỗ nào chỉ là gợi ý. Nếu muốn góc nhìn chuyên sâu hơn, bạn dùng persona `code-reviewer` hoặc `security-auditor`.

### Nhóm dev đang ngợp vì AI viết quá nhiều code

Một nhóm nhỏ dùng AI viết code hằng ngày nhưng chưa có tiêu chuẩn nào ghi ra giấy. Có người phát hiện AI từng tắt một bước kiểm tra cho qua. Họ chạy:

```
/constraints
```

Skill `constraint-driven-development` phỏng vấn nhóm về chuẩn chất lượng, đề xuất ngưỡng mặc định hợp lý, ghi vào file CONSTRAINTS.md và đặt từng kiểm tra ở chỗ có chi phí thấp nhất. README nói skill này còn bắt lỗi khi agent tắt kiểm tra hoặc bỏ test chỉ để "xanh". Kết quả: cả nhóm có một chuẩn chung, và AI bị giữ đúng chuẩn đó.

### Chủ website muốn biết vì sao trang chậm

Bạn có một website bán hàng, khách phàn nàn tải chậm. Bạn gõ:

```
/webperf
```

Lệnh này chạy persona `web-performance-auditor`, kiểm tra Core Web Vitals với chế độ Quick hoặc Deep, theo nguyên tắc đo trước rồi mới tối ưu. Bạn nhận được báo cáo dựa trên số đo, không phải lời khuyên chung chung. README cũng nêu quy tắc "trung thực về số đo" của persona này, nghĩa là nó không nên bịa số.

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

### Lỗi SSH khi cài plugin trong Claude Code

Dấu hiệu: `/plugin install` báo `git@github.com: Permission denied (publickey)`. Nguyên nhân là marketplace tải repo qua SSH mà bạn chưa có khoá SSH trên GitHub. Cách xử lý: dùng đường dẫn HTTPS khi chạy `/plugin marketplace add`, hoặc chạy lệnh `git config --global url."https://github.com/".insteadOf git@github.com:` như README hướng dẫn. Lệnh này đổi cấu hình Git toàn máy, nên bạn đọc kỹ trước khi chạy.

### Gõ /review nhưng ra lệnh khác

Claude Code có sẵn lệnh `/review`, nên gõ trần có thể gọi nhầm lệnh có sẵn. Hãy dùng dạng có tiền tố `/agent-skills:review`.

### Cài lẻ một skill nhưng thấy thiếu checklist

Đây là giới hạn README đã nêu: cài từng skill bằng npx chỉ chép thư mục của skill đó, không kèm `references/`. Cách xử lý: cài cả repo, clone repo, hoặc chép checklist cần dùng vào thư mục `references/` bên trong skill đã cài.

### Lệnh /spec, /plan không hiện trong Copilot hoặc Antigravity

Không phải bạn cài sai. Với GitHub Copilot, các lệnh vòng đời là lệnh của Claude Code và không xuất hiện, bạn gọi skill theo tên. Với một số bản Antigravity CLI, lệnh bọc ngoài không tìm thấy được, bạn cũng gọi trực tiếp skill. Nếu vẫn kẹt, xem `docs/copilot-setup.md` hoặc `docs/antigravity-setup.md`.

### Dùng /build auto mà thấy AI chạy một mạch

Đây là cách `/build auto` hoạt động: bạn duyệt kế hoạch một lần rồi AI chạy tự động. Nếu bạn muốn kiểm soát từng bước, dùng `/build` thường để làm từng lát một. Dù ở chế độ nào, hãy đọc kỹ kế hoạch trước khi bấm duyệt, vì đó là lúc duy nhất bạn chặn được sai lầm sớm.

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

**Điểm mạnh.** Bộ skill này làm AI có kỷ luật hơn mà bạn không phải viết lại hướng dẫn mỗi lần. Phạm vi phủ rộng, từ làm rõ yêu cầu tới phát hành. Cài đặt nhanh bằng một lệnh, hỗ trợ nhiều công cụ, giấy phép MIT, và repo vẫn được cập nhật trong vài tháng gần đây. Skill là file Markdown thường nên bạn đọc được, sửa được, và hiểu AI đang được dặn gì.

**Giới hạn.** Đây không phải phần mềm chạy riêng. Nó chỉ phát huy khi bạn đã có một công cụ AI viết code. Các lệnh slash đầy đủ hoạt động tốt nhất trên Claude Code, còn ở công cụ khác bạn có thể phải gọi skill theo tên. Cài lẻ từng skill thì mất thư mục tham chiếu dùng chung. Một số checklist, như mẫu kiểm thử, thiên về JavaScript và TypeScript. Quy trình nhiều bước cũng có nghĩa là việc nhỏ xíu sẽ chậm hơn so với bảo AI sửa thẳng.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ sửa một dòng hay làm thử nhanh một đoạn script, cả quy trình spec, plan, test có thể thừa. Nếu bạn không dùng công cụ AI viết code nào, bộ này chưa có ích cho bạn. Còn nếu bạn đang để AI viết code cho sản phẩm thật, thì đây là một bộ khung đáng thử, bắt đầu từ `/spec` và `/review` rồi mở rộng dần.

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

### agent-skills có miễn phí không?

Repo dùng giấy phép MIT nên bạn dùng và chỉnh sửa tự do. Tuy nhiên bạn vẫn cần tài khoản hoặc gói dùng của công cụ AI viết code mà bạn chọn, và chi phí đó nằm ngoài repo. README không nói về chi phí của các công cụ này.

### Dùng agent-skills có cần GPU hay máy mạnh không?

Tư liệu không nhắc tới yêu cầu GPU. Skill là các file Markdown hướng dẫn cho AI, việc xử lý nằm ở công cụ AI bạn dùng. Với cách cài nhanh bạn chỉ cần có `npx` trên máy.

### Cài trên Windows được không?

README có nhắc cách xử lý lỗi SSH trên Windows và macOS khi cài plugin cho Claude Code, nên Windows là môi trường được tính tới. Ngoài ra README không có hướng dẫn riêng theo hệ điều hành. Lệnh npx cài nhanh chạy được trong terminal của bạn.

### agent-skills dùng được với những công cụ AI nào?

README liệt kê Claude Code (được khuyến nghị), Cursor, Antigravity CLI, Gemini CLI, Windsurf, OpenCode, GitHub Copilot, Kiro, Codex và Command Code. Lệnh `npx skills add` cài được vào hơn 70 agent. Với agent khác, skill là Markdown nên dùng được ở nơi nhận system prompt hoặc file hướng dẫn.

### Có thể chỉ cài một skill thay vì cả bộ không?

Được, dùng cờ `--skill` kèm tên skill, ví dụ `npx skills add addyosmani/agent-skills --skill interview-me`. Lưu ý cài lẻ chỉ chép thư mục của skill đó, không kèm thư mục `references/` chứa checklist dùng chung. Skill vẫn chạy nhưng các đường dẫn tới checklist sẽ không có.

### Lệnh /build auto có tự làm hết mà không cần tôi kiểm tra không?

Theo README, bạn duyệt kế hoạch một lần rồi AI tự chạy các tác vụ. Nó chỉ bỏ bước con người bấm tiếp giữa các tác vụ, không bỏ bước kiểm chứng. Mỗi tác vụ vẫn làm theo kiểu test trước và được commit riêng, và AI dừng lại khi gặp lỗi hoặc bước rủi ro.

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

Tư liệu không nói cụ thể về việc gửi dữ liệu đi đâu, vì skill chỉ là file hướng dẫn chạy trong công cụ AI bạn chọn. Mức an toàn phụ thuộc vào chính công cụ đó. Bạn nên xem chính sách của công cụ AI mình đang dùng.
