Biến AI coding agent thành senior engineer với Agent Skills của Addy Osmani

Tóm tắt nhanh (Key Takeaways)

• Agent Skills của Addy Osmani là bộ 23 “quy trình engineering” đóng gói thành SKILL.md giúp AI coding agent làm việc như một senior engineer thay vì sinh code “cho xong”.
• Chỉ với vài lệnh cài đặt, bạn có thể tích hợp Agent Skills vào Claude Code, Cursor, Gemini CLI, Copilot… và dùng các slash command như /spec, /plan, /build, /test, /review, /ship để điều khiển toàn bộ vòng đời phát triển ngay trong IDE.
• Mỗi skill là một workflow có bước thực hiện, cổng kiểm chứng (verification gate), bảng “chống ngụy biện” và checklist tham chiếu, giúp AI agent luôn viết spec trước code, test trước merge, đo lường trước tối ưu, bảo đảm chất lượng sản phẩm ở mức production.

Agent Skills của Addy Osmani là một bộ sưu tập kỹ năng engineering được đóng gói cho AI coding agent, tập trung vào việc mã hóa quy trình, quality gate và best practice mà senior engineer dùng trong môi trường production.

Thay vì chỉ là một file hướng dẫn dài dòng, mỗi skill là một workflow có bước rõ ràng, điều kiện dừng và yêu cầu bằng chứng (tests, log, build output) trước khi coi một task là “xong”.

Bộ kỹ năng này được triển khai dưới dạng các thư mục skills/*, mỗi thư mục chứa một file SKILL.md mô tả frontmatter (name, description, khi nào dùng) và phần nội dung chi tiết gồm Overview, When to use, Process, Rationalizations, Red flags và Verification.
Nhờ vậy, bất kỳ AI agent nào chấp nhận system prompt hoặc rules file dạng Markdown (Claude Code, Cursor, Gemini CLI, Windsurf, Copilot, Codex…) đều có thể tải skill vào context và làm theo đúng quy trình.

Vòng đời phát triển phần mềm mà Agent Skills bao phủ

Agent Skills được thiết kế để bao phủ trọn vẹn vòng đời phát triển phần mềm: Define → Plan → Build → Verify → Review → Ship.
Mỗi giai đoạn có các skill tương ứng, cùng với các slash command để kích hoạt nhanh như /spec, /plan, /build, /test, /review, /code-simplify, /ship.

Một số nhóm chính trong repo:

• Define: interview-me, idea-refine, spec-driven-development dùng để kéo yêu cầu thật, tinh chỉnh ý tưởng và viết PRD trước khi đụng vào code.
• Plan: planning-and-task-breakdown giúp agent tách spec thành các task nhỏ, có acceptance criteria, dễ verify.
• Build: incremental-implementation, test-driven-development, context-engineering, source-driven-development, frontend-ui-engineering, api-and-interface-design đảm bảo agent triển khai theo lát cắt mỏng, TDD và bám sát tài liệu chính thức.
• Verify: browser-testing-with-devtools, debugging-and-error-recovery tập trung vào tái hiện bug, logging, profiling, triage theo từng bước.
• Review: code-review-and-quality, code-simplification, security-and-hardening, performance-optimization mô phỏng code review của staff engineer, hardening bảo mật, tối ưu hiệu năng đo-lường-trước-tối-ưu.
• Ship: git-workflow-and-versioning, ci-cd-and-automation, deprecation-and-migration, documentation-and-adrs, shipping-and-launch giúp agent tuân thủ trunk-based development, feature flag, CI/CD và rollout an toàn.

Cấu trúc repo addyosmani/agent-skills

Repo chính nằm tại Agent Skills trên GitHub, được tổ chức rõ ràng theo kiểu “bộ kỹ năng + persona + reference”.

Cấu trúc thư mục chính:

• skills/: 23 skill (22 lifecycle + 1 meta using-agent-skills) cho từng bước Define, Plan, Build, Verify, Review, Ship.
• agents/: 3 persona sẵn có như code-reviewer (Senior Staff Engineer), test-engineer (QA), security-auditor (Security Engineer) dành cho các review chuyên sâu.
• references/: các checklist như testing-patterns.md, security-checklist.md, performance-checklist.md, accessibility-checklist.md được skill gọi vào khi cần.
• .claude/commands và .gemini/commands: khai báo slash command để Claude Code và Gemini CLI auto map /spec, /plan, /build,… vào đúng skill.
• docs/: hướng dẫn setup cho từng nền tảng (Cursor, Gemini CLI, Windsurf, Copilot, OpenCode…).

Nhờ cấu trúc chuẩn này, bạn có thể clone repo và tái sử dụng skill theo kiểu copy SKILL.md vào rules file, hoặc dùng những công cụ cài đặt tự động tương thích Agent Skills spec.

Cài đặt Agent Skills cho Claude Code

Nếu bạn đang dùng Claude Code, đây là cách nhanh nhất để cài toàn bộ Agent Skills từ marketplace.

Cài qua marketplace (khuyên dùng)

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

Sau khi cài, Claude Code sẽ nhận diện các slash command /spec, /plan, /build, /test, /review, /code-simplify, /ship tương ứng với các skill trong repo.

Nếu gặp lỗi SSH khi marketplace clone repo, bạn có thể yêu cầu marketplace dùng HTTPS:

/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills

Cách này hữu ích nếu bạn chưa cấu hình SSH key cho GitHub trên môi trường phát triển.

Cài local cho môi trường phát triển

Nếu muốn tự kiểm soát và tùy biến, bạn có thể clone repo và trỏ Claude Code tới thư mục plugin:

git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills

Cách làm này phù hợp nếu bạn muốn forking, chỉnh sửa skill cho quy trình nội bộ team, hoặc dùng chung trong môi trường self-hosted devcontainer/Docker.

Cài đặt Agent Skills cho Gemini CLI và các agent khác

Agent Skills hoạt động tốt với Gemini CLI thông qua native skills và file GEMINI.md.

Cài trực tiếp từ repo

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

Lệnh này tải toàn bộ thư mục skills/ và đăng ký chúng như native skills để Gemini CLI có thể auto-discover khi bạn ra lệnh.

Cài từ bản clone local

git clone https://github.com/addyosmani/agent-skills.git
gemini skills install ./agent-skills/skills/

Cách này cho phép bạn giữ một bản copy trên máy, tiện cho việc sync với repo nội bộ, CI hoặc các môi trường dev/staging khác.

Với các agent khác, bạn thường chỉ cần:

• Copy nội dung SKILL.md vào file rules riêng của agent (ví dụ .cursorrules, .github/copilot-instructions.md, AGENTS.md cho OpenCode).
• Hoặc trỏ agent tới thư mục skills/ để nó tự scan theo chuẩn SKILL.md của Agent Skills.

Sử dụng Agent Skills trong Cursor, Copilot và IDE khác

Với Cursor, bạn có thể copy bất kỳ SKILL.md vào thư mục .cursor/rules/ hoặc tham chiếu toàn bộ thư mục skills/ trong cấu hình project.
Khi đó, khi bạn yêu cầu agent thực hiện nhiệm vụ phù hợp (ví dụ thiết kế API, tối ưu hiệu năng, review bảo mật), Cursor sẽ nạp skill tương ứng và làm theo quy trình trong SKILL.md thay vì tự “ứng biến”.

Với GitHub Copilot, repo cung cấp định nghĩa agent trong thư mục agents/ và bạn có thể đưa nội dung skill vào .github/copilot-instructions.md để Copilot hiểu cách review, test, document theo style của Agent Skills.
Các IDE/agent khác (Windsurf, Kiro, Codex…) chỉ cần hỗ trợ system prompt hoặc file rules Markdown là có thể sử dụng trọn bộ workflow này.

Slash command và cách “lái” workflow với Agent Skills

Khi đã cài Agent Skills, bạn có thể điều khiển AI coding agent qua các slash command tương ứng từng giai đoạn vòng đời phát triển.

Một ví dụ flow điển hình:

1. /spec: yêu cầu agent viết PRD cho feature (mục tiêu, ràng buộc, luồng chính, edge case, non-functional requirement) trước khi đụng đến code.
2. /plan: từ spec, agent tách thành các task nhỏ, mỗi task có acceptance criteria rõ ràng.
3. /build: agent triển khai incremental theo lát cắt mỏng, có test đi kèm mỗi thay đổi, không đụng quá nhiều phần không liên quan.
4. /test: chạy test, debug nếu fail, đảm bảo mọi thứ pass trước khi nghĩ đến merge.
5. /review: dùng persona code-reviewer để soi chất lượng, readability, maintainability, security, performance.
6. /ship: kiểm tra checklist pre-launch, git workflow, CI/CD, rollback, monitoring trước khi ship lên production.

Một số môi trường còn hỗ trợ /build auto – cho phép agent tự sinh plan và triển khai toàn bộ task trong một pass, vẫn giữ TDD, commit từng bước và dừng khi phát hiện rủi ro.

Cách dùng meta-skill using-agent-skills để tránh “overload”

Repo có một meta-skill tên using-agent-skills đóng vai trò router: nó giúp agent quyết định khi nào nên dùng skill nào dựa trên loại yêu cầu bạn đưa ra.
Thay vì tự tay ném cả chục SKILL.md vào context, bạn chỉ cần bật meta-skill này và để agent tự map công việc vào workflow phù hợp.

Trong thực tế, nhiều hướng dẫn khuyên bạn nên bắt đầu chỉ với using-agent-skills và một vài skill cốt lõi như spec-driven-development, planning-and-task-breakdown, test-driven-development, code-review-and-quality rồi mới mở rộng thêm.
Cách này giúp giảm context overhead, tránh việc agent bị “choáng” bởi quá nhiều quy tắc cùng lúc, đồng thời vẫn nâng chất lượng output ở những điểm quan trọng nhất.

Best practice khi tích hợp Agent Skills vào stack hiện tại

Với góc nhìn của một dev vận hành nhiều site, pipeline CI/CD và hạ tầng self-hosted, bạn có thể khai thác Agent Skills theo một số hướng sau:

• Chỉ định rõ environment: trong spec, yêu cầu agent ghi rõ framework, runtime, chuẩn code style, linting, testing framework để workflow spec-driven-development và test-driven-development bám sát stack thực tế của bạn.
• Kết hợp với DevTools: khi tối ưu front-end cho Core Web Vitals, dùng browser-testing-with-devtools và performance-optimization để agent tự thu thập số liệu từ Chrome DevTools MCP, thay vì phỏng đoán.
• Chuẩn hóa quy trình review: dùng persona code-reviewer và skill code-review-and-quality để tạo cảm giác “lúc nào cũng có staff engineer review trước khi merge”, đặc biệt phù hợp với team nhỏ hoặc solo dev.
• Tuỳ biến skill cho dự án: fork repo, chỉnh sửa một số SKILL.md (ví dụ bổ sung bước về log chuẩn, chuẩn hóa monitoring, rule liên quan đến domain của bạn) rồi dùng bản fork đó trong nội bộ.

Khi đã quen, bạn có thể gắn các lệnh /spec, /plan, /build, /test, /review, /ship vào các macro, snippet trong IDE hoặc tích hợp vào workflow n8n, Dockerized dev environment để quy trình phát triển trở nên nhất quán hơn. Những tích hợp kiểu này mang tính kỹ thuật tổ chức hơn là phụ thuộc cụ thể vào repo, nên Agent Skills phù hợp với cả môi trường cloud lẫn self-hosted.

Tài nguyên thêm để đào sâu Agent Skills

Ngoài README chính, Addy Osmani còn có một bài viết riêng phân tích triết lý đằng sau Agent Skills, cách nó “ép” AI agent tuân thủ kỷ luật engineering thay vì đuổi theo đường tắt.

Bạn có thể tham khảo thêm bài viết đó tại bài viết giới thiệu Agent Skills của Addy Osmani để hiểu sâu hơn về cách ông chuyển hoá văn hóa engineering của Google thành các workflow dành cho AI agent.

Nếu muốn xem Agent Skills trong ngữ cảnh broader ecosystem (Agent Skills spec, registry, CLI installer,…), bạn có thể đọc thêm tài liệu tổng quan về Agent Skills format tại trang chủ Agent Skills spec.

Điều này rất hữu ích nếu bạn có ý định tự xây dựng bộ skill nội bộ cho team, hoặc muốn chuẩn hóa cách AI agent tương tác với hạ tầng, API, quy trình release của riêng mình.

Bằng việc kết hợp Agent Skills với stack phát triển hiện có, bạn đang biến AI coding agent từ một “trợ lý sinh code nhanh” thành một “senior engineer biết quy trình”, giúp giảm bug production, tăng độ tin cậy của mỗi lần ship và mở đường cho việc tự động hóa nhiều hơn trong tương lai gần.