# wshobson/agents: Bộ agent AI cho lập trình — hướng dẫn cài đặt và dùng

> wshobson/agents là bộ sưu tập plugin, agent, skill và command viết bằng Markdown, dùng cho nhiều công cụ lập trình AI. Repo hỗ trợ Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Cài đặt khá đơn giản nếu bạn dùng đúng công cụ; một số tuyến cần uv, Python và lệnh make.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-27 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/wshobson-agents-bo-agent-ai-cho-lap-trinh-2

wshobson/agents là bộ plugin, agent, skill và command cho các công cụ lập trình AI. Bạn có thể dùng một nguồn nội dung cho Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi.

Repo phù hợp với lập trình viên muốn giao việc có cấu trúc cho AI: tạo dự án Python, viết kiểm thử, review code, debug, kiểm tra bảo mật hoặc làm việc với JavaScript và TypeScript. Điểm đáng giá nhất là các thành phần được viết một lần bằng Markdown, sau đó bộ chuyển đổi tạo định dạng phù hợp cho từng công cụ.

Repo hiện có khoảng 42.473 sao và 4.488 fork, dùng giấy phép MIT. Nội dung chính gồm khoảng 94 plugin, 202 agent, 185 skill và 105 command trong mã nguồn cục bộ. Bạn không cần cài toàn bộ; có thể chọn một plugin hoặc chỉ một skill phù hợp với công việc.

```repo
- repo | wshobson/agents
- kind | Danh sách tuyển chọn
- desc | Bộ plugin, agent, skill và command 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ì

### Gom sẵn các workflow cho lập trình

Repo cung cấp những workflow có thể dùng ngay cho phát triển Python, Django, FastAPI, JavaScript, TypeScript, kiểm thử, đóng gói, review code, Git, debug và quét bảo mật. Thay vì viết lại một prompt dài cho mỗi dự án, bạn gọi đúng plugin hoặc command cho nhiệm vụ cần làm.

Lợi ích thực tế là bạn có một cách làm thống nhất giữa các dự án. Một nhân viên mới có thể dùng workflow đã được chuẩn hóa để tạo service, viết test hoặc kiểm tra code mà không phải tự thiết kế toàn bộ hướng dẫn cho AI.

### Dùng cùng nhiều công cụ AI

Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi có cách đọc cấu hình khác nhau. Repo dùng các adapter để tạo artifact phù hợp với từng harness, tức công cụ chịu trách nhiệm tải và chạy component.

Bạn có thể giữ cùng một bộ nội dung khi đổi công cụ. Tuy vậy, thành phần sẵn có và giới hạn phụ thuộc vào tuyến cài đặt và khả năng của từng harness.

### Chọn agent chuyên môn cho từng việc

Agent là các hướng dẫn dành cho những tác vụ chuyên biệt và có thể được công cụ gọi khi cần. Ví dụ, một agent có thể hỗ trợ kiểm thử Python, review code hoặc phân tích bảo mật.

Cách tổ chức này hữu ích khi dự án có nhiều loại việc. Bạn không phải giao mọi nhiệm vụ cho một prompt chung, nên dễ chọn đúng hướng dẫn hơn.

### Tải skill khi cần

Skill là phần hướng dẫn và tài liệu tham khảo mà agent có thể nạp khi phù hợp. Repo cũng hỗ trợ cài từng skill bằng GitHub CLI hoặc trình cài `npx skills`, không cần clone toàn bộ kho mã.

Đây là lựa chọn gọn cho người chỉ cần một khả năng, chẳng hạn skill `python-testing-patterns`, nhưng không muốn cài thêm agent, command hoặc hook của cả plugin.

### Tạo artifact và kiểm tra chất lượng

Các adapter tạo định dạng cho từng công cụ. Repository có kiểm tra cấu trúc plugin, artifact đã sinh và tài liệu. Bạn cũng có thể chạy các lệnh kiểm tra từ thư mục gốc để xác nhận nội dung sinh ra hợp lệ.

Repo có `plugin-eval` cho kiểm tra skill tĩnh mà không cần gọi model. Các lớp đánh giá bằng LLM và Monte Carlo là thử nghiệm; điểm số của chúng chỉ mô tả đánh giá của model và mô phỏng lặp lại, không chứng minh một task luôn thành công trong dự án thật.

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

- Một công cụ AI lập trình được repo hỗ trợ: Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi.
- Với tuyến cài từ clone cho OpenCode, Antigravity CLI, GitHub Copilot và Pi: cần `uv`, Python 3.12 trở lên và công cụ lập trình tương ứng.
- Với cách cài skill riêng: `gh skill` cần GitHub CLI 2.90 trở lên. Lệnh `npx skills` cần Node.js và npm.
- Với đánh giá có LLM: cần các dependency tùy chọn `llm`. Khi biến `ANTHROPIC_API_KEY` được đặt, lệnh dùng key đó và tính phí vào tài khoản API tương ứng; nếu không, lệnh dùng đăng nhập Claude Code.
- Tài khoản, API key hoặc phần cứng GPU không được README nêu thành yêu cầu chung. Việc có cần đăng nhập hay key hay không phụ thuộc công cụ và tuyến sử dụng.

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

```steps
- Chọn harness | Xác định bạn dùng Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, Copilot, Pi hoặc chỉ cần skill
- Cài plugin hoặc skill | Dùng lệnh phù hợp với công cụ đã chọn
- Cài từ clone nếu cần | Clone repo và chạy installer cho OpenCode, Antigravity CLI, Copilot hoặc Pi
- Chạy thử workflow | Gọi command hoặc yêu cầu công cụ dùng agent phù hợp
- Kiểm tra tùy chọn | Chạy generate, validate, garden hoặc plugin-eval khi cần
```

### Chọn tuyến cài đặt

Trước hết, xác định công cụ bạn đang dùng. Claude Code, Codex CLI và Cursor có tuyến marketplace. OpenCode, Antigravity CLI, GitHub Copilot và Pi dùng repo đã clone cùng các lệnh `make install-*`. Nếu chỉ muốn một skill, dùng GitHub CLI hoặc `npx skills`.

Nếu bạn chưa biết mình đang dùng harness nào, hãy kiểm tra tên công cụ mở trong terminal hoặc editor. Không nên chạy lẫn lệnh của các tuyến, vì mỗi harness có cách nạp component riêng.

### Cài plugin cho Claude Code

Mở Claude Code và chạy hai lệnh sau trong phiên làm việc của Claude Code:

```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`. Sau đó, bạn có thể yêu cầu Claude dùng các agent Python hoặc gọi command scaffold:

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

Bạn có thể thay nội dung sau command bằng yêu cầu thật của dự án. README không nêu tên mọi command cho mọi plugin, vì vậy hãy xem plugin catalog và usage guide trong repo để chọn đúng component.

### 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 development. README lưu ý rằng manifest native của Codex chủ yếu cung cấp source skill. Agent TOML được sinh ra và các command chuyển thành skill đi theo một tuyến adapter riêng.

Native installation đọc body skill gốc. Bản sinh có thể tách body quá lớn thành file tham chiếu để phù hợp giới hạn 8 KB. Nếu bạn cần agent hoặc command đã chuyển đổi, hãy xem phần hướng dẫn Codex trong tài liệu repo trước khi chọn tuyến cài.

### Cài riêng một skill

Nếu chỉ cần skill kiểm thử Python, dùng GitHub CLI:

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

Hoặc dùng trình cài `npx`:

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

Cả hai cách đọc skill trực tiếp từ GitHub mà không clone repo. Chúng cài skill mà không cài agent, command hoặc hook của plugin. Với `gh skill`, cần GitHub CLI 2.90 trở lên. Với `npx`, cần Node.js và npm. Khi trình cài hỏi công cụ lập trình, hãy chọn đúng harness bạn đang dùng.

### Clone repo cho các tuyến dùng Makefile

Nếu dùng 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ụ tương ứng. Sau đó clone repo và đi vào thư mục:

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

Lệnh đầu dùng GitHub CLI để sao chép repo vào thư mục `~/agents`. Lệnh thứ hai chuyển terminal vào thư mục gốc. Nếu terminal báo không tìm thấy `gh`, bạn cần cài GitHub CLI trước; README không đưa lệnh cài GitHub CLI cụ thể.

Chạy installer tương ứng với công cụ của bạn:

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

Mỗi lệnh tạo artifact cho harness tương ứng và liên kết các plugin cục bộ vào cấu hình người dùng của công cụ đó. Pi cần extension `subagent` tham chiếu hoặc extension tương thích để agent hoạt động. Đường dẫn cấu hình và lệnh gỡ cài đặt được nêu trong global install guide của repo.

### Cài cho Cursor

README cho biết Cursor dùng registry marketplace của plugin. Bạn cần làm theo hướng dẫn Cursor trong tài liệu repo để thêm marketplace và cài plugin.

README chưa ghi lệnh cụ thể cho Cursor trong phần nội dung được cung cấp. Vì vậy, không nên tự đoán command hoặc đường dẫn. Hãy mở phần Cursor setup instructions trong repo và làm đúng theo registry đã commit.

### Sinh và kiểm tra artifact

Từ thư mục gốc repo, bạn có thể chạy bộ kiểm tra dành cho contributor:

```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 kiểm tra garden được repo cung cấp. Các lệnh này phù hợp khi bạn muốn xác nhận cấu trúc hoặc đang chỉnh sửa nội dung trong repo.

Để chấm tĩnh một skill cụ thể, chạy:

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

Lệnh này dùng `uv` chạy `plugin-eval` trong project `plugins/plugin-eval`, sau đó chấm skill `python-testing-patterns` ở độ sâu `quick`. Nếu thiếu dependency hoặc `uv`, lệnh sẽ không chạy được.

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

Cách kiểm tra phụ thuộc tuyến cài đặt. Với Claude Code, marketplace và plugin phải được đăng ký thành công, sau đó command sau phải được nhận diện:

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

Với Codex CLI, hai lệnh `codex plugin` không báo lỗi và plugin xuất hiện trong cấu hình hoặc danh sách plugin của Codex là dấu hiệu cài thành công. README không cung cấp một màn hình đầu ra cụ thể.

Với tuyến clone, các lệnh `make install-opencode`, `make install-antigravity`, `make install-copilot` hoặc `make install-pi` phải chạy được từ thư mục gốc. Repo cho biết các lệnh này tạo artifact và liên kết plugin vào cấu hình người dùng.

Nếu muốn kiểm tra nội dung được sinh, chạy:

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

Kết quả mong đợi là quá trình sinh và kiểm tra hoàn tất mà không có lỗi. Với skill, chạy `plugin-eval` ở trên để nhận điểm kiểm tra tĩnh. Điểm này không phải bằng chứng rằng mọi yêu cầu trong dự án sẽ thành công.

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

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

Một chủ shop có đội kỹ thuật nhỏ muốn làm service FastAPI có kiểm thử có thể cài plugin `python-development` trong Claude Code, rồi gọi:

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

Kết quả mong đợi là Claude dùng workflow scaffold Python để bắt đầu service và test. README chỉ nêu rõ ví dụ FastAPI này; cấu trúc dữ liệu đơn hàng, thanh toán hay kho cần được bạn mô tả thêm trong yêu cầu.

### Nhân viên văn phòng quản lý một dự án nội bộ

Một nhân viên văn phòng có thể nhờ người phụ trách kỹ thuật dùng các plugin trong `developer-essentials` cho review code, debug, Git và mẫu kiểm thử. Khi plugin đã được cài, người phụ trách có thể yêu cầu công cụ review một thay đổi hoặc giải thích lỗi theo workflow có sẵn.

Repo không đưa một prompt mẫu riêng cho tình huống văn phòng. Vì vậy, hãy nêu rõ mục tiêu, file cần xem và kết quả mong muốn trong yêu cầu gửi cho công cụ.

### Dev mới học kiểm thử Python

Một dev mới không cần cài cả bộ plugin. Có thể cài riêng skill `python-testing-patterns`:

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

Sau đó chọn công cụ lập trình khi trình cài hỏi. Cách này phù hợp khi bạn chỉ cần hướng dẫn về mẫu kiểm thử Python và muốn tránh cài thêm agent, command hoặc hook không dùng đến.

### Nhóm phát triển muốn kiểm tra bảo mật

Nhóm phát triển có thể chọn plugin `security-scanning` để hỗ trợ review bảo mật, kiểm tra dependency và code scanning. README xếp đây là một trong các plugin khởi đầu được gợi ý.

Nếu nhóm đang phát triển JavaScript hoặc TypeScript, có thể xem plugin `javascript-typescript`. Với Python, Django, FastAPI, testing và packaging, plugin `python-development` là lựa chọn trực tiếp hơn.

> Chọn đúng plugin giúp AI làm việc theo quy trình, nhưng kết quả vẫn cần được kiểm tra trong dự án thật.
>
> — Ông T

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

### Chạy Makefile nhưng thiếu uv hoặc Python

Tuyến cài từ clone yêu cầu `uv` và Python 3.12 trở lên. Nếu lệnh `make install-*` lỗi ngay từ đầu, kiểm tra hai yêu cầu này trước và bảo đảm terminal đang ở thư mục repo.

### Dùng sai lệnh cho harness

Lệnh `/plugin ...` dành cho Claude Code, còn `codex plugin ...` dành cho Codex CLI. OpenCode, Antigravity CLI, Copilot và Pi dùng các mục tiêu `make install-*`. Chọn đúng tuyến theo công cụ đang chạy.

### Cài skill nhưng mong có cả agent và command

`gh skill install` và `npx skills add` chỉ cài skill. Chúng không cài agent, command hoặc hook của plugin. Nếu cần nhóm component đầy đủ, hãy cài plugin theo marketplace hoặc clone repo theo hướng dẫn của harness.

### Plugin hoặc artifact quá lớn so với giới hạn của công cụ

README cho biết bản cài native của Codex đọc skill gốc, còn artifact sinh ra có thể tách body lớn thành file tham chiếu để phù hợp giới hạn 8 KB. Nếu một tuyến không nhận đủ nội dung, hãy xem Codex setup details và chọn đúng cách cài.

### Đánh giá LLM phát sinh chi phí

Các lớp đánh giá LLM và Monte Carlo là tùy chọn, cần dependency `llm`. Nếu đặt `ANTHROPIC_API_KEY`, model calls dùng key đó và tính phí vào tài khoản API; nếu không, chúng dùng đăng nhập Claude Code. Chỉ bật các lớp này khi bạn hiểu tài khoản nào đang chịu chi phí.

## 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ó workflow sẵn cho Python, JavaScript, TypeScript, review, kiểm thử hoặc bảo mật. Cách viết một lần rồi tạo định dạng cho nhiều harness giúp giảm công sức duy trì khi nhóm đổi công cụ.

Repo cũng phù hợp với người muốn bắt đầu nhỏ. Bạn có thể cài một skill như `python-testing-patterns`, hoặc chọn một plugin như `python-development` thay vì cài cả catalog.

Giới hạn là cách cài không giống nhau giữa các công cụ. Cursor cần xem hướng dẫn riêng; Codex có khác biệt giữa source skill và artifact sinh; Pi cần extension `subagent` hoặc extension tương thích. Một số số liệu và tính năng của external plugin có thể có yêu cầu riêng, vì external plugin có giấy phép riêng.

README không đưa thông tin chung về hệ điều hành, GPU, quyền riêng tư dữ liệu hoặc chi phí của từng công cụ AI. Nếu doanh nghiệp có yêu cầu dữ liệu nghiêm ngặt, bạn cần kiểm tra chính sách của harness và model đang dùng trước khi đưa mã nguồn vào. Nếu bạn chỉ cần một prompt đơn giản hoặc không dùng công cụ nào được repo hỗ trợ, một bộ hướng dẫn nội bộ có thể phù hợp hơn.

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

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

Repo dùng giấy phép MIT. Tuy nhiên, các external plugin có thể có giấy phép riêng, và README không nêu bảng giá cho các công cụ AI hoặc dịch vụ bên ngoài. Các model calls trong phần đánh giá có thể tính phí vào tài khoản API nếu bạn dùng `ANTHROPIC_API_KEY`.

### Có cần GPU không?

README không nêu yêu cầu GPU. Tài liệu tập trung vào plugin, agent, skill, command và các công cụ harness như Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi.

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

README được cung cấp không nêu hệ điều hành được hỗ trợ. Tài liệu có các lệnh shell như `make`, `gh`, `uv` và `npx`, nên bạn cần kiểm tra cách cài tương ứng của công cụ trên môi trường mình dùng.

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

Cài và dùng các component cơ bản không được README nêu là luôn cần API key. Riêng lớp đánh giá LLM dùng `ANTHROPIC_API_KEY` khi biến này được đặt; nếu không, nó dùng đăng nhập Claude Code.

### Dữ liệu và mã nguồn có an toàn không?

README không cung cấp cam kết chung về quyền riêng tư hoặc cách xử lý dữ liệu. Bạn nên kiểm tra chính sách của harness và model trước khi đưa mã nguồn hoặc dữ liệu doanh nghiệp vào công cụ AI.

### Có phải cài toàn bộ repo không?

Không. Bạn có thể cài plugin cụ thể, chẳng hạn `python-development`, hoặc cài riêng một skill bằng `gh skill` hay `npx skills`. Tuyến clone đầy đủ chủ yếu được README hướng dẫn cho OpenCode, Antigravity CLI, GitHub Copilot và Pi.

### wshobson/agents khác gì một plugin riêng lẻ?

Repo là một catalog gồm khoảng 94 plugin, 202 agent, 185 skill và 105 command trong mã nguồn cục bộ. Nó còn có adapter để tạo định dạng cho nhiều harness, thay vì chỉ phục vụ một công cụ hoặc một workflow.
