agentic-awesome-skills: thư viện gần 3.000 skill cho AI viết code — hướng dẫn cài đặt và dùng

Tóm tắt nhanh
Agentic Awesome Skills (AAS) là thư viện hơn 2.950 skill dạng file SKILL.md, tức bộ hướng dẫn dựng sẵn cho các AI coding agent như Claude Code, Codex, Cursor, Gemini CLI. Bạn dùng nó để agent làm việc đúng quy trình hơn mà không phải tự viết hướng dẫn từ đầu. Cài một skill lẻ khá dễ, chỉ cần GitHub CLI và hai dòng lệnh.
Agentic Awesome Skills (gọi tắt AAS) là một thư viện hơn 2.950 "skill" cho các AI coding agent như Claude Code, Codex, Cursor và Gemini CLI. Mỗi skill là một file SKILL.md: một bản hướng một trang tin tức sẵn để agent làm một việc theo đúng quy trình, ví dụ động não ý tưởng, kiểm thử, bảo mật hay làm tài liệu.
Vấn đề nó giải quyết rất đời thường. Bạn nhờ AI làm việc, nhưng mỗi lần lại phải gõ lại cách làm mong muốn. Skill giúp bạn viết một lần, dùng lại mãi. Thay vì tự soạn, bạn lấy từ một kho có sẵn gần 3.000 mục, chia theo mảng việc.
Repo này hợp với lập trình viên mới, người làm văn phòng đã bắt đầu dùng agent AI, và dân kinh doanh muốn agent làm việc có quy trình. Điểm đáng giá nhất: bạn xem được toàn bộ nội dung từng skill trước khi cài, và có thể ghim đúng một phiên bản. Hiện repo có khoảng 49.600 sao và 7.200 fork, giấy phép MIT cho phần code.
sickn33/agentic-awesome-skills
Thư viện hơn 2.950 file SKILL.md dùng được với Claude Code, Codex, Cursor, Gemini CLI; kèm AAS Core để agent tự chọn skill và xem trước kế hoạch.
I.AAS làm được gì
A.Kho skill rất lớn, tìm được từng cái
Thư mục skills/ chứa các bản hướng dẫn gốc, mỗi skill nằm ở skills/<tên-skill>/SKILL.md. Bạn có thể xem danh mục ở file CATALOG.md, hoặc trên trang catalog trực tuyến. Lợi ích: bạn đọc được skill viết gì trước khi để agent làm theo.
B.AAS Core: để agent tự chọn skill phù hợp
Core là phần giúp Codex hoặc Claude tìm trong toàn bộ danh mục trên máy bạn, tự chọn các skill cần dùng rồi ghi lại lựa chọn. Sau đó bạn xem trước một bản kế hoạch (plan preview) trước khi có gì bị thay đổi. Có hai điểm cần nhớ:
- Core không xếp hạng hay gợi ý skill. Agent là bên chọn, bạn là bên duyệt.
- Core xem trước kế hoạch, chứ không cài skill giúp bạn trong đường chạy được hỗ trợ. Phần "apply" và khôi phục vẫn là thử nghiệm.
Lệnh aas stack validate kiểm tra file aas-stack.json (danh sách skill đã chọn), còn aas stack plan tạo bản xem trước không thể sửa để bạn rà soát. Một stack tối đa 128 skill.
C.Plugin theo mảng việc
Nếu không muốn tự nhặt từng skill, bạn có thể chọn gói theo nghề. README liệt kê các plugin cho Claude Code và Codex, ví dụ AAS Web App Builder, AAS Security Engineer, AAS Documents & Presentations (file văn phòng, chuyển đổi tài liệu, slide), AAS Data Analytics, AAS QA & Test Automation, AAS DevOps & Cloud, AAS SaaS Launch & Revenue. Mỗi gói có khoảng 8 đến 10 skill.
D.Bundle và workflow
Bundle là nhóm skill gợi ý theo vai trò, như Web Wizard, Security Engineer, OSS Maintainer. Workflow là thứ tự các bước khi lập kế hoạch, làm, kiểm thử, rà soát. Cả hai chỉ là hướng dẫn chọn skill, không phải gói để cài riêng.
E.Trang Workbench trong trình duyệt
Workbench là công cụ web để xem stack và plan ngay trong bộ nhớ trình duyệt, theo README là không truy cập file trên máy bạn.
II.Cần chuẩn bị gì
Tư liệu của repo nói như sau, mình chỉ liệt kê những gì có:
- Một AI coding agent bạn đang dùng. README liệt kê: Claude Code, Cursor, Gemini CLI, Codex, Antigravity 2.0, Antigravity CLI, GitHub Copilot, Kiro CLI, OpenCode, AdaL.
- GitHub CLI (lệnh
gh) có hỗ trợgh skill, nếu bạn cài từng skill bằng cách trực tiếp từ GitHub. - Node phiên bản 22 trở lên, theo
package.json. Bạn cần mục này khi dùng công cụ trong repo (ví dụnpm run validatekhi đóng góp skill). - Hệ điều hành: README không nêu yêu cầu riêng. Phần xử lý sự cố có nhắc tới Windows, Linux và macOS, nên cả ba đều có người dùng.
- Phần cứng, GPU: tư liệu không nói gì, vì skill chỉ là file văn bản.
- API key: README không yêu cầu key cho việc cài skill. File
.env.local.examplecó một biến tênTYPESAFE_API_KEY, nhưng tư liệu không giải thích dùng vào việc gì, nên mình không khuyên điền bừa.
Một số skill trong danh sách nguồn kết nối tới dịch vụ bên ngoài (dịch vụ trả phí, MCP server có điều khoản riêng). Trước khi cho agent dùng, hãy đọc nội dung skill đó. Skill được nhập từ nơi khác giữ giấy phép riêng, nên đừng mặc định mọi thứ đều miễn phí hay không ràng buộc.
III.Cài đặt từng bước
Lưu ý quan trọng: README ghi việc đăng gói mới lên npm đang tạm dừng vì tài khoản người bảo trì bị khoá. Vì vậy mình không hướng dẫn cài bằng npm. Hãy cài trực tiếp từ GitHub như dưới đây.
- Cài GitHub CLICó lệnh gh dùng được trên máy
- Chọn agentTra giá trị --agent ứng với công cụ của bạn
- Xem trước skillĐọc nội dung trước khi cài
- Cài skillCài và ghim đúng bản phát hành
- Cập nhật khi cầnXem trước ở tag mới rồi cài lại
A.Cài GitHub CLI
README yêu cầu có GitHub CLI và lệnh gh skill. Trang tải của GitHub CLI là https://cli.github.com/. Cài xong, bạn mở terminal mới (PowerShell trên Windows, Terminal trên macOS) rồi gõ thử:
gh --versionNếu máy báo không tìm thấy lệnh gh, bạn chưa cài xong hoặc cần mở lại terminal. README không nói rõ phiên bản gh tối thiểu có gh skill, nên nếu lệnh gh skill không nhận, hãy thử cập nhật GitHub CLI.
B.Chọn đúng giá trị --agent
Mỗi công cụ có một giá trị riêng để truyền vào cờ --agent:
| Công cụ | Giá trị |
|---|---|
| Claude Code | claude-code |
| Cursor | cursor |
| Gemini CLI | gemini-cli |
| Codex | codex |
| Antigravity 2.0 | antigravity2.0 |
| Antigravity CLI | antigravity-cli |
| GitHub Copilot | github-copilot |
| Kiro CLI | kiro-cli |
| OpenCode | opencode |
| AdaL | adal |
Nếu bạn muốn cài vào một thư mục tự chọn, README cho phép dùng --dir <thư mục> thay cho --agent và --scope.
C.Xem trước một skill
Lệnh dưới đây xem skill brainstorming ở bản phát hành v20.8.0 mà chưa cài gì. Đây là bước nên làm, vì bạn đọc được skill định bảo agent làm gì.
gh skill preview sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md@v20.8.0D.Cài skill và ghim phiên bản
Ví dụ trong README dùng Codex, phạm vi người dùng (--scope user, tức dùng cho tài khoản của bạn trên máy này), và ghim bản v20.8.0:
gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md --agent codex --scope user --pin v20.8.0Nếu bạn dùng Claude Code, đổi codex thành claude-code. Muốn cài skill khác, thay phần skills/brainstorming/SKILL.md bằng đường dẫn skill đó trong thư mục skills/. Tên thư mục phải đúng với tên trong repo, nên hãy tra ở CATALOG.md trước.
E.Cập nhật skill đã ghim
README mô tả: xem trước skill ở tag mới hơn, rồi chạy lại lệnh cài với tag đó. Tức là lặp lại hai lệnh trên, chỉ đổi v20.8.0 thành tag mới.
F.Muốn tải cả repo về máy
Nếu bạn chỉ muốn đọc hoặc đóng góp, có thể tải repo bằng git:
git clone https://github.com/sickn33/agentic-awesome-skills.git
cd agentic-awesome-skillsRepo cũng có hướng dẫn cài và cập nhật không qua npm (tải ZIP, cập nhật bản git clone). README chưa chép chi tiết các lệnh đó ở phần mình có, bạn xem trong thư mục docs/ của repo.
G.Cài plugin và bật AAS Core
README chỉ nói rằng cài plugin cho Claude Code và Codex được mô tả trong "plugin guide", cùng với hướng dẫn thiết lập Core riêng cho Codex và Claude Code trên trang aaskills.tech. Phần README mình có không ghi lệnh cụ thể cho hai việc này, nên bạn hãy làm theo các trang hướng dẫn đó và file docs/users/aas-core.md trong repo.
IV.Kiểm tra đã chạy được chưa
Tư liệu không mô tả một dòng kết quả cố định sau khi cài. Bạn có thể tự kiểm tra theo các cách hợp lý sau:
- Lệnh
gh skill previewin ra nội dung skill mà không báo lỗi: nghĩa làghvà quyền truy cập repo đang ổn. - Lệnh
gh skill installkết thúc không báo lỗi: nghĩa là skill đã được ghi vào đúng vị trí cho agent bạn chọn. README không nêu đường dẫn thư mục cụ thể, nên mình không đoán. - Mở lại agent (Codex, Claude Code…) và nhờ nó dùng skill, ví dụ: "Dùng skill brainstorming để giúp mình lên ý tưởng cho tính năng này". Nếu agent nhắc tới hoặc làm theo quy trình của skill, bạn đã cài thành công.
- Với AAS Core: sau khi agent chọn skill và lưu
aas-stack.json, chạyaas stack validateđể kiểm tra file. README nhấn mạnh việc hợp lệ về cấu trúc không đảm bảo skill phù hợp hay an toàn khi áp dụng, nên bạn vẫn phải tự đọc.
V.Dùng vào việc thật
A.Lập trình viên mới muốn có quy trình làm việc rõ ràng
Bạn vừa bắt đầu dùng Codex để viết ứng dụng nhỏ, nhưng AI hay lao vào code ngay khi ý tưởng còn mơ hồ. Bạn cài skill brainstorming bằng hai lệnh ở trên. Rồi trong agent, bạn gõ:
Dùng skill brainstorming. Mình muốn làm ứng dụng ghi chú chi tiêu cho gia đình. Hãy hỏi mình từng câu một để làm rõ yêu cầu trước khi viết code.Kết quả mong đợi: agent đi theo quy trình trong skill thay vì làm liền. Cách agent hỏi cụ thể phụ thuộc nội dung skill, nên bạn nên chạy gh skill preview trước để biết nó làm gì.
Skill là bản hướng dẫn bạn viết một lần, rồi mọi lần sau agent đều làm theo.
Ông T
B.Nhân viên văn phòng cần làm slide và xử lý tài liệu
Bạn dùng Claude Code hoặc Codex để chuẩn bị báo cáo hằng tuần. Trong danh sách plugin có gói AAS Documents & Presentations (9 skill), mô tả là dành cho file văn phòng, chuyển đổi tài liệu, slide. Bạn cài plugin này theo plugin guide, rồi giao việc bằng một câu bình thường, ví dụ: "Chuyển file báo cáo tuần này thành bộ slide 8 trang, mỗi trang một ý chính". Kết quả phụ thuộc vào agent và skill bạn bật, vì vậy bạn nên đọc lại bản slide trước khi gửi cho sếp.
C.Chủ sản phẩm số cần kiểm thử trước khi ra mắt
Bạn có một trang web bán hàng nhỏ do freelancer làm và muốn kiểm tra trước khi chạy quảng cáo. Gói AAS QA & Test Automation (10 skill, dành cho bộ test, tự động hoá trình duyệt, ổn định QA) và AAS Accessibility & Inclusive UX (8 skill, kiểm tra WCAG, đọc màn hình) là hai gói liên quan. Bạn có thể đưa cho agent một yêu cầu như: "Rà soát trang đặt hàng theo hướng dẫn kiểm thử, liệt kê lỗi theo mức độ nghiêm trọng". Bạn nhận được danh sách việc cần sửa để chuyển cho người làm web.
D.Dev muốn agent tự chọn bộ skill cho dự án
Dự án của bạn có nhiều mảng và bạn không biết nên cài skill nào trong gần 3.000 cái. Với AAS Core, agent đọc dự án, tìm trong danh mục cục bộ rồi chọn đúng ID skill. Bạn lưu lại aas-stack.json, chạy:
aas stack validate
aas stack planvalidate kiểm tra file, còn plan tạo bản xem trước để bạn duyệt. Kết quả là một danh sách skill có thể xem lại và dùng lại, thay vì cài lung tung. Với cách này, bạn chịu trách nhiệm duyệt, vì Core không tự đánh giá skill nào hợp.
VI.Lỗi hay gặp và cách xử lý
A.Lệnh gh skill không nhận
Thường do GitHub CLI chưa cài, chưa mở lại terminal sau khi cài, hoặc bản gh quá cũ. Kiểm tra bằng gh --version, cập nhật GitHub CLI rồi thử lại. README yêu cầu có gh skill, nên đây là điều kiện bắt buộc.
B.Cố cài bằng npm rồi thất bại
README ghi việc đăng gói mới lên npm đang tạm dừng. Gói agentic-awesome-skills có thể cũ hơn bản trên GitHub. Hãy dùng cách cài trực tiếp từ GitHub ở trên. Nếu bạn từng cài bằng npm, repo có hướng dẫn chuyển từ npm sang cách cài khác, xem trong thư mục docs/.
C.Agent chậm, nhiễu hoặc "quá tải" vì cài quá nhiều skill
README có nhắc tình trạng quá tải trên Antigravity và trên Linux/macOS khi cài nhiều skill. Cách an toàn: chỉ cài những skill thật sự cần, xem trước từng cái. README cũng nhắc bộ lọc --risk, --category, --tags của trình cài đặt, và hướng dẫn kích hoạt chọn lọc cho Antigravity.
D.Phần mềm diệt virus báo cảnh báo hoặc Windows bị cắt ngữ cảnh
Mục xử lý sự cố của README có đề cập tới cảnh báo diệt virus và việc Windows bị cắt ngữ cảnh. Bạn xem các tài liệu "Windows context and truncation recovery" và "Security and antivirus alerts" trong repo. Đừng tắt phần mềm bảo mật một cách vô điều kiện, hãy đọc nội dung file bị báo trước.
E.Nhầm kiến thức về Core
Người mới hay nghĩ Core sẽ tự cài mọi thứ. Thực tế đường chạy được hỗ trợ chỉ tìm, ghi lại lựa chọn, kiểm tra và xem trước kế hoạch. Apply và khôi phục là thử nghiệm, cần bật riêng.
VII.Có nên dùng không
Điểm mạnh: kho rất lớn, giấy phép MIT cho phần code, mỗi skill là file văn bản đọc được, có thể ghim phiên bản, và repo còn được cập nhật trong 3 tháng gần đây. Cách thiết kế của Core (agent chọn, người duyệt, có bản xem trước) cũng khá cẩn trọng.
Giới hạn cần biết:
- Đây là dự án cộng đồng độc lập, không liên kết với Google, dù nhắc tên Antigravity và Gemini để nói về khả năng tương thích.
- Skill được nhập từ nhiều nguồn, mỗi cái giữ giấy phép và yêu cầu ghi nguồn riêng. Một số gắn với dịch vụ ngoài có điều khoản riêng.
- Hợp lệ về cấu trúc không có nghĩa skill phù hợp, tương thích hay an toàn. Bạn vẫn phải đọc.
- Nhiều skill đồng thời có thể làm agent quá tải. Ít mà chọn kỹ thì tốt hơn.
- Đường cài bằng npm đang tạm dừng, nên bạn phụ thuộc vào GitHub CLI.
Nếu bạn chỉ cần một vài quy trình quen thuộc, tự viết SKILL.md ngắn của riêng mình có thể đủ. Còn nếu bạn muốn một kho có sẵn để thử, đọc và chọn lọc, thì repo này là điểm khởi đầu đáng thử. Hãy bắt đầu từ một skill duy nhất, xem trước, cài, dùng thử rồi mới mở rộng.
Câu hỏi thường gặp
Agentic Awesome Skills có miễn phí không?
Code và công cụ của repo dùng giấy phép MIT, còn nội dung viết gốc theo CC BY 4.0. Các skill nhập từ nguồn khác giữ giấy phép riêng. Một số skill kết nối dịch vụ bên ngoài có điều khoản và chi phí riêng, nên bạn cần đọc từng skill.
Skill ở đây là gì, khác gì plugin hay MCP?
Skill là file SKILL.md chứa hướng dẫn để AI agent làm một việc theo quy trình. Plugin là gói gom nhiều skill theo mảng việc, dành cho Claude Code và Codex. Repo cũng nhắc tới CLI và MCP, nhưng phần README mình có không so sánh chi tiết với các công cụ khác.
Cần GPU hoặc máy mạnh không?
Tư liệu không nêu yêu cầu phần cứng. Skill chỉ là file văn bản, nên việc nặng do agent AI bạn đang dùng đảm nhận. Yêu cầu duy nhất được nêu là Node từ phiên bản 22 trở lên theo package.json.
Dùng được trên Windows không?
README có mục xử lý sự cố riêng cho Windows (ngữ cảnh bị cắt) cùng mục cho Linux và macOS, và repo có file START_APP.bat. Tư liệu không ghi rõ bảng hệ điều hành được hỗ trợ, nên bạn xem tài liệu trong thư mục docs.
Cài bằng npm được không?
README ghi việc đăng phiên bản mới lên npm đang tạm dừng vì tài khoản người bảo trì bị khoá. Bạn nên cài trực tiếp từ GitHub bằng gh skill, hoặc tải ZIP hay git clone theo hướng dẫn trong repo.
AAS Core có tự cài skill và đảm bảo an toàn không?
Không. Trong đường chạy được hỗ trợ, Core chỉ giúp agent tìm, ghi lại lựa chọn, kiểm tra và xem trước kế hoạch. README nói rõ hợp lệ về cấu trúc không chứng minh skill phù hợp hay an toàn, còn phần apply và khôi phục vẫn là thử nghiệm.
Dữ liệu của tôi có an toàn không?
Workbench xem stack và plan trong bộ nhớ trình duyệt và theo README không truy cập file hệ thống của bạn. Repo có các file PRIVACY.md và SECURITY.md, nhưng tư liệu mình có chưa nêu chi tiết, nên bạn hãy đọc các file đó và nội dung từng skill trước khi dùng.


