Lộ trình học›Agent & Skills›Introduction to Agent Skills Mở bản đồ

15.0 · Giới thiệu khóa học — Introduction to Agent Skills

Bài viếtCơ bản15 phút đọc

Hãy thành thật một chút. Bạn đã bao nhiêu lần làm điều này trong tuần vừa qua:

Sau bài này, bạn sẽ
  1. Giải thích skill là gì, khác CLAUDE.md/subagent/hook/MCP ra sao, và khi nào nên dùng loại nào
  2. Tạo một skill cá nhân hoàn chỉnh từ scratch với SKILL.md + frontmatter chuẩn
  3. Cấu hình các field nâng cao: allowed-tools cho bảo mật, model để chọn model, progressive disclosure cho skill nhiều file
  4. Chia sẻ skill với team qua repository, qua plugin marketplace, hoặc deploy toàn tổ chức bằng enterprise managed settings
  5. Debug 6 nhóm sự cố phổ biến nhất khi skill không trigger / không load / bị conflict / chạy fail

Tại sao bạn cần khóa học này?

  • Mở Claude Code, gõ lại y nguyên đoạn hướng dẫn "viết PR description theo format What/Why/Changes" — lần thứ 23 trong năm.
  • Paste lại brand guidelines của công ty vào đầu mỗi cuộc hội thoại trước khi nhờ Claude thiết kế slide.
  • Nhắc đi nhắc lại "nhớ dùng TypeScript strict mode nhé" trong mỗi session mới.
  • Giải thích lại coding convention của team mỗi lần onboard người mới vào Claude Code.
  • Copy 40 trang PDF brand book vào context window và cầu nguyện nó không bị cắt mất.

Nếu bạn gặp ít nhất 2 trong 5 tình huống trên, bạn đang trả giá bằng thời gian cho một thứ lẽ ra phải miễn phí. Có một câu nói Litton từ AI University nói thẳng toẹt: "Stop, if you are still copy-pasting the same instructions into Claude every single day."

Khóa học này dạy bạn Agent Skills — cơ chế để đóng gói những hướng dẫn lặp đi lặp lại thành một "kỹ năng" Claude tự động gọi ra khi cần, không cần bạn nhắc. Viết một lần, Claude áp dụng mãi mãi, đồng nhất từ lần 1 đến lần 1000.

Skill không phải prompt. Không phải CLAUDE.md. Không phải slash command.

Trước khi đi sâu, một câu hỏi quan trọng: "Tôi đã có CLAUDE.md rồi, đã có slash command rồi — skill là cái gì mới?"

Sự khác biệt nằm ở thời điểm load và cách trigger:

Cơ chếLoad khi nào?Trigger bằng cái gì?
CLAUDE.mdMỗi conversation, luôn luônKhông cần, auto
Slash commandKhi bạn gõ /tên-commandBạn gõ tay
SkillChỉ khi liên quan với requestClaude tự match từ description

Skill là "kiến thức on-demand" — nó ngủ trong thư mục của bạn cho đến khi bạn nói "review PR này đi", rồi mới bừng tỉnh. Không bloat context window. Không cần bạn nhớ gõ gì.

Otto (engineer Anthropic) gọi đó là: "organized folders that package expertise that Claude can automatically invoke when relevant."

Lộ trình 7 bài học

┌──────────────────────────────────────────────────────────┐
│                                                          │
│  MODULE 1: HIỂU BẢN CHẤT                                 │
│  ├── 15.1  Giới thiệu khóa học (bạn đang ở đây)          │
│  └── 15.2  Skill là gì — Khái niệm, nơi lưu, so sánh     │
│                                                          │
│  MODULE 2: TẠO & CẤU HÌNH                                │
│  ├── 15.3  Tạo skill đầu tiên — PR description skill     │
│  └── 15.4  Cấu hình & multi-file skill                   │
│                                                          │
│  MODULE 3: HỆ SINH THÁI                                  │
│  ├── 15.5  Skill vs CLAUDE.md / subagent / hook / MCP    │
│  └── 15.6  Chia sẻ skill — repo, plugin, enterprise      │
│                                                          │
│  MODULE 4: VẬN HÀNH BỀN VỮNG                             │
│  ├── 15.7  Khắc phục sự cố — 6 categories thường gặp     │
│  └── 15.7  Quiz tổng hợp 25 câu                          │
│                                                          │
└──────────────────────────────────────────────────────────┘

Tổng thời gian: ~2 giờ đọc + ~1.5 giờ thực hành = ~3.5 giờ hoàn thành trọn vẹn.

Ai nên học khóa này?

Nếu bạn là developer / engineer

Bạn dùng Claude Code hàng ngày, viết code + review PR + debug. Khóa này cho bạn cách đóng gói review checklist, coding convention, PR template thành những skill tự kích hoạt. Kết quả: mỗi lần review một PR, Claude tự dùng checklist của team bạn mà không cần nhắc.

Nếu bạn là team lead / tech lead

Bạn muốn team nhất quán — cùng style commit, cùng review tiêu chuẩn, cùng cách viết tài liệu. Khóa này cho bạn cách deploy skill cho cả team qua .claude/skills commit vào repo, hoặc qua plugin marketplace nội bộ.

Nếu bạn là platform / DevOps / enterprise admin

Bạn muốn enforce security & compliance: "mọi skill review phải kiểm tra OWASP top 10", "không ai được cài plugin ngoài whitelist". Khóa này có phần enterprise managed settings với strictKnownMarketplaces.

Nếu bạn là power user (không code nhưng dùng Claude nặng)

Skill không chỉ dành cho coder. Bạn có thể dùng skill để: đóng gói format email công ty, template báo cáo tuần, checklist onboard khách hàng mới. Bài 15.1 và 15.3 đủ cho bạn bắt đầu.

3 triết lý xuyên suốt khóa học

1. "Nếu bạn thấy mình giải thích cùng một thứ nhiều lần — đó là một skill đang chờ được viết."

Đây là rule of thumb quan trọng nhất. Không phải mọi hướng dẫn đều nên thành skill. Chỉ những hướng dẫn lặp lại thường xuyên mới đáng đầu tư. Khóa học sẽ cho bạn tiêu chí quyết định ở Bài 15.1 và 15.5.

2. Progressive disclosure — "Table of contents, không phải cả cuốn sách"

Skill chia sẻ context window với cuộc hội thoại của bạn. Nếu một skill phình tới 2000 dòng, mỗi lần load sẽ "ăn" hết vài chục phần trăm context. Triết lý progressive disclosure nói: giữ SKILL.md gọn (< 500 dòng), để chi tiết vào file phụ (references/, scripts/, assets/), Claude chỉ load khi cần.

Otto ví điều này như "một mục lục trong context window, thay vì nhét cả cuốn sách vào."

3. "MCP connects to data, Skills teach Claude what to do with it."

Một câu nói ngắn của Otto phân định rõ ràng nhất giữa Skills và MCP — hai thứ dễ bị nhầm. MCP cho Claude access vào dữ liệu (database, GitHub, Slack). Skill cho Claude biết phải xử lý dữ liệu đó như thế nào theo style của team bạn. Cả hai hoạt động cùng nhau, không cạnh tranh. Chi tiết ở Bài 15.4.

Sai lầm phổ biến của người mới

Sai lầm 1: Cố biến mọi thứ thành skill

Không phải mọi instruction đều là candidate cho skill. Nếu hướng dẫn đó luôn luôn áp dụng (ví dụ: "project này dùng Next.js"), đó là việc của CLAUDE.md, không phải skill. Skill dành cho kiến thức task-specific, chỉ liên quan đôi khi.

Sai lầm 2: Description quá chung chung

"Helps with code" — description này sẽ không bao giờ trigger đúng. Claude dùng semantic matching, nên description cần:

  • Hành động cụ thể (review PR, tạo commit message, extract data)
  • Trigger phrase user thực sự nói ("review this PR", "summarize my changes")

Bài 15.3 có công thức chi tiết.

Sai lầm 3: Nhồi tất cả vào một file 2000 dòng

"Tôi muốn skill đầy đủ nhất có thể" — và rồi context window ăn mất 30% mỗi khi skill load. Progressive disclosure có lý do: < 500 dòng trong SKILL.md, phần còn lại ở file phụ load khi cần.

Sai lầm 4: Xây 20 skill cuối tuần

"Start with one" — tác giả tutorial DBS nói thẳng. "Think about a task that you do most often that follows the same process every single time, and build one skill for that task." Khi bạn đã có 1 skill work tốt, những cái tiếp theo sẽ nhanh hơn rất nhiều.

Bạn sẵn sàng chưa?

Hãy dành 3 phút ngay bây giờ để viết ra:

  1. Một task bạn làm ít nhất 3 lần/tuần với Claude — lặp lại cùng hướng dẫn.
  2. Phần hướng dẫn bạn paste lại nhiều nhất (PR format, email template, review checklist...).
  3. Một nỗi đau cụ thể khi Claude "quên" style của bạn giữa các session.

Giữ 3 thứ này trong đầu. Chúng là candidate đầu tiên cho skill bạn sẽ tạo ở Bài 15.2.

Trước khi bắt đầu: Điều kiện tiên quyết

Bắt buộc

  • Claude Code cài đặt sẵn (CLI hoặc extension VS Code/JetBrains)
  • Terminal/shell cơ bản (tạo folder, chỉnh sửa file)
  • Kiến thức markdown cơ bản

Nên có

  • Một dự án thật để áp dụng skill ngay khi học (không dùng sandbox trống)
  • Git + GitHub account (để làm phần chia sẻ qua repo ở Bài 15.5)
  • Paid plan Claude.ai (Pro, Max, Team, hoặc Enterprise) nếu muốn test skill trên Claude web — không bắt buộc cho Claude Code

Không cần

  • Biết Python, bash, hay bất kỳ ngôn ngữ cụ thể nào (skill chỉ là markdown + optional scripts)
  • Enterprise license (trừ khi bạn muốn làm phần 15.6 deep dive)
  • Kiến thức về LLM internals

Một lời khuyên từ kinh nghiệm thực tế

Có hai lối đi khi học khóa này:

Lối 1: Đọc xong rồi làm — đọc hết 7 bài, rồi mới ngồi xuống viết skill đầu tiên.

Lối 2 (khuyến nghị): Vừa đọc vừa viết — ở Bài 15.2, bạn sẽ được hướng dẫn tạo skill pr-description từ scratch. Dừng lại ở đó, làm thật, rồi mới sang bài 15.3. Bài 15.6 sẽ dạy debug — nhưng bạn chỉ hiểu sâu khi đã từng tự tay gây ra lỗi.

80/20 rule từ tutorial DBS: "It gets me 80% of the way there. And then I do the other 20%." Skill không phải magic bullet. Nó là đòn bẩy — bạn vẫn phải đầu tư 20% cuối, nhưng 80% đầu được tự động hóa. Đặt kỳ vọng đúng từ đầu sẽ giúp bạn đỡ thất vọng ở Bài 15.6.

Bắt đầu nào

Bài 15.1 sẽ định nghĩa chính xác skill là gì, nó sống ở đâu, và cho bạn thấy cấu trúc SKILL.md tối giản. Sau khi học xong bài đó, bạn sẽ có đủ mental model để sang Bài 15.2 — tạo skill đầu tiên bằng chính tay mình.

Phản hồi & hỗ trợ

Bạn đã hoàn thành bài này chưa?Tiến độ lưu trên trình duyệt của bạn.