mattpocock/skills: bộ skill giúp AI viết code đúng ý hơ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 (lệnh dạng /tên-skill) cho các coding agent như Claude Code, Codex, GitHub Copilot, Gemini CLI. Nó giúp AI hỏi kỹ bạn trước khi làm, viết test trước, chia việc thành ticket và rà thiết kế code. Cài chỉ mất vài lệnh, rồi chạy một lần /setup-matt-pocock-skills trong mỗi repo.
mattpocock/skills là một bộ "skill" cho các AI coding agent như Claude Code, Codex, GitHub Copilot hay Gemini CLI. Mỗi skill là một quy trình làm việc nhỏ mà bạn gọi bằng lệnh dạng /grill-me hay /tdd. Tác giả gọi đây là những skill rút từ thư mục .agents mà ông dùng hằng ngày, dành cho "real engineering" chứ không phải "vibe coding".
Nếu bạn từng nhờ AI làm một việc rồi nhận về thứ không giống điều mình nghĩ, bộ này dành cho bạn. Nó xử lý bốn lỗi quen thuộc: AI hiểu sai ý, AI nói dài dòng, code chạy không đúng, và codebase dần thành "cục bùn". Người dùng chính là lập trình viên, kể cả người mới. Riêng vài skill như /grill-me hay /handoff được tác giả xếp vào nhóm "không riêng cho code", nên người làm văn phòng cũng dùng được.
Điểm đáng giá nhất là triết lý: skill nhỏ, dễ sửa, ghép được với nhau, chạy với mọi mô hình. Tác giả so sánh với các bộ khung như GSD, BMAD hay Spec-Kit, vốn "sở hữu" cả quy trình và khiến bạn khó sửa khi có lỗi. Ở đây bạn giữ quyền kiểm soát. Repo hiện có khoảng 323.000 sao và khoảng 27.100 fork, giấy phép MIT.
mattpocock/skills
Bộ skill nhỏ, dễ chỉnh cho Claude Code, Codex, Copilot, Gemini CLI: phỏng vấn kỹ trước khi làm, viết test trước, rà soát thiết kế code.
I.Bộ skill này làm được gì
Các skill chia hai loại theo người gọi. User-invoked là skill chỉ chạy khi bạn tự gõ, ví dụ /grill-me; việc của chúng là điều phối. Model-invoked là skill bạn gọi được, nhưng AI cũng có thể tự lấy ra dùng khi thấy hợp; chúng chứa kỷ luật làm việc có thể dùng lại.
A.Hiểu đúng ý trước khi làm
/grill-me cho AI phỏng vấn bạn dồn dập về một kế hoạch hay thiết kế, đến khi mọi nhánh quyết định đều rõ. Tác giả nói đây là skill phổ biến nhất. /grill-with-docs làm điều tương tự nhưng còn xây "ngôn ngữ chung" của dự án: chỉnh lại thuật ngữ, cập nhật GLOSSARY.md và ghi các quyết định khó giải thích vào ADR. Lợi ích thực tế: AI bớt nói dài, đặt tên biến và file nhất quán hơn, tốn ít token hơn.
B.Lên kế hoạch và chia việc
/to-spec biến cuộc trò chuyện hiện tại thành bản spec và đăng lên nơi quản lý issue của bạn. /to-tickets chia kế hoạch thành các ticket nhỏ, mỗi ticket ghi rõ ticket nào chặn ticket nào. /wayfinder dành cho việc quá lớn, một phiên làm việc không chứa nổi. /implement và /implement-spec thì bắt tay xây phần việc đã được mô tả.
C.Có phản hồi khi viết code
/tdd ép AI làm theo vòng red-green-refactor, tức viết test hỏng trước, rồi sửa cho qua. /diagnosing-bugs là quy trình tìm lỗi khó theo từng giai đoạn: dựng vòng phản hồi, thu nhỏ, đặt giả thuyết, đo đạc, sửa, rồi viết test chống tái phát. /code-review rà phần thay đổi theo hai trục: tiêu chuẩn code và mức khớp với spec.
D.Giữ thiết kế code khỏe
/improve-codebase-architecture quét codebase tìm chỗ có thể "làm sâu" module, xuất thành báo cáo HTML, rồi cùng bạn đào sâu ứng viên bạn chọn. Tác giả nhắc rõ: đây là bản khảo sát, không phải thuốc cứu mạng. Với codebase rất cũ, nó tìm ra ứng viên thật nhưng không tự gỡ rối giúp bạn.
E.Tiện ích 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. /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 cho đúng người. /wait-what dùng khi AI nói bạn không hiểu: nó giải thích lại bằng tiếng thường. /teach dạy bạn một kỹ năng qua nhiều buổi. Ngoài ra có /ask-matt để hỏi nên dùng skill nào cho tình huống của bạn.
II.Cần chuẩn bị gì
README không ghi yêu cầu về hệ điều hành, phiên bản Node hay Python, cũng không nói cần API key hay phần cứng riêng. Phần này mình chỉ nêu những gì tư liệu có:
- Một coding agent đã cài sẵn, thuộc nhóm được hỗ trợ: Claude Code, Codex, GitHub Copilot (CLI hoặc VS Code), Gemini CLI, hoặc agent khác như Cursor, OpenCode, Devin, Windsurf, Amp, Pi.
- Với cách cài "agent khác", lệnh dùng
npx. Lệnh này đi kèm Node.js, nên bạn cần có Node.js trên máy. - Một dự án (repo) để chạy bước thiết lập. Bước này chạy một lần cho mỗi repo.
- Tùy bạn chọn nơi quản lý issue (GitHub, GitLab, file cục bộ hoặc thứ khác), bạn sẽ cần quyền tương ứng. README không nói chi tiết hơn.
README dặn: chọn MỘT cách cài cho mỗi agent. Cài cả plugin lẫn skills.sh thì bạn sẽ có mỗi skill hai lần.
III.Cài đặt từng bước
- Chọn cách càiChọn đúng một cách cài theo agent bạn đang dùng
- Chạy lệnh càiDán lệnh tương ứng vào terminal
- Mở agent trong dự ánVào thư mục dự án rồi mở agent
- Chạy thiết lậpGõ /setup-matt-pocock-skills một lần cho mỗi repo
- Dùng thửGõ /grill-me hoặc /tdd để thử
A.Cài cho Claude Code
Mở terminal (PowerShell trên Windows, Terminal trên Mac) rồi chạy:
claude plugin install mattpocock-skills@claude-plugins-officialĐây là dạng plugin nên tự cập nhật theo mặc định.
B.Cài cho Codex
Chạy hai lệnh theo thứ tự: lệnh đầu thêm "chợ" plugin, lệnh sau cài plugin.
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocockCodex tự cập nhật khi khởi động.
C.Cài cho GitHub Copilot
Với Copilot CLI và VS Code, chạy:
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocockSau đó, một lần duy nhất, thêm đoạn sau vào file ~/.copilot/settings.json. Nếu file đã có nội dung, hãy gộp vào cho đúng cú pháp JSON, đừng dán đè.
{
"extraKnownMarketplaces": {
"mattpocock": { "source": { "source": "github", "repo": "mattpocock/skills" }, "autoUpdate": true }
}
}Trong VS Code, bạn chạy lệnh Chat: Install Plugin From Source rồi nhập https://github.com/mattpocock/skills. README ghi là bản này cập nhật hằng ngày.
D.Cài cho Gemini CLI
Gemini CLI cài thủ công, mỗi nhóm skill một lệnh:
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 file sửa được
Cách này chép file skill vào dự án của bạn để bạn tự chỉnh. Đổi lại, bạn phải cập nhật bằng tay.
npx skills@latest add mattpocock/skills -a
# cursor, opencode, devin, windsurf, amp, pi; omit -a to chooseDòng thứ hai là ghi chú trong README: các agent được hỗ trợ gồm cursor, opencode, devin, windsurf, amp, pi; bỏ -a thì 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 lệnh dưới, và chạy lại add để lấy skill mới:
npx skills@latest updateF.Chạy thiết lập một lần cho mỗi repo
Mở terminal trong thư mục dự án, khởi động agent, rồi gõ lệnh sau ngay trong khung chat của agent (không phải trong terminal thường):
/setup-matt-pocock-skillsSkill sẽ hỏi bạn ba thứ: dùng nơi quản lý issue nào (GitHub, GitLab, file cục bộ hoặc cách bạn mô tả), bạn gắ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à bạn dùng được.
IV.Kiểm tra đã chạy được chưa
README không nêu màn hình hay kết quả cụ thể để xác nhận cài thành công. Cách kiểm tra hợp lý theo tư liệu:
- Mở agent trong dự án và gõ
/setup-matt-pocock-skills. Nếu skill hiện ra và bắt đầu hỏi bạn về issue tracker, nhãn và nơi lưu tài liệu, tức là đã cài được. - Gõ
/ask-mattrồi mô tả việc bạn định làm. Skill này là bộ định tuyến, sẽ gợi ý skill phù hợp. - Nếu thấy mỗi skill xuất hiện hai lần, bạn đã cài chồng hai cách. Hãy giữ một cách thôi.
V.Dùng vào việc thật
A.Chủ shop muốn chốt kế hoạch trước khi nhờ AI làm
Bạn bán hàng online và định đổi cách tính phí vận chuyển. Thay vì viết một yêu cầu dài rồi mong AI hiểu, bạn gõ:
/grill-me
Mình muốn đổi cách tính phí ship theo khu vực.AI sẽ hỏi lần lượt: khu vực nào, ngưỡng miễn phí là bao nhiêu, đơn trả hàng tính sao… cho đến khi mọi nhánh đã rõ. Kết quả là một kế hoạch bạn đã tự suy nghĩ kỹ, không còn chỗ mơ hồ. README xếp skill này vào nhóm dùng cho việc không phải code.
Cứ để AI hỏi mình đến khi hết chỗ mơ hồ, rồi hãy bảo nó làm.
Ông T
B.Lập trình viên muốn đi từ ý tưởng đến ticket
Bạn có ý tưởng tính năng mới trong một dự án có code. Chạy /grill-with-docs để AI phỏng vấn và ghi thuật ngữ vào GLOSSARY.md. Khi đã thống nhất, gõ /to-spec để biến cuộc trò chuyện thành spec đăng lên issue tracker, rồi /to-tickets để chia thành các ticket nhỏ có khai báo ticket nào chặn ticket nào. Kết quả là một bộ việc rõ thứ tự, sẵn sàng giao cho /implement hoặc /implement-spec.
C.Dev gặp lỗi khó tìm
Một trang chạy chậm hoặc lỗi thỉnh thoảng mới xảy ra. Bạn mô tả triệu chứng và gọi /diagnosing-bugs. Skill dẫn AI qua 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 thêm test chống tái phát. Cách này tốt hơn việc để AI đoán và sửa lung tung.
D.Nhân viên văn phòng cần bàn giao hoặc hỏi sếp
Bạn làm với AI cả buổi sáng và sắp hết ngữ cảnh. Gõ /handoff để nén cuộc trò chuyện thành tài liệu, mở phiên mới và đưa tài liệu cho agent tiếp tục. Còn khi cần một quyết định mà chỉ sếp trả lời được, dùng /to-questionnaire: nó hỏi bạn về người nhận và điều cần nhận lại, rồi tạo bảng câu hỏi Markdown để sếp điền sau hoặc cùng điền trong cuộc họp. Khi AI giải thích mà bạn không hiểu, gõ /wait-what để nó nói lại bằng tiếng thường.
VI.Lỗi hay gặp và cách xử lý
A.Mỗi skill xuất hiện hai lần
Nguyên nhân: bạn cài cả plugin lẫn skills.sh cho cùng một agent. README dặn chọn một cách cho mỗi agent. Hãy gỡ một trong hai cách theo hướng dẫn của agent bạn dùng, giữ lại cách còn lại.
B.Các skill kỹ thuật chạy không như mong đợi
Hay do chưa chạy /setup-matt-pocock-skills. README yêu cầu chạy một lần cho mỗi repo trước khi dùng các skill engineering. Nếu bạn mở một dự án mới, hãy chạy lại ở dự án đó.
C.Lệnh npx báo không tìm thấy
Thường là máy chưa có Node.js, hoặc terminal chưa nhận được lệnh sau khi vừa cài. Cài Node.js rồi mở lại terminal. README không nói phiên bản Node tối thiểu, nên nếu lỗi vẫn còn, hãy xem package.json trong repo.
D.Copilot không thấy plugin
Bạn có thể quên bước thêm khối extraKnownMarketplaces vào ~/.copilot/settings.json. Hãy mở file, thêm đúng đoạn JSON như trên, chú ý dấu phẩy khi gộp với nội dung cũ. Làm sai cú pháp JSON là lỗi rất dễ gặp.
E.Skill mới không xuất hiện sau khi tác giả cập nhật
Với cách cài thủ công (Gemini CLI hoặc npx skills), bạn phải tự cập nhật. Gemini thì chạy lại hai lệnh install; npx thì chạy npx skills@latest update, và chạy lại add để lấy skill mới.
VII.Có nên dùng không
Điểm mạnh. Skill nhỏ, dễ đọc và dễ sửa, nên bạn hiểu mình đang chạy gì. Chạy với nhiều agent và mô hình khác nhau, giấy phép MIT. Các ý tưởng như phỏng vấn kỹ trước khi làm, ngôn ngữ chung của dự án, test trước, rà thiết kế đều là nền tảng kỹ thuật lâu đời. Repo vẫn được cập nhật trong vài tháng gần đây.
Giới hạn. Đây là bộ công cụ cho người đã dùng coding agent, không phải ứng dụng bấm là chạy. Nhiều skill gắn với quy trình làm việc có issue tracker, spec, ticket; nếu bạn chỉ sửa một file nhỏ thì hơi nặng. README không nêu yêu cầu hệ điều hành hay chi phí, và /improve-codebase-architecture không tự gỡ rối codebase cũ.
Khi nên chọn cách khác. Nếu bạn muốn một quy trình trọn gói do công cụ làm chủ từ đầu đến cuối, các bộ khung như GSD, BMAD hay Spec-Kit đi theo hướng đó, dù tác giả cho rằng chúng lấy mất quyền kiểm soát của bạn. Nếu bạn mới bắt đầu, cứ thử /grill-me và /tdd trước, thấy hợp thì cài thêm.
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 được dùng và chỉnh sửa tự do. README không nói về chi phí khác. Lưu ý là bạn vẫn cần agent như Claude Code hay Codex, và các agent đó có thể có chi phí riêng mà tư liệu không đề cập.
Chạy được trên Windows không?
README không nêu hệ điều hành được hỗ trợ hay không. Các lệnh cài đều chạy trong terminal, và cách cài bằng `npx` cần Node.js. Nếu gặp lỗi trên Windows, bạn nên xem thêm `package.json` và các tài liệu trong repo.
Có cần GPU không?
Tư liệu không nhắc tới yêu cầu GPU hay phần cứng riêng. Skill chỉ là các quy trình để agent làm theo, nên nhu cầu tính toán phụ thuộc vào agent và mô hình bạn dùng.
Có dùng được với Cursor, Windsurf hay agent khác không?
Có. README liệt kê cursor, opencode, devin, windsurf, amp, pi qua lệnh `npx skills@latest add mattpocock/skills -a`. Gemini CLI, Codex, Claude Code và GitHub Copilot có cách cài riêng như trong bài.
Nên cài bằng plugin hay bằng skills.sh?
Plugin tự cập nhật, còn skills.sh chép file sửa được vào dự án và bạn cập nhật bằng tay. Chọn một cách cho mỗi agent, vì cài cả hai sẽ ra mỗi skill hai lần. Muốn chỉnh skill theo ý mình thì chọn cách chép file.
Khác gì các bộ khung như GSD, BMAD hay Spec-Kit?
Theo tác giả, những bộ khung đó sở hữu cả quy trình nên bạn mất quyền kiểm soát và khó sửa lỗi. Bộ skill này nhỏ, dễ chỉnh và ghép với nhau, bạn tự quyết dùng skill nào. Tư liệu không so sánh chi tiết hơn.
Dữ liệu của tôi có an toàn không?
README không có phần nói về dữ liệu hay quyền riêng tư. Skill chạy trong agent bạn chọn, và các skill như `/to-spec` có đăng nội dung lên issue tracker bạn đã cấu hình. Hãy chọn nơi đăng phù hợp và tự kiểm tra chính sách của agent bạn dùng.


