mattpocock/skills: bộ skill cho coding agent làm việc bài bản — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về mattpocock/skills — 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: mattpocock/skills: Kỷ luật cho AI agent — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
mattpocock/skills là bộ skill (chỉ dẫn đóng gói sẵn) cho các coding agent như Claude Code, Codex, GitHub Copilot, Gemini CLI. Nó giúp agent hỏi kỹ trước khi code, viết test trước, chẩn đoán lỗi và rà soát code có kỷ luật. Cài chỉ một lệnh, README gọi là thiết lập 30 giây.
mattpocock/skills là một bộ skill cho coding agent. Skill ở đây là những chỉ một trang tin tức sẵn mà agent như Claude Code hay Codex đọc và làm theo mỗi khi bạn gọi bằng một lệnh dạng /tên-skill. Tác giả (Matt Pocock) lấy thẳng từ thư mục .agents mà họ dùng hằng ngày để làm phần mềm thật, không phải kiểu «vibe coding» gõ bừa rồi hy vọng.
Vấn đề repo giải quyết rất quen: bạn nhờ AI làm một việc, nó làm xong, và bạn nhận ra nó hiểu sai ý. Hoặc nó nói dài dòng, viết code chạy không nổi, hoặc code càng lúc càng rối. Các skill ở đây nhắm đúng bốn chuyện đó: làm rõ yêu cầu bằng cách để agent hỏi bạn, dùng chung một bộ thuật ngữ, viết test trước khi viết code, và chăm chút thiết kế mã nguồn.
Người nên dùng là lập trình viên (kể cả mới) đang làm việc với coding agent. Một vài skill như /grill-me dùng được cả cho việc không phải code, nên nhân viên văn phòng muốn có người «vặn vẹo» kế hoạch của mình cũng dùng được. Repo hiện có khoảng 323 nghìn sao và khoảng 27 nghìn 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à các skill nhỏ, tách rời, dễ sửa. Tác giả nói rõ mục tiêu là để bạn tự chỉnh thành của riêng mình, chứ không phải một quy trình đóng kín bắt bạn đi theo.
mattpocock/skills
Bộ skill nhỏ, dễ sửa cho Claude Code, Codex, Copilot, Gemini CLI: phỏng vấn làm rõ yêu cầu, viết test trước, soi kiến trúc, rà code.
I.Bộ skill này làm được gì
README chia skill theo một trục: ai được gọi chúng. Skill «user-invoked» chỉ chạy khi chính bạn gõ lệnh, vai trò là điều phối. Skill «model-invoked» thì bạn gọi được, mà agent cũng tự lấy ra dùng khi thấy việc phù hợp. Dưới đây là những nhóm đáng chú ý nhất.
A.Làm rõ yêu cầu trước khi code
/grill-me cho agent phỏng vấn bạn liên tục về một kế hoạch hay thiết kế, cho đến khi mọi nhánh quyết định đều rõ. Tác giả nói đây là skill nổi tiếng nhất và khuyên dùng mỗi lần muốn thay đổi gì đó. Lợi ích thực tế: bạn phát hiện chỗ mình chưa nghĩ kỹ ngay từ đầu, thay vì phát hiện sau khi code xong.
/grill-with-docs giống /grill-me nhưng thêm một việc: nó xây dần «ngôn ngữ chung» của dự án, cập nhật file GLOSSARY.md và ghi các quyết định khó giải thích vào ADR (tài liệu quyết định kiến trúc). Ví dụ trong README: thay vì dài dòng «lesson trong một section của course được làm thành thật, tức có chỗ trong hệ thống file», agent chỉ cần nói «materialization cascade». Ngắn hơn thì đỡ tốn token, đặt tên biến và file cũng nhất quán hơn.
B.Viết code có phản hồi
/tdd ép agent đi theo vòng red-green-refactor: viết test thất bại trước, rồi mới sửa cho qua, mỗi lần một lát cắt dọc nhỏ. /diagnosing-bugs là quy trình chẩn đoán lỗi khó theo từng giai đoạn: dựng vòng phản hồi làm lỗi tái hiện được, thu nhỏ, đặt giả thuyết, đo đạc, sửa, rồi viết test chống tái phát.
C.Giữ thiết kế gọn gàng
/improve-codebase-architecture quét mã nguồn tìm chỗ có thể «làm sâu» module, trình bày thành báo cáo HTML rồi cùng bạn đi sâu vào ứng viên bạn chọn. Tác giả khuyên chạy vài ngày một lần, và nói thẳng nó là bản khảo sát chứ không phải cứu hộ: với codebase rất cũ nó sẽ chỉ ra ứng viên thật, nhưng không tự gỡ rối giúp bạn.
D.Lập kế hoạch và giao việc
/to-spec biến cuộc trò chuyện hiện tại thành bản spec rồi đăng lên nơi quản lý issue. /to-tickets chia kế hoạch thành các ticket nhỏ, có khai báo ticket nào chặn ticket nào. /implement làm theo spec hoặc ticket, còn /implement-spec làm cả spec trên một nhánh tích hợp, chạy nhiều subagent song song. /wayfinder dành cho khối việc quá lớn so với một phiên làm việc. /code-review rà diff theo hai trục: chuẩn code và mức độ bám đúng spec.
E.Công cụ năng suất chung
/handoff nén cuộc trò chuyện thành tài liệu bàn giao để agent khác làm tiếp. /teach dạy bạn một kỹ năng qua nhiều buổi. /to-questionnaire biến một quyết định bạn không tự trả lời được thành bảng câu hỏi gửi đúng người. /wait-what dùng khi một tin nhắn của agent bạn đọc không hiểu: nó giải thích lại bằng tiếng thường. Ngoài ra còn /ask-matt (gợi ý nên dùng skill nào), /triage, /retro, /prototype, /research, /pr, /wizard và vài skill khác.
II.Cần chuẩn bị gì
README không ghi yêu cầu hệ điều hành hay phiên bản Node/Python cụ thể. Những gì tư liệu cho biết:
- Một coding agent đã cài sẵn. README có hướng dẫn riêng cho Claude Code, Codex, GitHub Copilot (CLI và VS Code), Gemini CLI, và các agent khác như Cursor, OpenCode, Devin, Windsurf, Amp, Pi.
- Đường cài «agent khác» dùng lệnh
npx, nên máy cần có công cụ này. Repo cópackage.jsonvà tên gói npm làmattpocock-skills. README không nói phiên bản Node tối thiểu, nên nếunpxbáo không có, bạn cần cài Node.js trước. - Một repo dự án để chạy lệnh thiết lập (ở bước 2 bên dưới).
- README không nói cần API key riêng, cần GPU, hay hạn chế hệ điều hành nào. Chi phí chủ yếu là phần bạn đã trả cho agent đang dùng.
Pick one per agent: README cảnh báo chỉ chọn MỘT cách cài cho mỗi agent (plugin hoặc skills.sh). Cài cả hai thì mỗi skill xuất hiện hai lần.
III.Cài đặt từng bước
- Chọn agentXác định bạn đang dùng Claude Code, Codex, Copilot, Gemini CLI hay agent khác
- Cài skillChạy đúng lệnh cài tương ứng với agent đó
- Chạy setupGõ /setup-matt-pocock-skills một lần trong mỗi repo
- Thử một skillGọi /grill-me hoặc /grill-with-docs để kiểm tra
A.Cài cho Claude Code
Mở terminal (trên Windows có thể dùng PowerShell hoặc terminal trong VS Code), rồi chạy lệnh dưới. README cho biết bản plugin này tự cập nhật.
claude plugin install mattpocock-skills@claude-plugins-officialB.Cài cho Codex
Hai lệnh: thêm marketplace của tác giả, rồi cài plugin. README cho biết Codex tự cập nhật khi khởi động.
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocockC.Cài cho GitHub Copilot
Copilot cần hai lệnh giống Codex.
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocockSau đó, làm đúng một lần: thêm đoạn sau vào file ~/.copilot/settings.json. Nếu file đã có nội dung, hãy nhập thêm khóa này vào chứ đừng xóa phần cũ, vì dán đè sẽ làm mất cấu hình của bạn.
{
"extraKnownMarketplaces": {
"mattpocock": { "source": { "source": "github", "repo": "mattpocock/skills" }, "autoUpdate": true }
}
}Nếu bạn dùng VS Code, README hướng dẫn chạy lệnh Chat: Install Plugin From Source rồi nhập https://github.com/mattpocock/skills. Bản này cập nhật hằng ngày.
D.Cài cho Gemini CLI
Gemini CLI cập nhật thủ công, và có hai lệnh vì skill chia thành hai thư mục.
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivityMuốn cập nhật thì chạy lại cả hai lệnh.
E.Cài cho agent khác, hoặc muốn có file sửa được
Cách này copy các file skill vào dự án của bạn để bạn tự chỉnh. Đổi lại, bạn phải tự cập nhật.
npx skills@latest add mattpocock/skills -a
# cursor, opencode, devin, windsurf, amp, pi; omit -a to choosePhần chú thích trong README nghĩa là: các agent hỗ trợ gồm cursor, opencode, devin, windsurf, amp, pi; bỏ -a đi thì trình cài sẽ cho bạn tự chọn. Khi trình cài hỏi muốn lấy skill nào, nhớ chọn setup-matt-pocock-skills, vì bước sau cần nó. Cập nhật bằng npx skills@latest update, và chạy lại add để nhận skill mới.
F.Chạy thiết lập một lần cho mỗi repo
Mở agent bên trong thư mục dự án của bạn (đây là chỗ người mới hay vấp: phải mở đúng thư mục dự án), rồi gõ:
/setup-matt-pocock-skillsSkill này sẽ hỏi bạn: dùng nơi quản lý issue nào (GitHub, GitLab, file cục bộ hay thứ khác bạn mô tả), bạn dán nhãn gì cho ticket khi phân loại (/triage dùng các nhãn này), và muốn lưu tài liệu được tạo ra ở đâu. Trả lời xong là xong. README gọi bước cuối là «Bam - you're ready to go».
IV.Kiểm tra đã chạy được chưa
README không đưa ra một kết quả mẫu cụ thể, nên cách kiểm tra thực tế là:
- Trong agent, gõ dấu
/và xem danh sách lệnh có các skill nhưgrill-me,tdd,setup-matt-pocock-skillskhông. Cách hiển thị tùy từng agent. - Nếu thấy mỗi skill hiện hai lần, nhiều khả năng bạn đã cài cả plugin lẫn skills.sh. README cảnh báo đúng chuyện này, hãy giữ một cách thôi.
- Chạy thử
/grill-mevới một ý tưởng nhỏ. Nếu agent bắt đầu hỏi bạn từng câu một về kế hoạch, skill đã hoạt động. - Nếu chưa chắc nên dùng skill nào, thử
/ask-matt: theo README, nó là bộ định tuyến chỉ ra skill hợp với tình huống của bạn.
V.Dùng vào việc thật
Các tình huống dưới đây bám theo mô tả skill trong README. Kết quả cụ thể sẽ tùy agent và dự án của bạn.
A.Chủ shop muốn chốt kế hoạch trước khi nhờ người làm
Bạn bán hàng online, định làm chương trình khách hàng thân thiết nhưng chưa rõ mình cần gì. Mở agent và gõ /grill-me, rồi nói ý tưởng: «Mình muốn làm chương trình tích điểm cho khách quen». Agent sẽ hỏi lần lượt: tích điểm theo gì, điểm hết hạn không, đổi quà thế nào. Bạn trả lời đến khi các nhánh đều rõ. Kết quả là một kế hoạch đã được vặn kỹ, bạn mang thẳng cho đội kỹ thuật hoặc freelancer mà ít bị hiểu sai.
Không ai biết chính xác mình muốn gì, cho đến khi bị hỏi đủ kỹ.
Ông T
B.Lập trình viên làm tính năng mới trong dự án có sẵn
Bạn cần thêm tính năng vào một dự án đang chạy. Dùng /grill-with-docs để agent phỏng vấn bạn và ghi thuật ngữ vào GLOSSARY.md. Tiếp theo /to-spec biến cuộc trao đổi thành spec đăng lên issue tracker bạn đã chọn khi setup, rồi /to-tickets tách thành ticket nhỏ. Cuối cùng /implement làm theo, dùng /tdd để viết test trước và kết thúc bằng /code-review. Kết quả: thay vì một cục code khó đọc, bạn có spec, ticket, test và bản rà soát đi kèm.
C.Gặp lỗi khó mà không biết bắt đầu từ đâu
Ứng dụng thỉnh thoảng chạy chậm hoặc lỗi chập chờn. Mô tả hiện tượng cho agent và yêu cầu dùng /diagnosing-bugs. Theo README, skill dựng vòng phản hồi cho ra lỗi một cách ổn định, thu nhỏ trường hợp, đặt giả thuyết, đo, sửa, rồi thêm test hồi quy. Bạn nhận được nguyên nhân có bằng chứng và một test giữ cho lỗi đó không quay lại, thay vì mấy lần sửa mò.
D.Đọc không hiểu agent đang nói gì
Agent trả lời toàn thuật ngữ và bạn không theo kịp. Gõ /wait-what ngay lúc đó. Theo README, agent sẽ kể lại ý đó kèm phần bối cảnh bạn đang thiếu, bằng tiếng thường, dùng từ vựng trong GLOSSARY.md của bạn. Dùng được cho người không chuyên kỹ thuật cùng làm việc trong dự án.
VI.Lỗi hay gặp và cách xử lý
A.Gõ lệnh /tên-skill mà agent không nhận
Nguyên nhân thường là cài chưa xong hoặc agent chưa nạp lại plugin. Hãy kiểm tra lại lệnh cài đúng với agent của bạn và khởi động lại phiên làm việc. Với cách npx skills, kiểm tra xem lúc trình cài hỏi bạn có chọn đúng skill cần dùng không.
B.Skill hiện hai lần
Bạn đã cài cả plugin lẫn skills.sh. README khuyên chỉ chọn một cho mỗi agent. Hãy gỡ một trong hai cách theo công cụ của agent đó và giữ lại cách bạn muốn.
C.Các skill kỹ thuật báo thiếu cấu hình issue tracker hoặc nhãn
Bạn chưa chạy /setup-matt-pocock-skills trong repo hiện tại. README yêu cầu chạy một lần cho mỗi repo trước khi dùng các skill engineering. Mở agent đúng thư mục dự án rồi chạy lại.
D.Lệnh npx không chạy được
Nếu máy báo không tìm thấy npx, nhiều khả năng bạn chưa cài Node.js. README không nêu phiên bản yêu cầu, nên cài bản Node.js ổn định hiện hành và mở terminal mới rồi thử lại. Nếu vẫn lỗi, xem package.json và README.md trong repo.
E.Sửa settings.json của Copilot làm hỏng cấu hình
Nếu ~/.copilot/settings.json đã có nội dung, dán đè cả khối sẽ làm mất thiết lập cũ, hoặc làm file sai cú pháp JSON. Hãy sao lưu file trước, chỉ thêm khóa extraKnownMarketplaces vào, và kiểm tra dấu phẩy, dấu ngoặc.
VII.Có nên dùng không
Điểm mạnh: các skill nhỏ, tách rời, dễ đọc và dễ sửa. README nói chúng chạy được với mọi mô hình. Cài đặt gọn, có đường cài riêng cho từng agent phổ biến. Bộ skill nhấn vào nền tảng kỹ thuật (hỏi rõ yêu cầu, test trước, thiết kế gọn) thay vì ép bạn theo một quy trình đóng. Giấy phép MIT nên bạn thoải mái chỉnh sửa.
Giới hạn: README không có số liệu chứng minh hiệu quả, nên bạn nên thử trên một việc nhỏ trước. Nhiều skill (/to-spec, /to-tickets, /triage, /implement-spec) giả định bạn có quy trình làm việc với issue tracker, nên người làm một mình, việc nhỏ có thể thấy hơi nặng. /improve-codebase-architecture là bản khảo sát, không tự sửa mã cũ rối. Ngoài ra, bộ skill thiên về kỹ thuật phần mềm, người không code chỉ dùng được một số skill chung như /grill-me, /handoff, /wait-what.
Nếu bạn muốn một hệ thống tự lo cả quy trình thay mình, repo này không phải loại đó, vì tác giả chủ ý để bạn giữ quyền kiểm soát. Nếu bạn muốn agent hỏi kỹ hơn, viết test trước và giữ code gọn mà vẫn tự chỉnh được, thì đây là một lựa chọn đáng thử. Tìm hiểu thêm ở trang chủ dự án, aihero.dev/skills, và các tệp README.md, CONTRIBUTING.md, SCOPE.md trong repo.
Câu hỏi thường gặp
mattpocock/skills có miễn phí không?
Repo dùng giấy phép MIT nên bạn tự do dùng và sửa. README không nhắc đến phí cho bộ skill. Chi phí thực tế phụ thuộc vào agent bạn đang dùng, tư liệu chưa có thông tin chi tiết về phần này.
Bộ skill này dùng được với agent nào?
README có hướng dẫn cho Claude Code, Codex, GitHub Copilot (CLI và VS Code) và Gemini CLI. Với các agent khác như cursor, opencode, devin, windsurf, amp, pi, bạn cài bằng lệnh npx skills. Tác giả cũng nói các skill chạy được với mọi mô hình.
Cần GPU hoặc cấu hình máy mạnh không?
Tư liệu không nói cần GPU hay cấu hình đặc biệt. Skill chỉ là chỉ dẫn mà agent đọc, phần xử lý nặng nằm ở agent và mô hình bạn dùng.
Chạy trên Windows được không?
README không ghi yêu cầu hệ điều hành cụ thể. Các lệnh cài đều là lệnh dòng lệnh thông thường. Nếu dùng cách npx, bạn cần có Node.js, còn phiên bản tối thiểu thì README chưa nói.
Nên chọn cài bằng plugin hay bằng skills.sh?
Plugin tự cập nhật. skills.sh (lệnh npx skills) copy file sửa được vào dự án và bạn cập nhật thủ công. README khuyên chỉ chọn một cho mỗi agent, vì cài cả hai thì mỗi skill xuất hiện hai lần.
Dữ liệu của mình có an toàn không?
Tư liệu chưa có thông tin riêng về bảo mật dữ liệu. Skill là chỉ dẫn chạy trong agent của bạn, nên mức an toàn phụ thuộc vào chính agent và dịch vụ mô hình bạn dùng, cùng nơi bạn cho skill đăng issue hoặc lưu tài liệu.
Khác gì các khung như GSD, BMAD hay Spec-Kit?
Theo tác giả, các khung đó cố gắng làm chủ cả quy trình, nên bạn mất quyền kiểm soát và khó sửa khi có lỗi. Bộ skill này được thiết kế nhỏ, dễ chỉnh và ghép với nhau. Tư liệu không có so sánh chi tiết hơn.


