# mattpocock/skills: bộ skill giúp AI viết code đúng ý hơn — hướng dẫn cài đặt và dùng

> 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.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-18 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/mattpocock-skills-bo-skill-cho-ai-coding-agent

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.

```repo
- repo | mattpocock/skills
- kind | Skill
- desc | 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.
- stars | 323k
- lang | Shell
- license | MIT
```

## 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.

### 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.

### 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ó 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.

### 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.

### 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.

## 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.

```note
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.
```

## Cài đặt từng bước

```steps
- Chọn cách cài | Chọn đúng một cách cài theo agent bạn đang dùng
- Chạy lệnh cài | Dán lệnh tương ứng vào terminal
- Mở agent trong dự án | Vào thư mục dự án rồi mở agent
- Chạy thiết lập | Gõ /setup-matt-pocock-skills một lần cho mỗi repo
- Dùng thử | Gõ /grill-me hoặc /tdd để thử
```

### Cài cho Claude Code

Mở terminal (PowerShell trên Windows, Terminal trên Mac) rồi chạy:

```bash
claude plugin install mattpocock-skills@claude-plugins-official
```

Đây là dạng plugin nên tự cập nhật theo mặc định.

### 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.

```bash
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock
```

Codex tự cập nhật khi khởi động.

### Cài cho GitHub Copilot

Với Copilot CLI và VS Code, chạy:

```bash
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocock
```

Sau đó, 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 đè.

```json
{
  "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.

### Cài cho Gemini CLI

Gemini CLI cài thủ công, mỗi nhóm skill một lệnh:

```bash
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity
```

Muốn cập nhật thì chạy lại cả hai lệnh.

### 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.

```bash
npx skills@latest add mattpocock/skills -a
  # cursor, opencode, devin, windsurf, amp, pi; omit -a to choose
```

Dò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:

```bash
npx skills@latest update
```

### 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):

```text
/setup-matt-pocock-skills
```

Skill 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.

## 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-matt` rồ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.

## Dùng vào việc thật

### 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õ:

```text
/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

### 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`.

### 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.

### 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.

## Lỗi hay gặp và cách xử lý

### 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.

### 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 đó.

### 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.

### 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.

### 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.

## 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.
