# wshobson/agents: Bộ plugin AI coding dùng đa công cụ — hướng dẫn cài đặt và dùng

> wshobson/agents là bộ sưu tập plugin, agent, skill và command giúp mở rộng Claude Code, Codex CLI, Cursor, OpenCode và các công cụ lập trình AI khác. Repo có nhiều lựa chọn cho Python, JavaScript, kiểm thử, bảo mật và hạ tầng. Cài đặt khá dễ nếu bạn dùng đúng công cụ và tuyến cài đặt được README hướng dẫn.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-24 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/wshobson-agents-plugin-ai-coding-da-cong-cu

wshobson/agents là bộ plugin, agent, skill và command cho các công cụ lập trình AI như Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Bạn có thể dùng cùng một nguồn Markdown, sau đó repo tạo ra định dạng phù hợp với từng công cụ.

Repo phù hợp với lập trình viên muốn trợ lý AI làm việc theo quy trình rõ ràng hơn. Người mới cũng có thể bắt đầu bằng một plugin dựng sẵn, chẳng hạn plugin cho Python hoặc JavaScript. Điểm đáng giá nhất là số lượng thành phần lớn, cách tổ chức theo nhóm công việc và có bước kiểm tra cấu trúc, sinh artifact cùng đánh giá chất lượng.

Repo hiện có khoảng 42473 sao và 4488 fork. Mã nguồn dùng giấy phép MIT. Bộ sưu tập gồm 94 plugin, 202 agent, 185 skill và 105 command trong phần mã nguồn nội bộ.

```repo
- repo | wshobson/agents
- kind | Danh sách tuyển chọn
- desc | Bộ plugin, agent, skill và command bằng Markdown cho Claude Code, Codex CLI, Cursor cùng nhiều công cụ lập trình AI.
- stars | 42k
- lang | Python
- license | MIT
```

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

- Mở rộng nhiều công cụ lập trình AI từ một nguồn chung. Bạn có thể chọn Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi tùy quy trình đang dùng.

- Cung cấp các plugin theo từng nhóm việc. Có nhóm cho phát triển Python, Django, FastAPI, kiểm thử, đóng gói, JavaScript, TypeScript, review mã nguồn, debug, Git, hạ tầng, bảo mật và quét dependency.

- Tách vai trò chuyên môn thành agent. Agent là các chỉ dẫn cho những tác vụ được giao cho trợ lý phụ, giúp một công việc lớn được chia thành các phần chuyên biệt hơn.

- Bổ sung skill để công cụ AI nạp hướng dẫn và tài liệu tham khảo khi cần. Ví dụ, skill có thể tập trung vào một mẫu kiểm thử hoặc một quy trình phát triển cụ thể.

- Cung cấp command có tên để gọi quy trình nhanh. Một command có thể dùng cho việc dựng khung dự án, quét bảo mật hoặc thực hiện một workflow định trước.

- Tự chuyển đổi định dạng cho từng harness. Tác giả viết component một lần theo định dạng plugin của Claude Code. Các adapter trong `tools/adapters/` tạo định dạng cho những công cụ khác, đồng thời ánh xạ model và quyền dùng tool khi công cụ đó hỗ trợ.

- Có cơ chế kiểm tra và đánh giá. Repo kiểm tra cấu trúc plugin, artifact đã sinh, tài liệu và một số CLI. Điều này hữu ích khi bạn muốn đóng góp component mới hoặc kiểm tra bản cài có đầy đủ hay không.

- Hỗ trợ cài riêng từng skill. Nếu bạn chỉ cần một skill mà không cần toàn bộ agent, command hoặc hook của plugin, README hướng dẫn dùng `gh skill` hoặc `npx skills`.

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

Bạn cần có một công cụ lập trình AI mà repo hỗ trợ. README nêu các lựa chọn gồm Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Thành phần có thể dùng được sẽ khác nhau tùy công cụ và cách cài.

Nếu cài từ bản clone cho OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi, README yêu cầu cài `uv`, Python 3.12 trở lên và công cụ lập trình bạn muốn dùng. Tư liệu không nêu hệ điều hành cụ thể được hỗ trợ.

Nếu dùng tuyến skill-only, lệnh `gh skill` yêu cầu GitHub CLI 2.90 trở lên. Lệnh `npx skills` yêu cầu Node.js và npm.

Bạn chỉ cần API key khi chạy các lớp đánh giá dùng mô hình ngôn ngữ. Nếu biến `ANTHROPIC_API_KEY` được đặt, các lệnh đánh giá dùng API account đó và chi phí được tính vào account này. Nếu không, chúng dùng phiên đăng nhập Claude Code. Việc cài plugin và dùng các hướng dẫn thông thường không được README nói là bắt buộc phải có API key.

README không nêu yêu cầu GPU, dung lượng ổ đĩa tối thiểu hay phiên bản cụ thể của từng công cụ ngoài các điều kiện trên.

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

```steps
- Chọn tuyến cài | Xác định bạn dùng Claude Code, Codex CLI, skill riêng hay công cụ cần clone repo
- Cài thành phần | Chạy lệnh cài plugin, skill hoặc installer tương ứng
- Chọn workflow | Chọn plugin như Python, JavaScript hoặc developer-essentials
- Gọi thành phần | Dùng command hoặc yêu cầu công cụ AI thực hiện tác vụ
- Kiểm tra repo | Nếu đóng góp, sinh artifact và chạy các lệnh validate
```

### Chọn công cụ và tuyến cài phù hợp

Nếu bạn dùng Claude Code, có thể cài trực tiếp từ marketplace. Codex CLI có tuyến marketplace riêng. Cursor dùng registry marketplace đã commit. Với OpenCode, Antigravity CLI, GitHub Copilot và Pi, README hướng dẫn clone repo rồi chạy installer.

Nếu chỉ muốn một skill, hãy dùng tuyến skill-only. Cách này không cài thêm agent, command hoặc hook của plugin.

### Cài plugin cho Claude Code

Mở Claude Code và chạy hai lệnh sau:

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

Lệnh đầu đăng ký marketplace của repo. Lệnh thứ hai cài plugin `python-development`. Bạn có thể thay plugin này bằng plugin phù hợp trong catalog, nhưng README chỉ nêu các nhóm chính như `python-development`, `javascript-typescript`, `developer-essentials` và `security-scanning`.

Sau khi cài, bạn có thể yêu cầu Claude dùng agent Python cho tác vụ của mình hoặc gọi command dựng khung dịch vụ:

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

Phần câu lệnh sau tên command là yêu cầu gửi cho công cụ. Người mới nên chạy trong đúng phiên Claude Code đã đăng ký marketplace, thay vì dán lệnh này vào PowerShell hoặc terminal thông thường.

### Cài plugin cho Codex CLI

Mở terminal có Codex CLI hiện hành rồi chạy:

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

Lệnh đầu thêm marketplace. Lệnh sau cài plugin Python. README lưu ý manifest native của Codex cung cấp source skill; agent TOML được sinh và skill tạo từ command đi theo tuyến adapter riêng. Bản cài native cũng đọc nội dung skill gốc, còn bản sinh có thể tách phần thân lớn thành file tham chiếu để phù hợp giới hạn 8 KB.

Nếu bạn cần agent TOML hoặc command-derived skill, hãy đọc phần Codex setup details và chọn đúng tuyến adapter trước khi cài. README được cung cấp ở đây không chép toàn bộ lệnh của tuyến đó.

### Cài một skill bằng GitHub CLI hoặc npx

Đây là lựa chọn gọn nếu bạn chỉ cần một skill. Chạy một trong hai lệnh:

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

Lệnh thứ nhất cài skill `python-testing-patterns` bằng GitHub CLI. Lệnh thứ hai dùng npm và `npx` để cài cùng skill. Hai installer đọc skill trực tiếp từ GitHub, không cần clone repo và không cài agent, command hoặc hook của plugin.

Khi chạy `npx skills`, hãy chọn đúng coding tool nếu installer hỏi. Với `gh skill`, cần GitHub CLI 2.90 trở lên. README có nhắc tới install scope và version pinning trong tài liệu riêng, nhưng phần nội dung được cung cấp chưa có lệnh chi tiết cho hai tùy chọn này.

### Clone repo cho OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi

Cài `uv`, Python 3.12 trở lên và công cụ bạn muốn dùng trước. Sau đó chạy lệnh clone được README nêu:

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

Lệnh `gh repo clone` tải repo vào thư mục `~/agents`. Lệnh `cd` chuyển terminal vào thư mục repo. Nếu bạn dùng shell không nhận ký hiệu `~`, hãy mở tài liệu của shell và công cụ để xác định đường dẫn tương đương; README không đưa lệnh thay thế cụ thể.

Từ thư mục repo, chạy installer tương ứng:

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

Mỗi lệnh sinh artifact cho harness tương ứng và liên kết các plugin nội bộ vào cấu hình người dùng của công cụ đó. Chỉ chạy lệnh phù hợp với công cụ bạn đang dùng. Pi cần extension `subagent` tham chiếu hoặc một extension tương thích nếu bạn muốn dùng agent của Pi.

### Kiểm tra và đánh giá mã nguồn

Nếu bạn đang đóng góp hoặc muốn kiểm tra toàn bộ repo, chạy từ thư mục gốc:

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

`make generate-all` sinh artifact cho các harness. `make validate STRICT=1` kiểm tra với chế độ nghiêm ngặt. `make garden` chạy bước kiểm tra bổ sung được repo cung cấp.

Bạn cũng có thể chấm điểm tĩnh một skill:

```bash
uv run --project plugins/plugin-eval plugin-eval score plugins/python-development/skills/python-testing-patterns --depth quick
```

Lệnh này chấm skill `python-testing-patterns` ở mức `quick` bằng project `plugins/plugin-eval`. Đây là kiểm tra tĩnh, không nhất thiết chứng minh task thực tế của bạn sẽ thành công.

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

Với Claude Code, dấu hiệu đầu tiên là marketplace chấp nhận lệnh thêm repo và plugin xuất hiện sau lệnh cài. Bạn có thể gọi command mẫu:

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

Kết quả mong đợi theo README là Claude dùng command dựng khung một dịch vụ FastAPI có test.

Với Codex CLI, hai lệnh `codex plugin marketplace add` và `codex plugin add` cần hoàn tất mà không báo lỗi. Sau đó kiểm tra skill hoặc plugin đã xuất hiện trong Codex theo quy tắc discovery của phiên bản bạn đang dùng. README nhấn mạnh rằng source skill, agent TOML và command-derived skill có thể đi theo các tuyến khác nhau.

Với tuyến clone, chạy installer tương ứng từ thư mục repo. Dấu hiệu thành công là artifact được sinh và plugin nội bộ được liên kết vào cấu hình người dùng của harness. Với Pi, nếu agent không hoạt động, kiểm tra extension `subagent` hoặc extension tương thích.

Nếu bạn đang kiểm tra mã nguồn, kết quả cần xem là các lệnh `make generate-all`, `make validate STRICT=1` và `make garden` chạy qua. Lệnh đánh giá `plugin-eval` trả về điểm cho skill, nhưng README cảnh báo điểm đánh giá mô hình hoặc mô phỏng không chứng minh task chắc chắn thành công trong dự án thật.

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

### Chủ shop cần dựng API quản lý đơn hàng

Một chủ shop có đội kỹ thuật nhỏ có thể cài plugin `python-development` trong Claude Code hoặc Codex CLI. Sau đó nhập yêu cầu cụ thể như:

```text
Create a FastAPI service for order management with tests
```

Command `python-scaffold` được README nêu cho việc tạo dịch vụ FastAPI có test. Kết quả kỳ vọng là công cụ bắt đầu từ một cấu trúc phù hợp thay vì trả lời chung chung về cách viết API. Bạn vẫn cần kiểm tra mô hình dữ liệu, quyền truy cập và test trước khi đưa vào dùng thật.

### Nhân viên văn phòng muốn nhờ AI xử lý một dự án JavaScript

Một nhân viên phụ trách website nội bộ có thể chọn plugin `javascript-typescript`. Plugin này phù hợp với việc phát triển JavaScript, TypeScript và thiết lập dự án. Bạn có thể yêu cầu công cụ phân tích cấu trúc hiện tại, đề xuất thay đổi hoặc tạo phần khởi đầu cho dự án.

README không cung cấp một command JavaScript cụ thể, nên không nên tự đoán tên command. Cách an toàn là cài plugin rồi mô tả rõ mục tiêu, file cần sửa và tiêu chí kiểm tra trong lời nhắc gửi cho công cụ.

### Dev muốn review mã và tìm lỗi trước khi gửi pull request

Dev có thể chọn `developer-essentials` để tập trung vào code review, debug, Git và các mẫu kiểm thử. Một yêu cầu thực tế có thể là:

```text
Review the current changes, identify likely bugs, and suggest tests
```

Kết quả nhận được phụ thuộc vào công cụ đang dùng và dữ liệu dự án mà công cụ được phép đọc. Plugin giúp đặt quy trình và vai trò chuyên môn rõ hơn, nhưng review cuối cùng vẫn cần đối chiếu với yêu cầu sản phẩm và chạy test thật.

### Nhóm kỹ thuật muốn kiểm tra plugin trước khi chia sẻ

Người duy trì plugin có thể chạy:

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

Sau đó chấm điểm nhanh một skill bằng `plugin-eval`. Quy trình này phù hợp khi nhóm vừa thêm skill, agent hoặc command và muốn phát hiện lỗi cấu trúc trước khi dùng trong nhiều dự án.

> Một nguồn Markdown, nhiều công cụ AI, một quy trình làm việc dễ lặp lại.
>
> — Ông T

### Dev chỉ cần một hướng dẫn kiểm thử Python

Nếu bạn không cần cả plugin, hãy cài riêng `python-testing-patterns`:

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

Cách này phù hợp với dự án nhỏ hoặc máy làm việc muốn hạn chế số lượng thành phần được cài. Skill được cài mà không kéo theo agent, command hoặc hook của plugin. Nếu dùng `npx`, bạn có thể chạy:

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

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

### Cài nhầm tuyến cho công cụ đang dùng

Mỗi harness có cách đọc component và giới hạn khác nhau. Claude Code, Codex CLI, Cursor và nhóm công cụ cài từ clone không dùng cùng một lệnh. Hãy quay lại bảng hỗ trợ trong README, xác định công cụ đang dùng rồi chạy đúng tuyến.

### Không tìm thấy lệnh `make`

README dùng các lệnh `make install-opencode`, `make install-antigravity`, `make install-copilot`, `make install-pi` và các lệnh kiểm tra bằng Makefile. Nếu terminal không nhận `make`, hãy cài công cụ cung cấp Make theo hệ điều hành của bạn hoặc dùng môi trường phù hợp. Tư liệu được cung cấp không nêu lệnh cài Make cụ thể.

### `gh skill` không chạy vì GitHub CLI quá cũ

README yêu cầu GitHub CLI 2.90 trở lên cho `gh skill`. Kiểm tra phiên bản GitHub CLI của bạn và nâng cấp trước khi thử lại. Nếu máy đã có Node.js và npm, có thể thử tuyến `npx skills` thay thế.

### Dùng `npx skills` nhưng thiếu Node.js hoặc npm

Lệnh `npx skills add` yêu cầu Node.js và npm. Nếu terminal báo không nhận `npx`, hãy cài hoặc kích hoạt Node.js cùng npm rồi chạy lại. README không nêu phiên bản Node.js cụ thể.

### Điểm đánh giá cao nhưng task thực tế vẫn chưa đạt

`plugin-eval` có kiểm tra tĩnh, còn LLM judge và Monte Carlo là các lớp thử nghiệm. README nói rõ điểm số mô tả đánh giá của mô hình và mô phỏng lặp lại, không chứng minh task sẽ thành công trong một dự án cụ thể. Hãy xem điểm như tín hiệu kiểm tra, sau đó chạy test và review kết quả thật.

### Vô tình phát sinh chi phí API

Các lớp đánh giá dùng model có thể gọi `ANTHROPIC_API_KEY` nếu biến này được đặt. Khi đó chi phí tính vào account API tương ứng. Nếu không có biến này, README nói chúng dùng đăng nhập Claude Code; hãy kiểm tra tài khoản và giới hạn sử dụng trước khi chạy đánh giá.

```note
Chỉ đặt ANTHROPIC_API_KEY khi bạn hiểu lệnh đánh giá sẽ gọi mô hình và tính phí vào API account. Không đưa key vào file plugin, prompt công khai hoặc kho mã nguồn.
```

## 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 công cụ lập trình AI và muốn có sẵn nhiều workflow chuyên môn. Repo có catalog lớn, hỗ trợ nhiều harness, có plugin cho các nhu cầu phổ biến như Python, JavaScript, review, kiểm thử và bảo mật. Cách viết component một lần rồi sinh định dạng cho từng công cụ cũng phù hợp với nhóm dùng nhiều công cụ khác nhau.

Repo cũng đáng chú ý ở phần kiểm tra và tài liệu kiến trúc. Người đóng góp có thể sinh artifact, validate ở chế độ nghiêm ngặt, chạy garden và dùng plugin-eval để kiểm tra skill. Giấy phép MIT giúp repo dễ được xem xét cho nhiều mục đích sử dụng.

Giới hạn là các harness không có năng lực giống nhau. Thành phần, model mapping, quyền dùng tool, hook và đường cài có thể khác nhau. Codex CLI còn có khác biệt giữa manifest native và artifact TOML được sinh. Pi cần extension bổ sung cho agent. Vì vậy, cài được plugin không đồng nghĩa mọi agent, command và hook sẽ hoạt động y hệt trên mọi công cụ.

Bạn nên chọn cách khác nếu chỉ cần một trợ lý AI đơn giản, không muốn quản lý nhiều component hoặc công cụ hiện tại đã có workflow vừa đủ. Nếu mục tiêu là đánh giá chất lượng tuyệt đối, cũng không nên dựa riêng vào điểm `plugin-eval`; hãy kiểm tra kết quả bằng test, review và quy trình của dự án.

Tóm lại, wshobson/agents phù hợp với người muốn biến công cụ lập trình AI thành một bộ trợ lý chuyên môn có tổ chức. Hãy bắt đầu bằng một plugin hoặc một skill đúng nhu cầu, kiểm tra khả năng tương thích của harness, rồi mới mở rộng sang các nhóm khác.

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

### Repo này có miễn phí không?

README cho biết repo dùng giấy phép MIT. Tuy nhiên, các external plugin có thể có giấy phép riêng. Nếu chạy lớp đánh giá dùng `ANTHROPIC_API_KEY`, chi phí API được tính vào account đó.

### Có cần GPU để dùng wshobson/agents không?

Tư liệu được cung cấp không nêu yêu cầu GPU. Repo chủ yếu cung cấp Markdown, plugin, agent, skill, command và adapter cho các công cụ lập trình AI.

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

README không nêu hệ điều hành cụ thể được hỗ trợ. Vì vậy chưa có đủ thông tin để khẳng định tuyến cài đặt nào hoạt động trên Windows mà không cần điều chỉnh môi trường.

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

Không thấy README yêu cầu API key cho việc cài plugin hoặc dùng workflow thông thường. Lớp đánh giá LLM có thể dùng `ANTHROPIC_API_KEY`; nếu không đặt biến này, nó dùng đăng nhập Claude Code.

### Repo khác gì một bộ prompt thông thường?

Repo tổ chức nội dung thành plugin, agent, skill và command, sau đó adapter sinh định dạng cho nhiều harness. Nó còn có catalog, kiểm tra cấu trúc, sinh artifact và các lớp đánh giá.

### Tôi chỉ cần một skill thì có phải clone cả repo không?

Không cần. README hướng dẫn dùng `gh skill install wshobson/agents python-testing-patterns` hoặc `npx skills add wshobson/agents --skill python-testing-patterns`. Hai cách này không cài agent, command hoặc hook của plugin.

### Các agent và command có hoạt động giống nhau trên mọi công cụ không?

Không hẳn. README nói khả năng hỗ trợ, model mapping, quyền dùng tool, hook và cách cài khác nhau theo từng harness. Một số thành phần có thể được chuyển thành skill hoặc prompt template.
