wshobson/agents: 94 plugin, agent và skill cho Claude Code — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về wshobson/agents — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: wshobson/agents: Bộ agent AI cho lập trình — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
wshobson/agents là kho plugin, agent, skill và lệ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 theo việc cần làm (Python, JavaScript, bảo mật, review code…) rồi cài bằng vài lệnh. Với Claude Code, cài chỉ mất hai lệnh gõ ngay trong ứng dụng, khá dễ cho người mới.
wshobson/agents là một kho plugin, agent, skill và lệnh (command) viết bằng Markdown, dùng chung cho nhiều công cụ lập trình AI: Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. README gọi các công cụ này là "harness", tức là phần mềm nạp và chạy các thành phần trong kho.
Vấn đề repo giải quyết rất đời thường. Bạn dùng AI để viết code, nhưng mỗi lần phải tự dặn lại: "hãy review kỹ", "viết test theo kiểu này", "kiểm tra bảo mật". Kho này đóng sẵn những chỉ dẫn đó thành các gói, bạn cài một lần rồi gọi ra khi cần. Hiện repo có khoảng 42.457 sao và 4.487 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.
Điểm đáng giá nhất là "viết một lần, chạy nhiều nơi". Tác giả viết mỗi thành phần theo định dạng plugin của Claude Code, rồi các bộ chuyển đổi (adapter) tự sinh ra định dạng cho từng công cụ khác. Nên nếu bạn đổi công cụ, bộ sưu tập này vẫn đi theo bạn. Repo hợp với lập trình viên mới, dân văn phòng bắt đầu nhờ AI viết code, và cả dev có kinh nghiệm muốn có sẵn một bộ "chuyên gia" theo từng mảng.
wshobson/agents
Kho 94 plugin gồm agent, skill và lệnh viết một lần bằng Markdown, dùng được trên Claude Code, Codex CLI, Cursor, OpenCode, Copilot và nhiều công cụ khác.
I.wshobson/agents làm được gì
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 command. Mình giải thích ba loại này trước cho dễ hình dung.
- Agentchỉ dẫn cho một "chuyên gia phụ" nhận việc được giao. Ví dụ một agent chuyên Python hoặc chuyên bảo mật.
- Skilltài liệu hướng dẫn và kiến thức tham khảo mà AI tự nạp khi thấy liên quan. Bạn không phải nhớ gọi nó.
- Commandmột quy trình có tên để bạn chủ động gọi, như dựng khung dự án hay quét bảo mật.
Một plugin gom các thành phần liên quan lại. README lấy ví dụ python-development: gồm 3 agent, 16 skill và một lệnh dựng khung dự án. Bốn plugin README gợi ý để bắt đầu:
python-development: Python, Django, FastAPI, kiểm thử và đóng gói.javascript-typescript: phát triển JavaScript, TypeScript và thiết lập dự án.developer-essentials: review code, gỡ lỗi, Git và mẫu kiểm thử.security-scanning: rà soát bảo mật, kiểm tra thư viện phụ thuộc, quét code.
Lợi ích thực tế: bạn không phải viết lại prompt dài mỗi lần. Chọn plugin đúng mảng, AI sẽ làm việc theo quy trình đã được đóng gói sẵn.
Một điểm nữa là chất lượng. Repo có kiểm tra cấu trúc plugin, kiểm tra các bản sinh ra cho từng công cụ và có công cụ plugin-eval để chấm skill mà không cần gọi model. Phần chấm bằng LLM và mô phỏng Monte Carlo được README ghi rõ là thử nghiệm, chưa đối chiếu với đánh giá của con người.
II.Cần chuẩn bị gì
Tuỳ công cụ bạn dùng mà cần khác nhau. Theo README:
- Công cụ lập trình AI bạn muốn dùng: Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi. Repo chỉ là bộ thành phần, bạn phải có sẵn công cụ này.
- Nếu dùng Codex CLI: cần bản Codex CLI hiện hành.
- Nếu cài từng skill bằng
gh skill: cần GitHub CLI 2.90 trở lên. - Nếu cài từng skill bằng
npx skills: cần Node.js và npm. - Nếu cài từ bản clone (OpenCode, Antigravity CLI, Copilot, Pi): cần uv, Python 3.12 trở lên, và công cụ bạn muốn dùng. README dùng GitHub CLI để clone.
- Nếu dùng Pi: agent cần tiện ích
subagenttham chiếu của Pi hoặc một tiện ích tương thích. - API key: cài plugin không đòi key. Chỉ phần chấm điểm bằng LLM của
plugin-evalmới gọi model; nó dùngANTHROPIC_API_KEYnếu bạn đặt, nếu không thì dùng tài khoản đăng nhập Claude Code.
Tư liệu 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.
Nếu bạn đặt ANTHROPIC_API_KEY rồi chạy phần chấm điểm bằng LLM của plugin-eval, tài khoản API đó sẽ bị tính phí. Việc cài và dùng plugin thông thường không cần chạy phần này.
III.Cài đặt từng bước
Bạn chỉ cần theo đúng một nhánh, ứng với công cụ đang dùng. Mình hướng dẫn nhánh phổ biến nhất là Claude Code, rồi các nhánh còn lại.
- 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ào công cụ
- Cài pluginChọn plugin theo việc, ví dụ python-development
- Gọi thửNhờ AI dùng agent hoặc chạy lệnh của plugin
- Hoặc cài lẻ skillDùng gh skill hoặc npx skills nếu chỉ cần một skill
A.Cài trong Claude Code
Mở Claude Code, rồi gõ hai lệnh sau ngay trong khung chat của nó (không phải trong terminal thường). Lệnh đầu đăng ký marketplace, lệnh sau cài plugin Python.
/plugin marketplace add wshobson/agents
/plugin install python-development@claude-code-workflowsMuốn cài plugin khác, bạn thay tên python-development bằng tên plugin trong danh mục, giữ phần @claude-code-workflows theo đúng mẫu README.
B.Cài trong Codex CLI
Mở terminal (PowerShell hoặc Terminal) và chạy hai lệnh. Cần Codex CLI bản mới.
codex plugin marketplace add wshobson/agents
codex plugin add python-development@claude-code-workflowsLưu ý: bản cài gốc của Codex chỉ hiển thị các skill nguồn. Agent dạng TOML và skill sinh từ command đi theo một đường khác. README có phần "Codex setup details" trong thư mục docs/ để bạn xem trước khi chọn đường cài.
C.Cài trong Cursor
Cursor dùng sổ đăng ký marketplace có sẵn trong repo. README chưa ghi lệnh cụ thể mà chỉ dẫn bạn theo hướng dẫn Cursor trong tài liệu của repo. Bạn mở thư mục docs/ trong repo để xem phần thiết lập Cursor.
D.Chỉ cài một skill
Nếu bạn không cần cả plugin, hãy cài riêng từng skill. Cách này không cần clone repo, và chỉ cài skill, không kèm agent, command hay hook. Khi chạy, công cụ sẽ hỏi bạn chọn công cụ lập trình đang dùng.
gh skill install wshobson/agents python-testing-patterns
npx skills add wshobson/agents --skill python-testing-patternsHai lệnh này làm cùng một việc, bạn chỉ cần chọn một. gh skill cần GitHub CLI 2.90 trở lên; npx cần Node.js và npm.
E.Cài từ bản clone (OpenCode, Antigravity, Copilot, Pi)
Với bốn công cụ này, bạn tải repo về máy rồi chạy bộ cài. Trước hết cần có uv, Python 3.12 trở lên và công cụ bạn muốn dùng. Lệnh dưới đây dùng GitHub CLI để tải repo về thư mục ~/agents rồi đi vào đó:
gh repo clone wshobson/agents ~/agents
cd ~/agentsNếu chưa có GitHub CLI, bạn có thể dùng lệnh git phổ thông thay thế:
git clone https://github.com/wshobson/agents.git ~/agents
cd ~/agentsSau đó chạy đúng một lệnh ứng với công cụ của bạn. Mỗi lệnh sẽ sinh các bản 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ụ đó:
make install-opencode
make install-antigravity
make install-copilot
make install-piChỗ người mới hay vấp: lệnh make phải chạy trong thư mục repo (nơi có file Makefile), nên đừng quên cd ~/agents trước. Trên Windows, README không nói rõ cách chạy make; phần này chưa có thông tin, bạn xem hướng dẫn cài toàn cục trong docs/.
IV.Kiểm tra đã chạy được chưa
Với Claude Code, cách đơn giản nhất là gọi thử lệnh của plugin vừa cài. Nếu lệnh được nhận ra và AI bắt đầu làm việc, plugin đã hoạt động:
/python-development:python-scaffold Create a FastAPI service with testsBạn cũng có thể chỉ cần nhờ Claude dùng các agent Python cho việc của mình, theo đúng gợi ý của README.
Nếu bạn tải repo về để thử hoặc đóng góp, README có ba lệnh kiểm tra chạy từ thư mục gốc:
make generate-all
make validate STRICT=1
make gardenCó thể kiểm tra riêng một skill bằng plugin-eval, chạy tĩnh, không gọi model:
uv run --project plugins/plugin-eval plugin-eval score plugins/python-development/skills/python-testing-patterns --depth quickKết quả cụ thể của các lệnh này README không mô tả, nên mình không đoán màn hình sẽ trông thế nào. Bạn chỉ cần xem lệnh chạy xong không báo lỗi.
V.Dùng vào việc thật
Dưới đây là các tình huống bám sát khả năng mà README mô tả. Các câu lệnh mẫu mình tự đặt để bạn hình dung, còn tên lệnh và plugin lấy từ tư liệu.
A.Dựng nhanh một dịch vụ Python có test
Bối cảnh: bạn là lập trình viên mới, cần một dịch vụ web nhỏ để nhận đơn hàng. Sau khi cài python-development, bạn chạy lệnh dựng khung của plugin:
/python-development:python-scaffold Create a FastAPI service with testsKết quả: AI dựng khung dự án FastAPI kèm phần kiểm thử, dựa trên các chỉ dẫn Python đã đóng gói sẵn. Bạn tiếp tục nhờ nó thêm tính năng mà không phải tự nghĩ cấu trúc từ đầu.
B.Review code và gỡ lỗi trước khi nộp
Bối cảnh: bạn vừa viết xong một đoạn code và hơi ngại có lỗi. Cài developer-essentials (nhóm này lo review code, gỡ lỗi, Git và kiểm thử), rồi nhờ trong khung chat:
Hãy review đoạn code vừa sửa, chỉ ra lỗi có thể xảy ra và đề xuất cách sửa.Kết quả: AI dùng các chỉ dẫn review và gỡ lỗi của plugin để trả lời có hệ thống hơn so với một câu hỏi trống.
Cài một lần, bạn có cả một nhóm chuyên gia đứng chờ sẵn — việc của bạn chỉ là gọi đúng người.
Ông T
C.Rà soát bảo mật cho dự án nhỏ
Bối cảnh: bạn làm website bán hàng cho shop và muốn kiểm tra sơ bộ trước khi mở cho khách. Cài security-scanning, plugin phục vụ rà soát bảo mật, kiểm tra thư viện phụ thuộc và quét code:
/plugin install security-scanning@claude-code-workflowsSau đó nhờ AI quét dự án và liệt kê điểm đáng lo. Tên lệnh quét cụ thể mình không ghi ở đây vì README không liệt kê; bạn xem danh mục plugin và hướng dẫn sử dụng trong docs/. Kết quả mang tính tham khảo, không thay thế kiểm tra bảo mật chuyên nghiệp.
D.Chỉ lấy một skill kiểm thử
Bối cảnh: bạn đã có công cụ ưa thích và không muốn cài cả plugin. Bạn cài riêng skill mẫu kiểm thử Python:
npx skills add wshobson/agents --skill python-testing-patternsKết quả: skill được cài mà không kéo theo agent, command hay hook. Khi bạn nhờ AI viết test, nó có thêm kiến thức về các mẫu kiểm thử Python.
VI.Lỗi hay gặp và cách xử lý
Gõ lệnh /plugin trong terminal thường nên không chạy. Lệnh /plugin marketplace add phải gõ bên trong Claude Code. Mở Claude Code trước rồi dán lệnh vào khung chat.
make báo không tìm thấy mục tiêu hoặc không có Makefile. Thường là bạn đang đứng sai thư mục. Hãy cd ~/agents (thư mục bạn vừa clone) rồi chạy lại. Nếu máy chưa có make, README chưa ghi cách cài; bạn có thể xem phần cài toàn cục trong docs/.
gh skill không nhận lệnh. Lệnh này cần GitHub CLI 2.90 trở lên. Bạn kiểm tra phiên bản và nâng cấp, hoặc chuyển sang npx skills add (cần Node.js và npm).
Cài bản clone nhưng thiếu uv hoặc Python quá cũ. README yêu cầu uv và Python 3.12 trở lên. Cài hoặc nâng cấp rồi chạy lại lệnh make install-....
Dùng Pi nhưng agent không chạy. README nói agent của Pi cần tiện ích subagent hoặc một tiện ích tương thích. Skill và mẫu prompt vẫn dùng được mà không cần nó.
Một số thành phần hiện ở công cụ này nhưng thiếu ở công cụ kia. Đây là hạn chế do thiết kế: thành phần khả dụng phụ thuộc đường cài và khả năng của từng công cụ. Hãy xem bảng khả năng (capability matrix) trong docs/.
VII.Có nên dùng không
Điểm mạnh: kho lớn, phủ nhiều mảng (Python, JavaScript, bảo mật, review, hạ tầng), giấy phép MIT, và dùng chung được trên nhiều công cụ. Có kiểm tra tự động nên các bản sinh ra cho từng công cụ ít sai lệch. Cài với Claude Code chỉ cần hai lệnh.
Giới hạn: 94 plugin là khá nhiều, người mới dễ choáng, nên bắt đầu bằng bốn plugin gợi ý. Không phải thành phần nào cũng có mặt ở mọi công cụ. Phần chấm điểm bằng LLM còn là thử nghiệm, và README nói điểm số không chứng minh một việc sẽ thành công trong dự án của bạn. Hai mục ngoài repo có giấy phép và cách cài riêng.
Khi nào nên chọn cách khác: nếu bạn chỉ cần một kỹ năng nhỏ, hãy cài lẻ skill như hướng dẫn ở trên. Nếu bạn không dùng công cụ lập trình AI nào, repo này chưa giúp được gì vì nó chỉ là bộ thành phần cho các công cụ đó.
Câu hỏi thường gặp
wshobson/agents có miễn phí không?
Repo dùng giấy phép MIT, bạn có thể tải và dùng. Các mục bên ngoài có giấy phép riêng. Chi phí khi dùng AI phụ thuộc công cụ bạn chọn; riêng phần chấm điểm bằng LLM của plugin-eval sẽ tính vào tài khoản API nếu bạn đặt ANTHROPIC_API_KEY.
Repo này dùng được với công cụ nào?
README nêu Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Mỗi công cụ có đường cài riêng, và thành phần khả dụng khác nhau tuỳ khả năng của công cụ.
Cài trên Claude Code như thế nào?
Trong Claude Code, gõ /plugin marketplace add wshobson/agents rồi /plugin install python-development@claude-code-workflows. Muốn plugin khác thì đổi tên plugin theo danh mục.
Có cần GPU không?
Tư liệu không nhắc yêu cầu về GPU hay phần cứng. Repo chủ yếu là các tệp Markdown và bộ chuyển đổi bằng Python, còn việc chạy mô hình do công cụ AI bạn dùng đảm nhiệm.
Chạy được trên Windows 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 chính công cụ. Với các lệnh make, README chưa có thông tin riêng cho Windows.
Tôi chỉ muốn dùng một skill thì sao?
Dùng gh skill install wshobson/agents python-testing-patterns hoặc npx skills add wshobson/agents --skill python-testing-patterns. Cách này không cần clone repo và chỉ cài skill, không kèm agent, command hay hook.
Dữ liệu của tôi có an toàn không?
Tư liệu không nói gì về xử lý dữ liệu. Plugin là các chỉ dẫn được công cụ AI của bạn nạp và chạy, nên dữ liệu đi theo chính sách của công cụ đó. Bạn nên tự đọc nội dung plugin trước khi cài.


