Agent Skills của Addy Osmani: quy trình kỹ sư cho AI lập trình
Agent Skills của Addy Osmani là bộ 17 skill theo 6 giai đoạn, từ viết spec tới phát hành, giúp AI agent lập trình làm việc như kỹ sư lâu năm.
Thử hình dung thế này. Anh trưởng nhóm kỹ thuật nhờ agent thêm một trang đăng ký cho khách. Agent làm rất nhanh, nhưng không viết spec, không có test, form thì nhận mọi thứ người dùng gõ vào mà không lọc. Hỏi thì agent đáp tỉnh bơ: "Phần test để sau bổ sung ạ". Câu này nghe quen như học sinh khai "em để quên vở ở nhà".
Agent Skills của Addy Osmani sinh ra để chặn đúng kiểu viện cớ đó. Đây là bộ skill mã nguồn mở gói quy trình của kỹ sư lâu năm thành các file hướng dẫn để AI agent lập trình làm theo: viết spec trước, chia việc nhỏ, test, rà bảo mật, rồi mới phát hành.
Đọc nhanh trong 30 giây
- Agent Skills là repo
addyosmani/agent-skillscủa Addy Osmani, công khai ngày 15/02/2026 (giờ Mỹ), giấy phép MIT.- Gồm 17 skill chia theo 6 giai đoạn, 1 skill định hướng, 3 agent chuyên trách và 6 lệnh tắt
/spec,/plan,/build,/test,/review,/ship.- Cài bằng cách clone repo rồi chép skill vào thư mục skill của Claude Code; dùng được với Cursor, Windsurf, Copilot, Codex.
- Hợp với đội phát triển web muốn agent làm theo quy trình chung.
Agent Skills của Addy Osmani là gì?
Agent Skills là một thư viện quy trình, mỗi skill là một file SKILL.md mô tả các bước, điểm kiểm tra và tiêu chí xong cho một giai đoạn làm phần mềm. README nói thẳng vấn đề nó giải quyết: agent mặc định chọn đường ngắn nhất, nghĩa là thường bỏ qua spec, test, rà soát bảo mật.
Ví von cho dễ hình dung: Agent Skills giống bảng kiểm trước khi cất cánh của phi công. Phi công lái hàng nghìn giờ vẫn phải đọc từng dòng: nhiên liệu, cánh tà, liên lạc với đài. Không phải vì họ kém, mà vì người giỏi cũng có lúc quên. Agent cũng thế, giỏi nhưng hay bỏ bước.
Sáu giai đoạn, sáu lệnh tắt, đi từ ý tưởng tới lúc phát hành.
| Giai đoạn | Skill | Lệnh tắt |
|---|---|---|
| Định nghĩa | idea-refine, spec-driven-development |
/spec |
| Lập kế hoạch | planning-and-task-breakdown |
/plan |
| Xây dựng | incremental-implementation, context-engineering, frontend-ui-engineering, api-and-interface-design |
/build |
| Kiểm chứng | test-driven-development, browser-testing-with-devtools, debugging-and-error-recovery |
/test |
| Rà soát | code-review-and-quality, security-and-hardening, performance-optimization |
/review |
| Phát hành | git-workflow-and-versioning, ci-cd-and-automation, documentation-and-adrs, shipping-and-launch |
/ship |
Ngoài ra có skill định hướng using-agent-skills giúp agent chọn skill hợp loại việc, ba agent chuyên trách code-reviewer, test-engineer, security-auditor, và bốn bảng kiểm về khả năng truy cập, hiệu năng, bảo mật, mẫu viết test.
Vì sao bộ skill này khó "lách luật"?
Agent Skills khác bộ prompt thông thường ở chỗ mỗi skill là quy trình có bước kiểm chứng. Trong sáu nguyên tắc thiết kế README nêu, ba điểm đáng chú ý:
- Chống viện cớ. Các skill quan trọng có bảng những lý do agent hay dùng để bỏ bước, kèm câu đáp lại. Câu "để sau rồi thêm test" ở đầu bài có sẵn lý lẽ phản bác, như cô giáo đã nghe đủ mọi kiểu lý do quên vở.
- Kiểm chứng là bắt buộc. Skill nào cũng có bước kiểm chứng. "Trông có vẻ đúng" không được tính, phải có bằng chứng như kết quả test, đầu ra build, dữ liệu chạy thật.
- Nạp dần.
SKILL.mdlà cửa vào, tài liệu phụ chỉ được nạp khi cần, để đỡ tốn token.
Cách tiếp cận này gần với tinh thần Spec Kit của GitHub: viết rõ cần làm gì trước khi để agent viết code. Khác biệt là Agent Skills phủ cả vòng đời, tới tận rà soát và phát hành.
Agent Skills khác gì mattpocock/skills?
Agent Skills là một bộ quy trình đóng gói, còn mattpocock/skills ra đầu tháng 2 giống hộp đồ nghề cá nhân. Hai bộ không loại trừ nhau.
Một bên gọn và cá nhân, một bên đầy đủ và có giấy phép rõ.
| mattpocock/skills | addyosmani/agent-skills | |
|---|---|---|
| Số skill | 7 | 17 và 1 skill định hướng |
| Tài liệu | Chưa có README | README đầy đủ, hướng dẫn cho nhiều agent |
| Giấy phép | Chưa ghi | MIT |
| Phong cách | Đồ nghề cá nhân, ngắn | Bộ quy trình đóng gói, phủ vòng đời |
Cài Agent Skills cho Claude Code và agent khác
README đưa hai cách cho Claude Code: cài dạng plugin bằng claude plugin add agent-skills, hoặc clone repo rồi trỏ CLAUDE.md tới thư mục skill. Tại ngày phát hành, repo chưa có file khai báo plugin, nên tôi khuyên dùng cách clone cho chắc.
- Tải repo:
git clone https://github.com/addyosmani/agent-skills.git
- Chép các skill cần dùng vào thư mục skill của Claude Code (
~/.claude/skills/hoặc.claude/skills/trong dự án). Muốn dùng lệnh tắt/spec,/plan... thì chép thêm các file trong.claude/commands/của repo vào.claude/commands/của dự án. - Bắt đầu nhỏ theo gợi ý trong
docs/getting-started.md: chỉ nạp ba skillspec-driven-development,test-driven-development,code-review-and-quality. Tài liệu cho rằng ba skill này lấp được những lỗ hổng chất lượng lớn nhất khi lập trình có AI hỗ trợ.
Bộ khởi đầu ba skill, dùng được trên nhiều agent lập trình.
Với agent khác, README hướng dẫn: Cursor chép nội dung SKILL.md vào .cursor/rules/; Windsurf thêm vào cấu hình rules; GitHub Copilot dùng thư mục agents/ làm persona và đưa nội dung skill vào .github/copilot-instructions.md; Codex và agent khác dùng như file hướng dẫn thường vì skill là Markdown thuần.
Mẹo
Skill
code-review-and-qualitycó một gợi ý đáng thử: viết bằng một model, rà bằng model khác. Giống bài thi được chấm chéo, người chấm không phải người làm nên dễ thấy lỗi hơn.
Thử ngay với hai việc thật
Việc 1: làm tính năng mới từ đầu. Gõ /spec trong Claude Code, kèm mô tả:
/spec Trang đăng ký tham quan văn phòng cho khách thuê: chọn tòa nhà, chọn giờ, nhận email xác nhận.
Theo file lệnh, agent sẽ hỏi về mục tiêu và người dùng, tính năng cốt lõi và tiêu chí nghiệm thu, công nghệ, và ranh giới: việc gì luôn làm, việc gì phải hỏi trước, việc gì không bao giờ làm. Kết quả lưu thành SPEC.md ở gốc dự án và chờ anh chị xác nhận trước khi sang /plan.
Việc 2: rà soát trước khi gộp code. Gõ /review, agent rà theo năm trục: đúng, dễ đọc, kiến trúc, bảo mật, hiệu năng.
Lưu ý
- Tài liệu còn sót tên cũ. Một số file phụ như
docs/getting-started.mdvà các file lệnh vẫn gọi dự án làswe-skills, có lệnh clone trỏ tới repo tên cũ. Làm theo README chính là an toàn nhất.- Thiên về web. README nói rõ bộ skill nhắm tới dự án TypeScript, JavaScript, ưu tiên web và triển khai liên tục. Dự án nhúng hay phân tích dữ liệu phải chọn lọc.
- Hook chạy lệnh trên máy. Repo có hook chạy lúc mở phiên bằng
bash. Đọc nội dung hook trước khi bật; trên Windows cần có bash.- Nạp hết 17 skill một lúc làm agent chậm và tốn token.
Nhận xét của chuyên gia
Agent Skills là bộ tôi sẽ đưa cho đội kỹ thuật muốn chuẩn hóa cách làm việc với AI agent, vì nó nói đúng ngôn ngữ quản lý chất lượng: giai đoạn, cổng kiểm, tiêu chí xong. Nhiều doanh nghiệp có quy trình phát triển phần mềm trên giấy nhưng agent không hề biết; bộ skill này là cầu nối. Giấy phép MIT cũng giúp doanh nghiệp yên tâm sửa lại cho quy trình riêng.
Hợp với ai: đội phát triển web từ ba người trở lên; trưởng nhóm muốn agent tuân theo quy trình chung; công ty đang viết sổ tay lập trình có AI.
Chưa hợp với ai: người làm một mình cần nhanh; dự án không phải web; người không lập trình chỉ muốn agent làm hộ việc văn phòng.
Cách bắt đầu của tôi: nạp ba skill tối thiểu như tài liệu gợi ý, chạy hai tuần, đếm số lỗi phải sửa lại sau khi gộp code. Sau đó mới thêm security-and-hardening và nhóm phát hành. Skill nào trái với quy trình công ty thì sửa lại.
Agent giỏi không cần thêm tài năng, nó cần một bảng kiểm không cho phép viện cớ.
Bài này nằm trong chuỗi dòng thời gian AI 2025 tới 2026.
Câu hỏi thường gặp
Agent Skills của Addy Osmani có miễn phí không?
Có. Repo dùng giấy phép MIT, tải và sửa tự do. Chi phí duy nhất là token của agent khi chạy skill.
Agent Skills dùng với Cursor hay Copilot được không?
Được. README có hướng dẫn riêng cho Cursor, Windsurf, GitHub Copilot, và cách dùng chung cho Codex hay agent khác vì skill là Markdown thuần.
Có cần cài hết 17 skill không?
Không. Tài liệu khởi đầu khuyên chỉ nạp ba skill: viết spec, TDD, rà soát code. Thêm dần khi đội đã quen.
Agent Skills khác Spec Kit thế nào?
Spec Kit tập trung vào viết spec và lên kế hoạch trước khi code. Agent Skills phủ cả sáu giai đoạn, thêm kiểm thử trên trình duyệt, rà bảo mật, hiệu năng và phát hành.
Nguồn tham khảo: https://github.com/addyosmani/agent-skills
