# wshobson/agents: bộ plugin, agent, skill cho nhiều công cụ AI code — hướng dẫn cài đặt và dùng

> wshobson/agents là kho plugin, agent, skill và lệnh dành cho các công cụ lập trình AI như Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Bạn chọn plugin hợp việc rồi cài bằng vài lệnh. Với Claude Code, chỉ cần hai lệnh gõ trong khung chat; với các công cụ còn lại thì dùng lệnh make hoặc trình cài skill.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-11 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/wshobson-agents-plugin-agent-skill-claude-code-codex-2

wshobson/agents là một kho tổng hợp các plugin, agent, skill và lệnh có sẵn để "gắn thêm" vào công cụ lập trình AI mà bạn đang dùng. Nói đơn giản: thay vì tự viết từng bộ hướng dẫn cho AI (cách viết test, cách review code, cách quét bảo mật…), bạn cài những bộ đã có người soạn sẵn.

Repo này hợp với lập trình viên mới và người làm kỹ thuật muốn AI làm việc bài bản hơn. Nếu bạn đã dùng Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi, bạn có thể dùng chung một bộ nội dung cho tất cả. Nhóm làm văn phòng, kinh doanh thường không cần đến, trừ khi trong team có người code.

Điểm đáng giá nhất là quy mô và cách làm. Theo README, kho hiện có 94 plugin, gồm 92 plugin nằm trong repo và 2 mục bên ngoài. Phần nguồn trong repo có 202 agent, 185 skill và 105 lệnh. Mọi thứ được viết một lần bằng Markdown, rồi các bộ chuyển đổi tự sinh ra định dạng cho từng công cụ. Repo hiện có khoảng 42.457 sao và 4.487 fork, giấy phép MIT.

```repo
- repo | wshobson/agents
- kind | Danh sách tuyển chọn
- desc | Kho 94 plugin, 202 agent, 185 skill, 105 lệnh viết một lần bằng Markdown, dùng được với Claude Code, Codex CLI, Cursor, OpenCode, Copilot, Pi.
- stars | 42k
- lang | Python
- license | MIT
```

## wshobson/agents làm được gì

Trước hết, bạn cần hiểu bốn khái niệm mà repo dùng. Hiểu rồi thì phần sau dễ đọc hơn nhiều.

- **Plugin** là một gói gom các thành phần liên quan. Ví dụ plugin `python-development` có ba agent, mười sáu skill và một lệnh tạo khung dự án.
- **Agent** là chỉ dẫn cho một "chuyên gia phụ" mà AI giao việc cho.
- **Skill** là tài liệu hướng dẫn, AI chỉ nạp khi thấy liên quan tới việc đang làm.
- **Lệnh** là một quy trình có tên để bạn tự gọi, như tạo khung dự án hay quét bảo mật.

Những điểm chính của repo:

- **Một nội dung, nhiều công cụ.** Người đóng góp viết bằng Markdown theo định dạng plugin của Claude Code. Các bộ chuyển đổi trong thư mục `tools/adapters/` sinh ra định dạng mà từng công cụ đọc được. Lợi ích với bạn: đổi công cụ không phải bắt đầu lại từ đầu.
- **Chọn plugin theo việc.** README gợi ý bốn plugin để bắt đầu: `python-development` (Python, Django, FastAPI, test, đóng gói), `javascript-typescript`, `developer-essentials` (review code, gỡ lỗi, Git, mẫu test) và `security-scanning` (rà soát bảo mật, kiểm tra thư viện phụ thuộc, quét code).
- **Cài từng skill riêng lẻ.** Bạn không bắt buộc cài cả plugin. Có thể chỉ lấy một skill, như `python-testing-patterns`, mà không kéo theo agent, lệnh hay hook.
- **Có kiểm tra chất lượng.** Repo có bước kiểm tra cấu trúc plugin, tài liệu và các file được sinh ra. Công cụ `plugin-eval` còn chấm skill theo kiểu tĩnh, không gọi mô hình.
- **Quy đổi tên mô hình.** Agent gốc ghi các bí danh như `opus`, `sonnet`, `haiku`, `fable` hoặc `inherit`. Bộ chuyển đổi đổi chúng sang mô hình tương ứng của từng công cụ.

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

Tuỳ cách cài, bạn cần những thứ khác nhau. Chỉ cần chuẩn bị đúng phần mình chọn.

- **Dùng Claude Code:** chỉ cần có Claude Code. Hai lệnh cài gõ ngay trong Claude Code.
- **Dùng Codex CLI:** cần một bản Codex CLI đủ mới và một terminal.
- **Cài từng skill:** cần GitHub CLI bản 2.90 trở lên (nếu dùng `gh skill`), hoặc Node.js và npm (nếu dùng `npx skills`).
- **Cài từ bản clone cho OpenCode, Antigravity CLI, GitHub Copilot, Pi:** cần cài [uv](https://docs.astral.sh/uv/getting-started/installation/), Python 3.12 trở lên và chính công cụ AI bạn định dùng. README dùng GitHub CLI để clone repo.
- **Pi:** agent của Pi cần extension `subagent` tham chiếu hoặc một extension tương thích.
- **Chạy phần đánh giá bằng mô hình (tuỳ chọn):** nếu đặt biến `ANTHROPIC_API_KEY`, lệnh sẽ tính tiền vào tài khoản API đó. Nếu không đặt, nó dùng tài khoản đăng nhập Claude Code của bạn.

README không nêu yêu cầu về hệ điều hành hay phần cứng (như GPU). Phần này chưa có thông tin trong tư liệu.

```note
Chỉ phần đánh giá bằng mô hình (LLM judge, Monte Carlo) mới gọi mô hình và có thể tốn tiền. Cài plugin và skill thông thường không thuộc phần này. Đừng dán API key vào chỗ người khác nhìn thấy được.
```

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

```steps
- Chọn công cụ | Xác định bạn dùng Claude Code, Codex CLI, Cursor hay công cụ khác
- Thêm marketplace | Đăng ký kho wshobson/agents với công cụ của bạn
- Cài plugin | Cài plugin hợp việc, ví dụ python-development
- Hoặc cài riêng skill | Dùng gh skill hoặc npx skills nếu chỉ cần một skill
- Hoặc cài từ bản clone | Dùng make install-... cho OpenCode, Antigravity, Copilot, Pi
- Thử dùng | Gọi lệnh của plugin hoặc nhờ AI dùng agent
```

### Cách 1: Claude Code

Mở Claude Code, rồi gõ hai lệnh sau ngay trong khung chat của nó (không phải trong PowerShell hay Terminal thường). Lệnh đầu đăng ký kho, lệnh sau cài plugin Python.

```text
/plugin marketplace add wshobson/agents
/plugin install python-development@claude-code-workflows
```

Muốn cài plugin khác, thay tên `python-development` bằng tên plugin bạn chọn trong danh mục. Phần sau `@` là tên marketplace, giữ nguyên.

### Cách 2: Codex CLI

Hai lệnh này gõ trong terminal thường, và cần bản Codex CLI mới.

```bash
codex plugin marketplace add wshobson/agents
codex plugin add python-development@claude-code-workflows
```

Lưu ý: bản cài gốc của Codex chỉ hiện các skill nguồn. Agent dạng TOML và các lệnh được đổi thành skill đi theo một đường khác. README khuyên đọc phần "Codex setup" trong thư mục `docs/` của repo trước khi chọn cách cài.

### Cách 3: Cursor

Cursor dùng sổ đăng ký plugin có sẵn trong repo. README chưa ghi lệnh cụ thể, chỉ nói hãy làm theo hướng dẫn Cursor. Bạn xem trong thư mục `docs/` của repo, phần "Usage and tool setup".

### Cách 4: Chỉ cài một skill

Nếu bạn chỉ cần một skill, có hai lệnh để chọn. Cả hai đọc skill thẳng từ GitHub, không cần clone repo, và sẽ hỏi bạn chọn công cụ AI nào.

```bash
gh skill install wshobson/agents python-testing-patterns
npx skills add wshobson/agents --skill python-testing-patterns
```

`gh skill` cần GitHub CLI 2.90 trở lên. Lệnh `npx` cần có Node.js và npm. Cách này chỉ lấy skill, không kèm agent, lệnh hay hook của plugin.

### Cách 5: Cài từ bản clone (OpenCode, Antigravity CLI, Copilot, Pi)

Đầu tiên, kéo repo về máy và vào thư mục đó. Lệnh dưới dùng GitHub CLI và đặt repo vào thư mục `agents` trong thư mục gốc của bạn.

```bash
gh repo clone wshobson/agents ~/agents
cd ~/agents
```

Nếu chưa có GitHub CLI, bạn có thể dùng cách phổ thông là `git clone https://github.com/wshobson/agents.git` rồi `cd agents`.

Sau đó chạy đúng dòng ứng với công cụ của bạn. Mỗi lệnh tự sinh file cần thiết và liên kết toàn bộ plugin trong repo vào cấu hình người dùng của công cụ đó.

```bash
make install-opencode
make install-antigravity
make install-copilot
make install-pi
```

Chỗ người mới hay vấp: phải đứng trong thư mục repo mới chạy được `make`, và phải cài sẵn uv cùng Python 3.12 trở lên. Đường dẫn cấu hình và cách gỡ cài đặt nằm trong hướng dẫn "global install" ở thư mục `docs/`.

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

README không mô tả một màn hình "cài thành công" cụ thể. Cách kiểm tra thực tế nhất là gọi thử chính thứ bạn vừa cài.

Với Claude Code và plugin `python-development`, bạn chạy lệnh mẫu của README:

```text
/python-development:python-scaffold Create a FastAPI service with tests
```

Nếu plugin đã vào, Claude sẽ nhận lệnh này và bắt đầu dựng một dịch vụ FastAPI có kèm test. Nếu báo không tìm thấy lệnh, quay lại bước cài và xem có gõ đúng tên plugin không.

Với bản cài từ clone, bạn có thể chạy các lệnh kiểm tra của repo, đứng ở thư mục gốc:

```bash
make generate-all
make validate STRICT=1
make garden
```

Các lệnh này sinh lại file cho mọi công cụ, kiểm tra tính hợp lệ và rà soát tài liệu. README không nói rõ kết quả mong đợi in ra dạng gì. Nếu không có lỗi báo ra thì coi như ổn, còn nếu có lỗi thì đọc thông báo để biết file nào sai.

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

### Dev mới dựng nhanh một dịch vụ Python

Bạn vừa học Python và cần một dự án FastAPI có cấu trúc đàng hoàng thay vì bắt đầu từ file trống. Sau khi cài `python-development` trong Claude Code, bạn gõ:

```text
/python-development:python-scaffold Create a FastAPI service with tests
```

Bạn nhận về một khung dự án do lệnh của plugin dựng, kèm phần test. Bạn cũng có thể nhờ Claude dùng các agent Python của plugin cho việc cụ thể hơn, như viết thêm test hay đóng gói dự án.

> Cài một lần, AI làm việc theo nếp của người đi trước thay vì bạn phải dạy lại từ đầu mỗi lần.
>
> — Ông T

### Chỉ muốn thêm một kỹ năng viết test

Bạn đã có dự án, chỉ muốn AI viết test theo mẫu chuẩn mà không muốn cài cả gói. Bạn chạy:

```bash
gh skill install wshobson/agents python-testing-patterns
```

Sau khi chọn công cụ AI của mình, skill được cài riêng. Khi bạn nhờ AI viết test, nó có thể nạp skill này làm tài liệu tham khảo. Cách này nhẹ và ít "rác" hơn cài cả plugin.

### Team dùng nhiều công cụ khác nhau

Một người trong team dùng GitHub Copilot, người khác dùng OpenCode. Thay vì mỗi người tự soạn chỉ dẫn, cả hai clone repo và chạy `make install-copilot` hoặc `make install-opencode` tương ứng. Kết quả là mọi người dùng chung một nguồn nội dung, còn công cụ nào đọc định dạng nào thì bộ chuyển đổi lo. Lưu ý rằng khả năng mỗi công cụ không giống nhau (ví dụ Pi cần extension cho agent), nên xem bảng khả năng trong thư mục `docs/`.

### Rà soát bảo mật và review code trước khi gửi

Bạn chuẩn bị đưa code lên và muốn có thêm một lượt kiểm tra. README liệt kê `security-scanning` (rà soát bảo mật, kiểm tra thư viện phụ thuộc, quét code) và `developer-essentials` (review code, gỡ lỗi, Git). Tên gói theo cùng mẫu cài như plugin Python, ví dụ `/plugin install security-scanning@claude-code-workflows` trong Claude Code. Sau đó bạn nhờ Claude rà soát phần code đang sửa. Tên lệnh cụ thể của từng plugin có trong danh mục plugin ở `docs/`, README chính không liệt kê. Kết quả chỉ là gợi ý của AI, bạn vẫn cần tự đọc và quyết định.

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

- **Gõ lệnh `/plugin ...` vào terminal thường nên không chạy.** Đây là lệnh của Claude Code, phải gõ trong khung chat của nó. Ngược lại, `codex ...`, `gh ...`, `make ...` thì gõ trong terminal.
- **`make` báo không tìm thấy mục tiêu.** Rất thường là bạn đang đứng sai thư mục. Hãy `cd` vào thư mục repo đã clone (nơi có file `Makefile`) rồi chạy lại.
- **Thiếu uv hoặc Python quá cũ khi cài từ clone.** README yêu cầu uv và Python 3.12 trở lên. Hãy cài hoặc nâng cấp trước, rồi chạy lại lệnh `make install-...`.
- **`gh skill` không có lệnh.** Lệnh này cần GitHub CLI 2.90 trở lên. Nâng cấp GitHub CLI, hoặc dùng cách thay thế là `npx skills add` (cần Node.js và npm).
- **Thiếu agent hoặc lệnh sau khi cài.** Mỗi công cụ hỗ trợ khác nhau, và cài skill riêng không kèm agent, lệnh, hook. Đối chiếu bảng khả năng trong `docs/`, và chọn đường cài đầy đủ hơn nếu cần.

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

**Điểm mạnh:** kho lớn, có sẵn nhiều mảng việc (Python, JavaScript, review, kiểm thử, hạ tầng, bảo mật). Một nguồn dùng được cho nhiều công cụ. Có kiểm tra cấu trúc, tài liệu rõ, giấy phép MIT, và repo vẫn được cập nhật trong ba tháng gần đây.

**Giới hạn:** README tương đối kỹ thuật và nhiều đường cài, người mới dễ rối ở bước chọn. Khả năng khác nhau giữa các công cụ, nên không phải công cụ nào cũng có đủ agent, lệnh, hook. Phần đánh giá bằng mô hình mới ở mức thử nghiệm, chưa được đối chiếu với đánh giá của con người, điểm số không chứng minh một tác vụ chắc chắn thành công. Plugin bên ngoài có giấy phép riêng.

**Khi nào nên chọn cách khác:** nếu bạn chỉ cần một việc rất hẹp, hãy cài đúng một skill thay vì cả plugin. Nếu bạn không dùng công cụ lập trình AI nào, repo này chưa có gì cho bạn. Còn nếu bạn muốn một quy trình riêng của công ty, hãy coi repo như mẫu tham khảo rồi tự viết thêm theo hướng dẫn trong CONTRIBUTING.md.

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

### wshobson/agents có miễn phí không?

Repo dùng giấy phép MIT nên bạn dùng và sửa được. Plugin bên ngoài có giấy phép riêng. Phí của các công cụ AI đi kèm (Claude Code, Codex…) là chuyện riêng, tư liệu không nêu chi tiết.

### Repo này dùng được với những công cụ nào?

Theo README, gồm Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Mức hỗ trợ agent, skill, lệnh khác nhau tuỳ công cụ, nên cần xem bảng khả năng trong tài liệu của repo.

### Cài cả kho hay chỉ cài một phần được không?

Được. Bạn có thể cài từng plugin, ví dụ python-development, hoặc chỉ cài một skill bằng gh skill hoặc npx skills. Cài riêng skill sẽ không kèm agent, lệnh hay hook của plugin.

### Có cần GPU hay máy cấu hình mạnh không?

README không nêu yêu cầu phần cứng. Repo là bộ chỉ dẫn dạng Markdown cho công cụ AI, nên chưa có thông tin nào về GPU trong tư liệu.

### Chạy trên Windows được không?

README không nói rõ về hệ điều hành. Các lệnh cài trong Claude Code và Codex CLI là lệnh của công cụ đó. Các lệnh make cần có make và uv trên máy, tư liệu chưa nêu riêng cho Windows.

### Phần đánh giá chất lượng có tốn tiền không?

Các kiểm tra tĩnh của plugin-eval không gọi mô hình. Phần LLM judge và Monte Carlo có gọi mô hình: nếu đặt ANTHROPIC_API_KEY thì tính tiền vào tài khoản API đó, nếu không thì dùng đăng nhập Claude Code của bạn.

### Khác gì việc tự viết chỉ dẫn cho AI?

Repo cung cấp sẵn nhiều bộ chỉ một trang tin tức một lần và tự chuyển sang định dạng của từng công cụ. Tư liệu không so sánh với công cụ cụ thể nào khác, nhưng bạn vẫn có thể tự viết thêm theo hướng dẫn đóng góp trong repo.
