# mattpocock/skills: Kỷ luật cho AI coding — hướng dẫn cài đặt và dùng

> mattpocock/skills là bộ skill nhỏ, có thể kết hợp, giúp các coding agent làm việc theo quy trình kỹ thuật rõ ràng hơn. Repo hỗ trợ Claude Code, Codex, GitHub Copilot, Gemini CLI và nhiều agent khác; cách cài chủ yếu là chạy lệnh plugin hoặc installer có sẵn.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-11 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/mattpocock-skills-huong-dan-cai-dat

mattpocock/skills là bộ skill giúp coding agent làm việc theo các nguyên tắc kỹ thuật thực tế, thay vì chỉ sinh code thật nhanh. Bộ này tập trung vào việc hiểu đúng yêu cầu, giữ ngôn ngữ chung trong dự án, tạo vòng lặp kiểm thử, chẩn đoán lỗi và duy trì kiến trúc dễ thay đổi.

Repo phù hợp với dev mới dùng AI coding agent, nhóm phát triển sản phẩm, hoặc người đang thấy agent thường làm sai ý, viết quá dài, tạo code khó bảo trì hay sửa lỗi thiếu kỷ luật. Điểm đáng giá là các skill nhỏ và có thể kết hợp. Bạn có thể dùng từng skill theo nhu cầu, áp dụng cho nhiều model, rồi tự chỉnh lại cho hợp với quy trình của mình.

Repo hiện có khoảng 323475 sao và 27148 fork. Giấy phép là MIT. Tác giả mô tả đây là các skill dùng hằng ngày cho công việc kỹ thuật thực tế, không phải cách làm kiểu giao toàn bộ dự án cho AI rồi chờ kết quả.

```repo
- repo | mattpocock/skills
- kind | Skill
- desc | Bộ skill giúp AI coding hỏi đúng, lập kế hoạch, kiểm thử, gỡ lỗi và giữ kiến trúc code dễ bảo trì.
- stars | 323k
- lang | Shell
- license | MIT
```

## mattpocock/skills làm được gì

### Giúp agent hiểu đúng việc cần làm

Các skill như `/grill-me` và `/grill-with-docs` buộc agent hỏi sâu trước khi bắt đầu. Agent có thể làm rõ mục tiêu, phạm vi, người dùng, các trường hợp đặc biệt và những quyết định còn bỏ ngỏ.

Điều này hữu ích khi bạn chỉ mới có một ý tưởng như “thêm tính năng báo cáo” hoặc “sửa màn hình thanh toán”. Thay vì đoán, agent sẽ giúp biến ý tưởng mơ hồ thành yêu cầu rõ hơn. `/grill-with-docs` còn hỗ trợ xây dựng thuật ngữ chung, cập nhật `GLOSSARY.md` và ghi lại các quyết định trong ADR.

### Tạo ngôn ngữ chung cho dự án

Khi một dự án có nhiều thuật ngữ nội bộ, agent thường dùng từ không thống nhất. Nhóm skill liên quan đến tài liệu giúp dự án có một ngôn ngữ chung để người và agent cùng hiểu.

Lợi ích thực tế là tên biến, hàm và file có xu hướng nhất quán hơn. Agent cũng dễ điều hướng codebase hơn vì có tài liệu giải thích các khái niệm riêng của dự án. Khi khái niệm được cô đọng, các cuộc trao đổi sau cũng bớt dài và ít hiểu nhầm hơn.

### Hỗ trợ kiểm thử theo vòng lặp red-green-refactor

Skill `/tdd` hướng agent đến cách làm kiểm thử theo ba nhịp: viết test thất bại, sửa code để test chạy, rồi cải thiện thiết kế. Đây là cách tạo phản hồi sớm để agent biết code vừa viết có thực sự hoạt động hay không.

Cách này đặc biệt có ích khi bạn giao một thay đổi cho agent nhưng không muốn chỉ kiểm tra bằng mắt. Test trở thành bằng chứng cụ thể hơn cho từng phần việc.

### Chẩn đoán lỗi có kỷ luật

Skill `/diagnosing-bugs` hỗ trợ quy trình gỡ lỗi theo từng pha. Mục tiêu là đi từ lỗi đang xảy ra, thu nhỏ vấn đề, đưa ra giả thuyết, thêm quan sát cần thiết, sửa lỗi và tạo regression test.

Bạn có thể dùng cách này khi lỗi khó tái hiện, lỗi hiệu năng hoặc lỗi nằm ở nhiều lớp của ứng dụng. Thay vì để agent thử ngẫu nhiên nhiều bản sửa, quy trình này giúp từng giả thuyết được kiểm tra có chủ đích.

### Giữ kiến trúc code dễ thay đổi

`/to-spec` hỏi về các module liên quan trước khi tạo đặc tả. `/improve-codebase-architecture` khảo sát codebase để tìm các cơ hội làm module sâu hơn và đưa ra các ứng viên cần cải thiện.

Repo cũng có các skill như `/codebase-design`, `/implement`, `/implement-spec` và `/code-review`. Chúng hỗ trợ thiết kế module, triển khai theo đặc tả hoặc ticket, rồi review cả tiêu chuẩn code lẫn mức độ bám sát yêu cầu.

### Quản lý công việc kỹ thuật

Các skill `/triage`, `/to-tickets`, `/wayfinder` và `/retro` giúp tổ chức công việc theo quy mô khác nhau. Bạn có thể phân loại issue, tách cuộc trao đổi thành ticket, lập bản đồ cho việc lớn hoặc nhìn lại môi trường làm việc sau một phiên.

Nếu nhóm đang có nhiều việc dang dở, các skill này giúp biến một cuộc trò chuyện dài thành các bước có thứ tự và quan hệ phụ thuộc rõ hơn.

### Dùng cho cả công việc ngoài lập trình

Repo không chỉ có skill engineering. Nhóm productivity gồm `/grill-me`, `/handoff`, `/teach`, `/to-questionnaire` và `/wait-what`.

Ví dụ, `/handoff` có thể giúp tạo tài liệu bàn giao cho agent khác. `/to-questionnaire` biến một quyết định chưa thể tự trả lời thành bảng câu hỏi để gửi cho đúng người. Vì vậy, một số skill có thể hữu ích với người làm sản phẩm, vận hành hoặc văn phòng có dùng agent, dù phần trọng tâm của repo vẫn là kỹ thuật phần mềm.

## Cần chuẩn bị gì

Bạn cần một coding agent nằm trong danh sách được README hỗ trợ: Claude Code, Codex, GitHub Copilot, Gemini CLI hoặc một agent khác tương thích với installer `skills`.

Bạn cần có quyền chạy lệnh tương ứng trong terminal. Với Claude Code, Codex, Copilot và Gemini CLI, README cung cấp lệnh cài trực tiếp. Với các agent khác, README dùng `npx skills@latest`.

Bạn cũng cần một repository dự án nếu muốn chạy `/setup-matt-pocock-skills` và các skill engineering. Lệnh setup sẽ hỏi bạn dùng issue tracker nào, nhãn nào cho ticket và muốn lưu tài liệu ở đâu.

README không yêu cầu API key, GPU, tài khoản trả phí riêng, phiên bản Node.js hoặc phiên bản Python cụ thể. README có dùng `npx` cho một cách cài, nhưng không ghi rõ phiên bản Node.js cần thiết.

Repo có các file `package.json`, `package-lock.json` và `.claude-plugin`, nhưng README không hướng dẫn cài bằng `npm install` hay chạy một script Node riêng. Bạn nên làm theo phương thức cài dành cho agent của mình.

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

```steps
- Chọn agent | Chọn đúng một cách cài theo agent bạn đang dùng
- Cài bộ skill | Chạy lệnh plugin hoặc installer tương ứng
- Cấu hình Copilot nếu cần | Thêm marketplace vào file settings một lần
- Chạy setup | Trong repo dự án, chạy /setup-matt-pocock-skills một lần
- Kiểm tra skill | Gọi một skill phù hợp với việc đang làm
```

### Chọn cách cài theo agent

README khuyên bạn chọn một phương thức cho mỗi agent. Nếu cài đồng thời plugin tự cập nhật và bản file chỉnh sửa bằng `skills.sh`, bạn có thể nhận cùng một skill hai lần.

Nếu dùng Claude Code, chạy:

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

Plugin tự cập nhật theo mặc định.

Nếu dùng Codex, chạy lần lượt:

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

Bộ skill sẽ cập nhật khi Codex khởi động.

Nếu dùng GitHub Copilot CLI hoặc VS Code, chạy:

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

Các lệnh này thêm marketplace rồi cài plugin. Nếu bạn dùng Copilot trong VS Code, README còn hướng dẫn cách cài từ giao diện: chạy `Chat: Install Plugin From Source` và nhập địa chỉ GitHub của repo. README nói plugin trong VS Code cập nhật hằng ngày.

Nếu dùng Gemini CLI, chạy:

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

Gemini CLI dùng cách cập nhật thủ công. Khi cần cập nhật, chạy lại cả hai lệnh.

Nếu dùng agent khác hoặc muốn có file có thể chỉnh sửa, chạy:

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

Khi installer hỏi chọn skill, hãy đưa `setup-matt-pocock-skills` vào danh sách. README ghi rằng để cập nhật, chạy:

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

Sau đó chạy lại lệnh `add` nếu muốn lấy thêm skill mới. Chỗ dễ vấp là tùy chọn `-a`: README cho biết tùy chọn này liên quan đến các agent như cursor, opencode, devin, windsurf, amp và pi; nếu bỏ `-a`, installer sẽ cho bạn chọn.

### Cấu hình marketplace cho GitHub Copilot

Nếu dùng Copilot, mở file `~/.copilot/settings.json` và thêm cấu hình sau một lần:

```json
{
  "extraKnownMarketplaces": {
    "mattpocock": { "source": { "source": "github", "repo": "mattpocock/skills" }, "autoUpdate": true }
  }
}
```

Bạn cần đặt đúng cấu trúc JSON. Nếu file đã có các thiết lập khác, hãy thêm trường `mattpocock` vào `extraKnownMarketplaces` thay vì xóa các thiết lập cũ. README chỉ yêu cầu thao tác này một lần.

### Khởi tạo cấu hình cho từng repo dự án

Sau khi cài bộ skill, mở agent trong repository mà bạn muốn sử dụng và chạy:

```bash
/setup-matt-pocock-skills
```

Bạn cần chạy lệnh này một lần cho mỗi repository. Lệnh sẽ hỏi ba nhóm thông tin: issue tracker bạn muốn dùng, các label áp dụng cho ticket khi triage và nơi lưu tài liệu được tạo.

Các lựa chọn issue tracker được README nêu gồm GitHub, GitLab, file local hoặc một lựa chọn khác do bạn mô tả. Hãy trả lời theo cách nhóm đang làm việc thật, vì các skill sau đó cần biết nơi quản lý issue và tài liệu.

README chưa ghi một lệnh clone bắt buộc hay một lệnh chạy ứng dụng riêng. Nếu bạn đã có thư mục dự án, mở terminal tại đúng thư mục đó rồi chạy setup. Nếu chưa có repo, bạn có thể clone repo dự án bằng lệnh Git thông thường trước khi mở agent.

### Gọi skill đầu tiên

Sau khi setup, hãy gọi một skill đúng với việc đang làm. Ví dụ, trước khi thay đổi tính năng, bạn có thể dùng:

```bash
/grill-me
```

Nếu muốn vừa hỏi sâu vừa xây dựng tài liệu thuật ngữ và ADR, dùng:

```bash
/grill-with-docs
```

Các lệnh slash này được gõ trong agent, không phải chạy như lệnh PowerShell hay Bash thông thường. Nếu terminal báo không tìm thấy lệnh slash, hãy kiểm tra bạn đã cài skill vào đúng agent và đã khởi động agent trong đúng repository chưa.

## Kiểm tra đã chạy được chưa

Cách kiểm tra đầu tiên là mở agent sau khi cài và thử gọi `/setup-matt-pocock-skills` trong một repository. Nếu agent nhận lệnh và bắt đầu hỏi issue tracker, label triage và nơi lưu tài liệu, bộ skill đã được nhận diện.

Sau setup, thử gọi `/grill-me` trước một yêu cầu đơn giản. Kết quả mong đợi theo README là agent tiến hành một phiên hỏi chi tiết để làm rõ việc bạn muốn làm.

Bạn cũng có thể kiểm tra theo cách cụ thể hơn bằng `/tdd`, `/diagnosing-bugs` hoặc `/to-spec`, tùy nội dung dự án. Các skill này phải xuất hiện trong danh sách hoặc được agent gọi khi bạn yêu cầu đúng nhiệm vụ.

Với Gemini CLI, hãy nhớ hai lệnh cài đặt tương ứng với hai nhóm `engineering` và `productivity` đều phải hoàn tất. Với các plugin tự cập nhật, README nói Claude Code cập nhật mặc định, Codex cập nhật lúc khởi động và Copilot trong VS Code cập nhật hằng ngày.

Nếu dùng cách cài thủ công, việc cập nhật không tự xảy ra. Với Gemini CLI, chạy lại hai lệnh cài. Với `npx skills`, chạy `npx skills@latest update` rồi chạy lại lệnh `add` để chọn các skill mới.

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

### Dev nhận yêu cầu mơ hồ từ khách hàng

Một dev nhận yêu cầu “thêm chức năng quản lý đơn hàng” nhưng chưa biết trạng thái đơn, quyền người dùng và cách xử lý đơn hủy. Thay vì bảo agent viết ngay, dev mở agent trong repo rồi gọi:

```bash
/grill-me
```

Sau đó mô tả mục tiêu và trả lời các câu hỏi của agent. Kết quả mong đợi là yêu cầu được làm rõ trước khi code. Nếu dự án cần ghi lại thuật ngữ và quyết định, dùng `/grill-with-docs` để xây dựng ngôn ngữ chung, cập nhật `GLOSSARY.md` và ghi ADR theo khả năng được README mô tả.

### Nhóm muốn thêm tính năng nhưng sợ sửa nhầm kiến trúc

Một nhóm chuẩn bị thay đổi module thanh toán và kho hàng cùng lúc. Họ dùng `/to-spec` để trao đổi về các module sẽ bị tác động trước khi tạo đặc tả. Sau đó có thể dùng `/to-tickets` để tách kế hoạch thành các ticket nhỏ.

Kết quả thực tế là nhóm có một đặc tả và các phần việc rõ hơn trước khi triển khai. Nếu thay đổi lớn vượt quá một phiên làm việc, `/wayfinder` có thể giúp lập bản đồ các ticket quyết định để từng bước làm rõ đường đi.

### Dev muốn agent viết code có kiểm thử

Một dev cần thêm hàm tính phí vận chuyển và muốn tránh trường hợp agent chỉ đưa ra một bản sửa chưa được kiểm chứng. Dev yêu cầu agent dùng:

```bash
/tdd
```

Skill này hướng theo vòng lặp test thất bại, sửa code để test chạy, rồi refactor. Kết quả là phần thay đổi có vòng phản hồi cụ thể hơn và có cơ sở để phát hiện lỗi hồi quy về sau.

### Nhóm gặp lỗi khó tái hiện trong môi trường thật

Một ứng dụng thỉnh thoảng trả về kết quả sai nhưng chưa biết lỗi nằm ở dữ liệu, module hay luồng xử lý. Nhóm gọi:

```bash
/diagnosing-bugs
```

Họ cung cấp hiện tượng, cách tái hiện và các quan sát đã có. Skill dẫn việc chẩn đoán qua các pha thu nhỏ lỗi, đưa ra giả thuyết, thêm quan sát, sửa và tạo regression test. Cách này phù hợp hơn với việc yêu cầu agent thử nhiều bản sửa ngẫu nhiên.

> Hãy để agent hiểu đúng bài toán và nhận phản hồi đều đặn trước khi tăng tốc viết code.
>
> — Ông T

### Chủ shop hoặc nhân viên văn phòng muốn làm việc với agent có quy trình

Một người không trực tiếp viết code nhưng cần lập kế hoạch cho một công cụ nội bộ. Họ có thể dùng `/grill-me` để làm rõ nhu cầu, `/to-questionnaire` để biến các câu hỏi còn thiếu thành bảng hỏi gửi cho người quyết định, rồi dùng `/handoff` để tạo tài liệu bàn giao.

README không mô tả repo như một phần mềm kinh doanh độc lập. Vì vậy, các skill này chỉ hỗ trợ cách giao tiếp và tổ chức công việc trong agent; kết quả cụ thể còn phụ thuộc vào agent, repository và thông tin bạn cung cấp.

```note
Không đưa API key, mật khẩu hoặc thông tin nhạy cảm vào prompt nếu repository và agent chưa có quy định xử lý an toàn.
Các skill có thể giúp quy trình rõ hơn nhưng không tự thay bạn kiểm tra quyền truy cập, chi phí dịch vụ hoặc tính đúng của code.
```

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

### Cài trùng cùng một bộ skill

README cảnh báo không nên cài cả plugin và bản file chỉnh sửa từ `skills.sh` cho cùng một agent, vì bạn có thể nhận mọi skill hai lần. Hãy chọn một phương thức cho mỗi agent. Nếu không chắc bản nào đang được dùng, kiểm tra cấu hình plugin và cách installer đã thêm skill trước khi cài tiếp.

### Chạy setup ở sai thư mục

`/setup-matt-pocock-skills` được README mô tả là lệnh chạy một lần cho mỗi repo. Nếu bạn mở agent ngoài repository dự án, cấu hình issue tracker và tài liệu có thể không gắn với nơi bạn muốn.

Hãy mở agent từ đúng repo rồi chạy lại setup. Không chạy lặp lại nhiều lần nếu chưa có lý do thay đổi cấu hình.

### Copilot không nhận marketplace

Nếu Copilot không nhận plugin, kiểm tra bạn đã chạy hai lệnh `copilot` chưa và đã thêm `extraKnownMarketplaces` vào `~/.copilot/settings.json` chưa. File phải là JSON hợp lệ và phần `repo` phải trỏ đến `mattpocock/skills` như README.

### Gemini chỉ có một nhóm skill

Gemini CLI cần hai lệnh với hai đường dẫn `skills/engineering` và `skills/productivity`. Nếu chỉ chạy một lệnh, bạn có thể chỉ cài được một nhóm. Hãy chạy lại cả hai lệnh khi cập nhật thủ công.

### Installer không cho chọn skill mong muốn

Với `npx skills@latest add`, README yêu cầu đưa `setup-matt-pocock-skills` vào danh sách khi installer hỏi. Nếu bỏ qua skill này, bạn sẽ chưa có bước setup để khai báo issue tracker, label và nơi lưu tài liệu.

Nếu muốn chọn agent thủ công, bỏ tùy chọn `-a` như README hướng dẫn. Sau đó chọn đúng agent và skill trong phần hỏi của installer.

## Có nên dùng không

Bạn nên dùng repo này nếu thường xuyên làm việc với Claude Code, Codex, GitHub Copilot, Gemini CLI hoặc agent tương thích khác, và muốn quy trình làm việc có kỷ luật hơn. Bộ skill có phạm vi rộng: từ hỏi yêu cầu, xây dựng glossary, viết đặc tả, tạo ticket, TDD, gỡ lỗi đến review và cải thiện kiến trúc.

Điểm mạnh là skill nhỏ, có thể kết hợp và có thể điều chỉnh. Chúng không khóa bạn vào một model duy nhất. Repo cũng cung cấp nhiều cách cài, trong đó plugin có thể tự cập nhật với một số agent.

Giới hạn là README không đưa ra yêu cầu hệ thống chi tiết, không nêu benchmark, không mô tả API key hay chi phí của từng agent. Bộ skill cũng không thay thế kiến thức dự án, test thật hoặc review của con người. Agent vẫn cần đủ ngữ cảnh và quyền truy cập phù hợp để làm việc.

Nếu bạn chỉ cần một công cụ chạy độc lập để xử lý dữ liệu hoặc xây dựng ứng dụng, repo này có thể không phải lựa chọn trực tiếp. Đây là bộ hướng dẫn cho coding agent, không phải framework ứng dụng. Nếu nhóm chưa có agent tương thích hoặc chưa sẵn sàng chuẩn hóa cách làm việc, hãy thử từng skill nhỏ như `/grill-me` hoặc `/tdd` trước, rồi mới mở rộng sang quy trình đặc tả, ticket và review.

## Câu hỏi thường gặp

### Repo này có miễn phí không?

Repo dùng giấy phép MIT. README được cung cấp kèm các lệnh cài plugin và installer, nhưng không nêu chi phí của các coding agent mà bạn dùng cùng repo.

### Có cần GPU hoặc API key không?

README không yêu cầu GPU hoặc API key riêng cho bộ skill. Bạn vẫn có thể cần tài khoản, quyền truy cập hoặc chi phí theo agent được dùng, nhưng tài liệu này không nêu chi tiết.

### Có chạy được trên Windows không?

README không nêu rõ ma trận hệ điều hành hay hỗ trợ Windows. Tài liệu chỉ cung cấp các lệnh shell và hướng dẫn theo từng agent, nên bạn cần kiểm tra agent đang dùng có hỗ trợ môi trường của mình hay không.

### Tôi có cần cài cả plugin và bản skills thủ công không?

Không nên. README khuyên chọn một phương thức cho mỗi agent, vì cài cả hai có thể khiến mọi skill xuất hiện hai lần.

### Sau khi cài có cần chạy setup không?

Có, README hướng dẫn chạy `/setup-matt-pocock-skills` một lần cho mỗi repository. Lệnh này hỏi issue tracker, label dùng khi triage và nơi lưu tài liệu được tạo.

### Bộ skill có tự cập nhật không?

Tùy cách cài. Claude Code cập nhật theo mặc định, Codex cập nhật khi khởi động, còn Gemini CLI yêu cầu chạy lại hai lệnh cài. Với `npx skills`, README hướng dẫn chạy `npx skills@latest update` rồi chạy lại `add` để chọn skill mới.

### Repo này khác gì một framework phát triển ứng dụng?

Đây là bộ skill cho coding agent, không phải framework ứng dụng độc lập. Nó hướng dẫn agent hỏi yêu cầu, lập đặc tả, kiểm thử, gỡ lỗi và review code; README không mô tả API để xây dựng một ứng dụng bằng repo này.
