Agent Skills cho engineer thật
Matt Pocock skills: workflow nhỏ ghép được, không vibe coding. Cài đặt, phân loại, flow chính.
Vibe coding ship demo. Engineer thật ship hệ thống sống được qua thay đổi. mattpocock/skills ↗ — 275k star, 23k fork, MIT — là bộ skill nhỏ, ghép được, cho việc thật: grilling, domain modeling, TDD, chẩn đoán bug, kiến trúc, triage.
Không phải GSD, BMAD, Spec-Kit. Mấy framework đó ôm process và lấy mất control của bạn. Skill ở đây là tool sắc, đơn mục đích. Bạn tự ghép. Chạy với mọi model.
Vì sao có bộ skill này: 4 failure mode#
| # | Thất bại | Skill sửa |
|---|---|---|
| 1 | Agent build sai ý | /grill-me, /grill-with-docs |
| 2 | Agent dài dòng, jargon loạn | shared language trong GLOSSARY.md + ADR |
| 3 | Code không chạy | /tdd, /diagnosing-bugs |
| 4 | Ball of mud, entropy tốc độ agent | /to-spec, /improve-codebase-architecture |
ELI5: giao việc cho agent không hỏi gì giống bảo thợ “xây nhà” mà không có bản vẽ. Grilling là buổi phỏng vấn ra bản vẽ. Shared language là thống nhất “tường” nghĩa là gạch, không phải rèm. TDD là kiểm tra từng viên gạch trước khi xếp tiếp. Review kiến trúc là sửa móng trước khi chồng tầng.
Cài trong 30 giây#
Hai đường, hai triết lý. Chọn một — cài cả hai là mỗi skill trùng hai lần.
# Claude Code: bundle read-only, tự update
claude plugins install mattpocock-skills
# hoặc trong session:
/plugin install mattpocock-skills
# Codex và agent khác: copy editable bạn sở hữu
npx skills@latest add mattpocock/skills
# chọn skill, nhớ kèm setup-matt-pocock-skillsbashRồi chạy một lần mỗi repo:
/setup-matt-pocock-skills
# hỏi: issue tracker (GitHub / Linear / local files)
# hỏi: triage label cho /triage
# hỏi: nơi lưu docstext[!WARNING] Cài cả plugin lẫn skills.sh là trùng skill. Subscribe (plugin) hoặc fork (skills.sh), không cả hai.
[!TIP] Dân vọc: dùng
npx skills@latest addngay cả trên Claude Code. File nằm trong repo bạn, không gì tự update sau lưng. Muốn mới thìnpx skills update.
User-invoked vs model-invoked#
Một trục duy nhất cần nhớ:
- User-invoked (
/grill-me,/implement,/triage…) — chỉ bạn gõ mới chạy. Việc: orchestrate. Không bao giờ gọi user skill khác. - Model-invoked (
/tdd,/code-review,/diagnosing-bugs…) — bạn hoặc agent gọi khi task hợp. Giữ discipline tái dùng.
User skill được gọi model skill, không bao giờ gọi user skill khác.
Bản đồ skill engineering#
User-invoked:
/ask-matt— router: tình huống nào hợp skill nào/grill-with-docs— phỏng vấn + mài术语, updateGLOSSARY.md+ ADR inline/triage— đẩy issue qua state machine các vai triage/improve-codebase-architecture— quét deepening opportunity, báo cáo HTML, grill cái bạn chọn/to-spec— tổng hợp hội thoại thành spec trên tracker, không phỏng vấn/to-tickets— chẻ plan thành ticket tracer-bullet kèm blocking edge/implement— build từ spec/ticket, TDD ở seam đã hẹn, chốt bằng/code-review/implement-spec— cả spec trên một branch, subagent chạy mặt ready frontier/wayfinder— việc khổng lồ thành bản đồ decision ticket, gỡ từng cái/retro— đề xuất cải thiện môi trường sau session, nặng trước
Model-invoked:
/tdd,/diagnosing-bugs,/research,/domain-modeling,/codebase-design,/code-review,/pr,/prototype,/wizard
Bản đồ skill productivity#
User-invoked: /grill-me, /handoff, /teach, /to-questionnaire, /wait-what
Model-invoked: /grilling (primitive phỏng vấn đứng sau grill-me, grill-with-docs, triage, wayfinder), /writing-for-agents
Ví dụ thực tế: một feature slice#
npx skills@latest add mattpocock/skills
# chọn: setup-matt-pocock-skills, grill-with-docs, to-spec, to-tickets, implementbash# 1. mỗi repo một lần
/setup-matt-pocock-skills
# 2. align trước code
/grill-with-docs
# agent phỏng vấn bạn, mài术语 vào GLOSSARY.md, ghi ADR
# 3. spec rồi ticket
/to-spec
/to-tickets
# 4. build có kỷ luật
/implement
# lái /tdd ở seam, chốt /code-review trước committextPayoff của shared language, ví dụ thật từ repo tác giả: TRƯỚC “a lesson inside a section given a spot in the filesystem” → SAU “materialization cascade”. Một thuật ngữ thay hai mươi từ, mọi session, cộng tên biến/hàm/file nhất quán.
Ghi chú cross-agent#
Đa agent từ đầu: Claude Code, Codex, Cursor, Copilot, Windsurf, Gemini, Cline qua skills.sh. Hai нюанс: OpenCode chưa có trong installer — cài vào .claude/skills hoặc .agents/skills mà nó đọc, hoặc copy thư mục. Và flag user-invoked là quy ước Claude Code — agent nào lờ flag sẽ expose chúng thành model-invoked.
Khi nào dùng, khi nào bỏ#
| Dùng khi | Bỏ khi |
|---|---|
| Muốn workflow giữ kỷ luật | Muốn framework tự trị ôm process |
Tool load được SKILL.md | Tool không load được skill |
| Team coi trọng TDD, ADR, issue hygiene | Chỉ muốn gen one-shot |
| Bạn thích adapt skill nhỏ vào repo | Cần PM product hosted opinionated |
Kết luận#
Nhỏ, ghép được, hack được. Bắt đầu bằng /setup-matt-pocock-skills, rồi /grill-with-docs cho mọi feature. Bài 2 đi sâu vòng grill → TDD → debug.