Techsy
Liên hệ
Bắt đầu
Quay lại Blog
ai-machine-learning

Hướng dẫn Claude Skills: Tạo SKILL.md đầu tiên trong 10 phút (2026)

Viết bởi Techsy Editorial Team
May 1, 2026
21 phút đọc
Mục lục
Hướng dẫn Claude Skills: Tạo SKILL.md đầu tiên trong 10 phút (2026)

Hướng dẫn Claude Skills: Tạo SKILL.md đầu tiên của bạn trong 10 phút (2026)

Skills là tính năng quan trọng nhất của Claude Code mà có thể bạn vẫn chưa sử dụng. Một Claude skill là một thư mục chứa tệp SKILL.md mà Claude sẽ tự động tải ngay khi prompt của bạn khớp với mô tả của nó — không cần copy-paste prompt, không cần một tệp CLAUDE.md phình to, không cần phải nhớ xem nên dùng template nào. Chúng tôi đã phát hành 4 skill bên trong thư mục .claude/skills/agent/ của repo này, và với Skills 2.0 cùng Anthropic Marketplace ra mắt vào đầu năm 2026, định dạng này cuối cùng đã thực sự phát huy hết tiềm năng. Dưới đây là quy trình hiệu quả sau khi đã vượt qua những cạm bẫy thường gặp.

Những điểm chính cần nhớ

  • Claude skill là một thư mục chứa tệp SKILL.md với YAML frontmatter, được Claude tự động tải khi có liên quan.
  • Skills được đặt trong ~/.claude/skills/ (cá nhân) hoặc .claude/skills/ (dự án); Claude quét cả hai khi khởi động.
  • Dùng Skills cho các quy trình làm việc có thể lặp lại; dùng MCP cho dữ liệu bên ngoài theo thời gian thực; dùng subagent cho việc lập kế hoạch nhiều bước; dùng hook cho các sự kiện có tính xác định.
  • Cách nhanh nhất để tạo skill đầu tiên là yêu cầu Claude gọi chính skill skill-creator của nó — nó sẽ viết SKILL.md thay cho bạn.

Claude Skills là gì?

Claude skill là một thư mục chứa tệp SKILL.md với YAML frontmatter (name, description, và allowed-tools tùy chọn) mà Claude Code tự động nạp vào ngữ cảnh khi prompt của bạn khớp với phần mô tả. Skill đóng gói các quy trình làm việc tái sử dụng, như /commit hay /explain-code, mà không làm phình system prompt của bạn.

Theo tài liệu chính thức của Anthropic, mỗi thư mục skill có ba thành phần: tệp SKILL.md bắt buộc, các script đóng kèm tùy chọn (từ một helper Python đến một tệp cấu hình JSON), và tài liệu tham khảo tùy chọn được nạp cùng với phần nội dung chính. Chỉ vậy thôi. Không cần build, không cần cài đặt, không cần manifest.

Điểm thông minh nằm ở progressive disclosure (tiết lộ dần dần). Khi khởi động, Claude chỉ quét trường description của mọi skill. Phần nội dung, hướng dẫn, ví dụ, mẫu gọi công cụ, vẫn nằm trên đĩa cho đến khi prompt của bạn thực sự khớp. Vậy nên bạn có thể cài 50 skill mà không tốn một token nào cho đến khi có skill được kích hoạt.

Hãy tưởng tượng skill như những công thức trong sách nấu ăn mà Claude lật đến khi thấy các nguyên liệu trong prompt của bạn. Skill là một thư mục mà Claude đọc theo nhu cầu, chứ không phải một đoạn prompt bạn phải nhớ để dán vào. Đó là toàn bộ ý tưởng.

Một tệp SKILL.md tối giản trông như thế này:

markdown
---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---

Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.

Mười dòng. Skill thật. Sẵn sàng kích hoạt.

Bắt đầu nhanh: Xây dựng Skill đầu tiên của bạn trong 10 phút

Để xây dựng skill Claude đầu tiên của bạn trong 10 phút: (1) tạo ~/.claude/skills/explain-code/, (2) thêm một tệp SKILL.md có chứa name, description và phần nội dung quy trình làm việc, (3) khởi động lại Claude Code để nó quét thư mục mới, (4) kích hoạt nó bằng một lời nhắc khớp với mô tả.

Dưới đây là toàn bộ quy trình.

Bước 1: Tạo thư mục

bash
mkdir -p ~/.claude/skills/explain-code

Kỹ năng cá nhân (chỉ dành cho bạn) được đặt trong ~/.claude/skills/. Kỹ năng dự án (chia sẻ qua git với nhóm của bạn) được đặt trong .claude/skills/ tại thư mục gốc của repo. Hãy chọn loại cá nhân cho các quy trình làm việc hàng ngày; chọn loại dự án khi bạn muốn mọi người đóng góp trong repo đều kế thừa nó.

Bước 2: Viết SKILL.md

Đặt tệp này tại ~/.claude/skills/explain-code/SKILL.md:

markdown
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---

You are explaining code to a developer who is new to this codebase.

1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.

Đó là toàn bộ skill. Phần frontmatter là bản hợp đồng; phần nội dung là cẩm nang thực hành.

Bước 3: Khởi động lại Claude Code

Live discovery là một tính năng của Skills 2.0, các phiên bản Claude Code cũ hơn cần được khởi động lại để nhận diện thư mục mới. Nếu bạn không chắc mình đang dùng phiên bản nào, việc khởi động lại một lần cũng chẳng tốn kém gì.

Bước 4: Kích hoạt

Mở một dự án và nhập prompt:

text
walk me through what auth/middleware.ts does

Claude đối chiếu prompt của bạn với trường description, tìm thấy explain-code và âm thầm nạp phần nội dung của SKILL.md vào ngữ cảnh. Bạn sẽ thấy "Using skill: explain-code" trong nhật ký công cụ. Xong.

Mẹo pro: Ngại tự viết file? Hãy mở Claude Code và nói Use the skill-creator skill to scaffold an explain-code skill for me. skill-creator tích hợp sẵn của Anthropic là một meta-skill: nó sẽ đặt câu hỏi cho bạn, chọn các allowed-tools hợp lý và viết SKILL.md vào đúng thư mục. Đây là con đường nhanh nhất để có skill đầu tiên của bạn, không bàn cãi.

Đó là lời hứa 10 phút, năm phút gõ phím, một lần khởi động lại, một prompt thử nghiệm.

Sơ đồ thể hiện cách Claude Code khám phá các skill bằng cách quét những thư mục ~/.claude/skills/ và .claude/skills/ khi khởi động, rồi nạp từng SKILL.md vào khay skill khả dụng.

Bên trong SKILL.md: Tham chiếu Frontmatter

Frontmatter của SKILL.md là YAML được bao bọc trong các dấu phân cách ---. Có hai trường bắt buộc: name (tối đa 64 ký tự, được dùng làm tên lệnh slash) và description (văn bản kích hoạt mà Claude đối chiếu với prompt của bạn). Các trường tùy chọn kiểm soát quyền truy cập công cụ, lời gọi mô hình, glob tệp và ngữ cảnh thực thi.

Dưới đây là bảng tham chiếu đầy đủ, được lấy từ tài liệu về skills của Anthropic:

TrườngBắt buộc?KiểuDùng khi
namecóchuỗi ≤64 ký tựluôn luôn, trở thành tên lệnh slash
descriptioncóchuỗi ≤1024 ký tựluôn luôn, Claude quét trường này để quyết định xem skill có khớp hay không
allowed-toolskhôngmảng các mẫu công cụkhóa skill vào các công cụ cụ thể (ví dụ: Bash(git *), Read, Grep)
disable-model-invocationkhôngbooleankhiến skill chỉ có thể được gọi bởi người dùng (lệnh slash, không bao giờ tự động kích hoạt)
user-invocablekhôngbooleanđánh dấu một skill nên hiển thị dưới dạng /skill-name trong bảng lệnh slash
argument-hintkhôngchuỗicung cấp cho người dùng gợi ý về nội dung mà $ARGUMENTS nên chứa
modelkhôngchuỗighim skill vào một mô hình cụ thể (ví dụ: claude-opus-4-7)
contextkhôngdefault hoặc fork(Skills 2.0) chạy skill trong một cửa sổ ngữ cảnh được phân tách (fork) để nó không làm ô nhiễm luồng chính
globskhôngmảng các mẫu globtự động gợi ý skill khi các tệp khớp với glob đang nằm trong phạm vi
referenceskhôngmảng các đường dẫn tệpđóng gói các tài liệu tham chiếu được tải cùng với phần thân skill
bundled-fileskhôngmảng các đường dẫn tệpđóng gói các script mà skill có thể thực thi
tagskhôngmảng các chuỗitổ chức các skill trong danh sách marketplace

Hàng context: fork đáng được nêu bật riêng. Đây là một primitive của Skills 2.0, chạy skill bên trong một cửa sổ ngữ cảnh biệt lập, hữu ích cho các skill nghiên cứu chạy trong thời gian dài hoặc bất kỳ thứ gì tạo ra nhiều token trung gian mà bạn không muốn làm ô nhiễm luồng chính của mình. Nếu bạn mới làm quen với khái niệm này, hướng dẫn về kỹ thuật ngữ cảnh của chúng tôi sẽ trình bày các đánh đổi liên quan. Một frontmatter SKILL.md theo chủ nghĩa tối đa, mọi trường đều được điền đầy đủ:

yaml
---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---

Mẹo chuyên nghiệp: Sai lầm lớn nhất khi viết description: viết cho con người đọc. Hãy viết cho Claude — dùng các cụm từ kích hoạt cụ thể, không phải văn phong quảng cáo. Tệ: "Một kỹ năng tự động hóa Git mạnh mẽ." Tốt: "Sử dụng khi người dùng muốn commit thay đổi, viết thông điệp commit, hoặc mở một PR."

Hai kỹ năng thực tế, hoàn chỉnh từ đầu đến cuối

Hai mẫu kỹ năng bao quát 80% các trường hợp sử dụng thực tế: (1) kỹ năng /commit do người dùng gọi, với disable-model-invocation: true và allowed-tools: Bash(git *) cho các hành động mang tính xác định; (2) kỹ năng /explain-code tự động được gọi, với frontmatter mặc định mà Claude sẽ kích hoạt khi câu lệnh khớp với mô tả của kỹ năng đó.

Hầu hết các bài hướng dẫn chỉ đưa ra những đoạn mã ngắn. Dưới đây là hai tệp hoàn chỉnh mà bạn có thể sao chép vào ~/.claude/skills/ ngay hôm nay.

Skill /commit (người dùng gọi thủ công)

markdown
---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
  - "Bash(git status:*)"
  - "Bash(git diff:*)"
  - "Bash(git add:*)"
  - "Bash(git commit:*)"
---

1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
   changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
   blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.

Câu lệnh thử nghiệm: /commit

Điều gì xảy ra: Claude kiểm tra trạng thái git, soạn một thông điệp commit, yêu cầu bạn xác nhận, rồi mới thực thi git commit. Cờ disable-model-invocation: true đảm bảo skill không bao giờ tự kích hoạt khi gặp một câu mơ hồ kiểu "lưu thay đổi của tôi", nó chỉ chạy khi bạn gõ /commit. Danh sách trắng allowed-tools giới hạn skill ở các lệnh con của git; về mặt kỹ thuật, nó không thể chạy rm -rf hay push lên remote. Đây là skill chúng tôi đang dùng trực tiếp trong pipeline của chính mình.

Với các hành động hậu commit mang tính tất định (chạy lint, tái tạo type, gọi Slack webhook), hãy dùng Claude Code hooks thay thế — skill có tính xác suất, còn hook luôn kích hoạt mỗi lần.

Skill /explain-code (có thể gọi bởi model)

markdown
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---

1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
   the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.

Prompt thử nghiệm: walk me through what auth/middleware.ts does

Điều gì xảy ra: hãy để ý rằng người dùng đã không gõ /explain-code. Claude đối chiếu "walk me through" với trường description, tìm thấy skill và tự động gọi nó. Đó chính là điều kỳ diệu, trường description đang đảm nhận việc định tuyến. Trường model: claude-opus-4-7 ghim skill này vào Opus bất kể bạn đã đặt model nào làm mặc định, nhờ đó các phần phân tích code chuyên sâu luôn sử dụng model thông minh hơn. (Tìm hiểu thêm về việc chạy Claude Code với các model khác nhau.)

Tại sao lại có hai mẫu? Skill #1 có thể gọi bởi người dùng + bị khóa vào các công cụ cụ thể, có thể dự đoán được, an toàn, hoàn hảo cho git hoặc triển khai. Skill #2 được tự động gọi + có tính mở, điều kỳ diệu của các skill, nhưng hãy tin tưởng vào trường description của bạn. Các skill gọi bởi người dùng mang lại khả năng dự đoán; các skill gọi bởi model mang lại điều kỳ diệu. Hãy chọn theo từng skill, chứ không phải theo từng repo.

Để xem thêm các skill mẫu thực tế, hãy xem repo anthropics/skills chính thức và danh sách awesome-claude-skills do cộng đồng duy trì.

Skills vs MCP vs Subagents vs Hooks: Khi nào dùng gì

Dùng Skills cho các quy trình làm việc tái sử dụng mà Claude nên tự động kích hoạt hoặc bạn gọi dưới dạng lệnh gạch chéo. Dùng MCP servers khi bạn cần dữ liệu bên ngoài theo thời gian thực (cơ sở dữ liệu, API, hệ thống tệp nằm ngoài thư mục làm việc). Dùng subagents cho các kế hoạch nhiều bước mà Claude nên ủy quyền cho một ngữ cảnh mới. Dùng hooks cho các sự kiện tất định (pre-commit, post-tool-use) phải luôn luôn chạy, không bao giờ mang tính xác suất.

Khung nhanh: skills là quy trình làm việc, Model Context Protocol là dữ liệu, subagents là kế hoạch, hooks là sự kiện. Mỗi thứ nằm ở một tầng khác nhau của Claude Code, và chọn sai tầng là chọn sai công cụ. Theo chính bài viết Skills explained của Anthropic, đây là khung tư duy mà họ muốn bạn nắm vững.

Câu hỏiSkillsMCPSubagentsHooks
Được kích hoạt bởikhớp prompt hoặc /slashcmdmô hình quyết định gọi một toolmô hình ủy quyền một tác vụsự kiện của Claude Code (pre-tool-use, post-edit)
Nằm ở.claude/skills/máy chủ bên ngoài (stdio hoặc SSE).claude/agents/khối hooks trong settings.json
Phù hợp nhất choquy trình làm việc tái sử dụng, mẫu prompt có logicdữ liệu thời gian thực, API bên thứ ba, truy cập hệ thống tệp ngoài cwdlập kế hoạch nhiều bước, công việc song song, ngữ cảnh biệt lậpsự kiện tất định phải luôn chạy
Tính tất địnhxác suất (Claude chọn)xác suất (Claude chọn)xác suất (Claude chọn)tất định (luôn chạy)
Chi phí tokenthấp (chỉ description được tải khi quét)trung bình-cao (định nghĩa tool + phản hồi)cao (ngữ cảnh mới cho mỗi lần ủy quyền)không có (thực thi shell ngoài luồng)
Khi KHÔNG nên dùngdữ liệu thời gian thực, sự kiện tất địnhquy trình tĩnh, logic prompthành động tất định một lầnlogic phân nhánh, bất cứ gì mang tính xác suất

Chúng kết hợp được với nhau. Một skill có thể gọi một MCP tool thông qua allowed-tools. Một hook có thể chạy sau khi một skill hoàn tất. Một subagent có thể sử dụng các skills mà nó được cấp quyền truy cập. Mô hình tư duy gọn gàng nhất: chọn đúng tầng trước, rồi để chúng xếp chồng lên nhau. Skills là nguyên thủy kỹ thuật ngữ cảnh mà bạn tìm đến khi muốn có một quy trình làm việc mà Claude có thể chọn; bạn tự động hóa bằng hooks khi muốn một thứ mà Claude không thể bỏ qua. Cách tệ nhất để dùng sai từng thứ: Dùng Skills cho dữ liệu thời gian thực (hãy dùng MCP); dùng MCP cho các mẫu prompt dùng một lần (hãy dùng Skills); dùng subagent cho các chỉnh sửa file mang tính xác định (hãy dùng hook); dùng hook cho logic phân nhánh (hãy dùng Skills). Skills là quy trình làm việc, MCP là dữ liệu, subagent là kế hoạch, hook là sự kiện. Hãy chọn theo tầng, chứ đừng theo từ khóa hot.

Skills nằm ở đâu: Cá nhân, Dự án, Plugin, Doanh nghiệp

Claude skills được cài đặt ở bốn phạm vi: cá nhân (~/.claude/skills/, chỉ mình bạn), dự án (.claude/skills/ ở thư mục gốc repo, chia sẻ với team qua git), plugin (phân phối qua Anthropic Marketplace hoặc bất kỳ URL plugin nào), và doanh nghiệp (do bộ phận IT đẩy xuống qua MDM/chính sách quản trị). Claude quét cả bốn phạm vi này khi khởi động.

Phạm viĐường dẫnChia sẻPhù hợp nhất cho
Cá nhân~/.claude/skills/không chia sẻquy trình làm việc hằng ngày của riêng bạn (commit, review, viết PR)
Dự án.claude/skills/ (thư mục gốc repo)git, mọi contributor trong repoquy ước của team, các pattern đặc thù của codebase
Plugincài qua /plugin install <url>Anthropic Marketplace hoặc URLtái sử dụng xuyên repo, phân phối cho cộng đồng
Doanh nghiệpdo quản trị viên tổ chức đẩy xuống (cài đặt được quản lý)bắt buộc toàn tổ chứcquy trình tuân thủ bắt buộc, công cụ khóa bảo mật
Tích hợp sẵn (built-in)đi kèm Claude Codekhông áp dụngskills tài liệu (pdf, docx, pptx, xlsx), /debug, /simplify

Các skills tài liệu tích hợp sẵn rất dễ bị quên mất — Claude Code đã có sẵn các skills pdf, docx, pptx và xlsx ngay từ đầu, cùng một thư viện nhỏ gồm /debug, /simplify và các lệnh built-in tương tự. (Công cụ anh em Claude Design cũng đi kèm các skills quy trình tích hợp riêng cho việc tạo thiết kế; cùng mô hình, khác lĩnh vực.)

Khi nào thì phân phối qua plugin thay vì qua dự án? Plugin thắng thế khi cùng một quy trình mang lại lợi ích cho nhiều repo — một skill /release mà bạn dùng chung cho năm codebase khách hàng nên nằm trong plugin, chứ không phải copy-paste vào .claude/skills/ của từng repo. Skills cấp dự án phù hợp hơn cho các quy ước đặc thù của codebase (template PR của team bạn, test runner tùy chỉnh của bạn). Anthropic Marketplace, cùng với /plugin install từ bất kỳ URL nào, khiến plugin trở thành lựa chọn đúng đắn cho việc tái sử dụng xuyên repo. Theo tài liệu plugin, việc khám phá và cập nhật được xử lý tự động.

Sơ đồ kiến trúc Claude Code thể hiện bốn lớp: Skills (mẫu quy trình làm việc), MCP (mặt phẳng dữ liệu), Subagents (ủy quyền), Hooks (sự kiện). Các mũi tên cho thấy cách chúng kết hợp với nhau lúc runtime.

Các mẫu nâng cao: $ARGUMENTS, chèn Shell động, context: fork

Ba mẫu kỹ năng nâng cao quan trọng nhất: $ARGUMENTS cho phép người dùng truyền tham số vào các kỹ năng do người dùng gọi (/translate $ARGUMENTS); chèn shell động (với allowed-tools: Bash(...)) cho phép kỹ năng chạy tập lệnh và đưa kết quả vào ngữ cảnh; và context: fork (Skills 2.0) chạy kỹ năng trong một cửa sổ ngữ cảnh biệt lập. Sách trắng Hướng dẫn đầy đủ của Anthropic là tài liệu tham khảo chuẩn mực về context: fork tính đến tháng 5 năm 2026.

$ARGUMENTS cho các skill có tham số

yaml
---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---

Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.

Câu lệnh thử nghiệm: /translate spanish. Claude sẽ thay spanish vào $ARGUMENTS lúc chạy. Đây là cách gọn gàng nhất để biến một skill thành đa năng mà không cần viết nhiều biến thể.

Tiêm shell động qua allowed-tools

yaml
---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---

Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.

Skill này thực thi shell, đưa diff vào context qua pipe và xem xét nó. Hãy khóa allowed-tools vào các lệnh cụ thể (Bash(git diff HEAD~1:*)), không bao giờ dùng Bash trần — quyền Bash trần chính là phiên bản "tử huyệt bảo mật" của pattern này.

context: fork (Skills 2.0)

yaml
---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---

Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.

Forking cấp cho skill một cửa sổ ngữ cảnh (context window) riêng, nhờ đó 50K token từ các ghi chú nghiên cứu trung gian sẽ không tràn vào phiên làm việc chính của bạn. Hữu ích cho các nghiên cứu dài, lập kế hoạch refactor quy mô lớn, hoặc bất kỳ tác vụ nào tạo ra nhiều token dùng một lần. Chỉ áp dụng cho Skills 2.0, các phiên bản Claude Code cũ hơn sẽ bỏ qua trường này.

Khắc phục sự cố: Vì sao Skill của bạn không được kích hoạt

Skill thường không được kích hoạt vì một trong bốn lý do: (1) description quá chung chung khiến Claude không thể khớp với prompt của bạn, (2) thư mục bị đặt sai đường dẫn (phải là .claude/skills/ chứ không phải claude/skills/), (3) Claude Code chưa được khởi động lại sau khi thêm skill (chỉ áp dụng cho các phiên bản trước Skills-2.0), hoặc (4) tên skill bị trùng với một skill được tích hợp sẵn hoặc có độ ưu tiên cao hơn. Theo các lỗi phổ biến nhất được tìm kiếm nhiều nhất trên trình theo dõi issue GitHub của Claude Code, bốn lý do này chiếm khoảng 95% các báo cáo dạng "tại sao cái này không hoạt động".

Dạng lỗi 1: "Skill của tôi không hiển thị gì cả"

Nguyên nhân phổ biến nhất là sai đường dẫn — nhầm giữa .claude/skills/ (có dấu chấm) và claude/skills/ (không có dấu chấm) là lỗi mà ai trong chúng ta cũng từng mắc phải lúc 1 giờ sáng. Hãy chạy ls -la ~/.claude/skills/ để xác nhận thư mục tồn tại với dấu chấm. Nếu thư mục có ở đó mà Claude vẫn không nhận ra, hãy khởi động lại Claude Code một lần. Các phiên bản trước Skills 2.0 chỉ quét khi khởi động.

Dạng lỗi 2: "Claude không tự động gọi skill của tôi"

Trường description quá mơ hồ hoặc được viết cho con người đọc, chứ không phải cho Claude. Hãy viết lại bằng những cụm từ kích hoạt cụ thể, phản ánh đúng cách người dùng thực sự diễn đạt yêu cầu. Sau khi xây 4 skill cho repo này, cái bẫy mà tôi mắc phải là để nguyên những mô tả kiểu như "Một skill hữu ích cho SEO." Vô dụng. Hãy viết lại thành: "Dùng khi người dùng muốn thêm JSON-LD schema, thẻ meta hoặc SEO frontmatter vào một bài viết Markdown." Độ chính xác khi kích hoạt tăng từ ~30% lên ~95%. Độ chính xác kích hoạt sống hay chết nằm ở trường description. Hãy viết nó cho Claude, chứ không phải cho bản CV của bạn.

Dạng lỗi 3: "Mô tả bị cắt cụt trong bảng lệnh slash-command"

Hoặc description của bạn vượt quá 1024 ký tự, hoặc name vượt quá 64 ký tự. Cả hai đều có giới hạn cứng. Cách khắc phục: chia skill thành hai skill hẹp hơn, hoặc chuyển phần chi tiết dài vào nội dung SKILL.md. Frontmatter dùng để định tuyến, không phải để viết tài liệu.

Dạng lỗi 4: "Tính năng phát hiện thay đổi trực tiếp không hoạt động"

Các phiên bản Claude Code trước Skills 2.0 yêu cầu khởi động lại hoàn toàn sau bất kỳ chỉnh sửa nào đối với SKILL.md. Nếu bạn đang liên tục chỉnh sửa một skill mà các thay đổi không có hiệu lực, có thể bạn đang dùng một bản build cũ. Hoặc nâng cấp lên phiên bản Claude Code đi kèm Skills 2.0 (khám phá trực tiếp), hoặc tạo thói quen khởi động lại sau mỗi lần lưu. Hơi phiền, nhưng ít tốn kém.

Skills vượt ra ngoài Claude: Tiêu chuẩn Agent Skills mở

Đúng vậy, skills là một tiêu chuẩn mở. Tiêu chuẩn Agent Skills tại agentskills.io định nghĩa định dạng SKILL.md độc lập với bất kỳ nhà cung cấp nào. Codex CLI và ChatGPT Desktop của OpenAI đã áp dụng tiêu chuẩn này vào tháng 12 năm 2025; chính SKILL.md bạn viết cho Claude Code sẽ chạy được trong Codex với một vài chỉnh sửa nhỏ ở frontmatter.

Dưới đây là ma trận hỗ trợ đa công cụ tính đến tháng 5 năm 2026: Claude Code hỗ trợ đầy đủ Agent Skills (bản triển khai tham chiếu). Codex CLI của OpenAI hỗ trợ đầy đủ. ChatGPT Desktop hỗ trợ một phần, name, description và phần nội dung đều hoạt động, nhưng sự tương đương về allowed-tools thì vẫn chưa có. Gemini CLI đã công bố hỗ trợ vào đầu năm 2026 nhưng vẫn chưa phát hành tính đến thời điểm viết bài. Cursor là trường hợp ngoại lệ, nó sử dụng định dạng Cursor rules của riêng mình và không đọc SKILL.md một cách nguyên bản, mặc dù đã có các shim từ cộng đồng.

Những gì nên viết ngay hôm nay để skills của bạn vẫn dùng được trong năm tới: hãy giữ cho name và description gọn gàng và không phụ thuộc vào công cụ. Cô lập mọi frontmatter dành riêng cho nhà cung cấp đằng sau một namespace (claude: hoặc codex:) nếu bạn muốn dùng đa công cụ. Phần bề mặt khả chuyển, name, description, phần nội dung, $ARGUMENTS, hoạt động ở mọi nơi; các trường nâng cao như context: fork vẫn là đặc thù của Claude cho đến khi các nhà cung cấp khác phát hành phiên bản tương đương. Anthropic cũng đang thúc đẩy tích hợp marketplace sâu hơn theo lộ trình Claude Code bị rò rỉ, vì vậy khả năng tương thích sẽ chỉ ngày càng dễ dàng hơn.

Ba nơi để tìm skills mẫu: anthropics/skills (chính thức), awesome-claude-skills (cộng đồng), và agentskills.io (trang đặc tả của tiêu chuẩn). Skills không còn là một tính năng của Claude. Chúng là một tiêu chuẩn mở mà Claude đã phát hành đầu tiên.

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

Sự khác biệt giữa Claude skill và MCP server là gì?

Claude skill là một tệp SKILL.md chứa các hướng dẫn quy trình làm việc mà Claude sẽ tải khi prompt của bạn khớp với mô tả của skill đó. MCP server là một tiến trình riêng biệt mà Claude gọi để truy xuất dữ liệu trực tiếp (cơ sở dữ liệu, API, hệ thống tệp nằm ngoài thư mục làm việc). Hãy dùng Skills cho các quy trình làm việc; dùng MCP cho dữ liệu. Chúng có thể kết hợp với nhau, skill có thể gọi các công cụ MCP.

Claude skills có miễn phí không?

Có, Skills là tính năng tích hợp sẵn trong Claude Code, không tính thêm phí. Bạn chỉ trả phí cho số token mô hình tiêu thụ khi một skill chạy. Các skill bạn cài từ Anthropic Marketplace có thể mất phí (hiện tại khá hiếm), nhưng repo anthropics/skills chính thức và các awesome-list cộng đồng đều miễn phí sao chép và sử dụng.

Claude skills được cài đặt ở đâu?

Skills cá nhân được đặt trong ~/.claude/skills/{skill-name}/, skills của dự án nằm trong .claude/skills/{skill-name}/ tại thư mục gốc repo của bạn. Skills dạng plugin được cài qua /plugin install <url> và nằm trong thư mục plugin của bạn. Skills cấp doanh nghiệp được bộ phận IT của tổ chức đẩy xuống thông qua các cài đặt được quản lý. Claude Code sẽ quét cả bốn phạm vi này khi khởi động.

Làm thế nào để tạo một Claude skill từ đầu?

Hãy tạo một thư mục bên trong ~/.claude/skills/, thêm một tệp SKILL.md chứa phần frontmatter YAML (name, description) theo sau là các hướng dẫn quy trình làm việc, rồi khởi động lại Claude Code. Cách nhanh nhất: mở Claude Code và yêu cầu nó gọi skill skill-creator được tích hợp sẵn, nó sẽ dựng khung tệp SKILL.md cho bạn trong chưa đầy một phút.

Tại sao skill Claude của tôi không được kích hoạt?

Bốn nguyên nhân phổ biến nhất: (1) description quá mơ hồ để Claude có thể khớp với prompt của bạn, hãy viết lại với các cụm từ kích hoạt cụ thể; (2) skill đang ở sai đường dẫn (.claude/skills/ chứ không phải claude/skills/); (3) Claude Code cần được khởi động lại ở các phiên bản trước Skills 2.0; (4) tên skill bị trùng với một skill được tích hợp sẵn. Kiểm tra bằng ls -la ~/.claude/skills/.

ChatGPT hoặc Cursor có thể sử dụng skill của Claude không?

ChatGPT Desktop và Codex CLI hỗ trợ cùng tiêu chuẩn Agent Skills như Claude, cùng một tệp SKILL.md có thể chạy trên cả hai với một vài thay đổi nhỏ ở phần frontmatter. Cursor sử dụng định dạng Cursor rules riêng và không đọc được SKILL.md một cách nguyên bản. Gemini CLI đã công bố hỗ trợ vào đầu năm 2026 nhưng tính đến tháng 5 năm 2026 vẫn chưa được phát hành.

Skill skill-creator là gì?

skill-creator là một meta-skill được tích hợp sẵn trong repo anthropics/skills, giúp Claude viết các tệp SKILL.md mới cho bạn. Chỉ cần mô tả cho Claude biết bạn muốn skill đó làm gì; skill-creator sẽ phỏng vấn bạn để lấy thông tin mô tả, chọn các allowed-tools phù hợp và viết tệp SKILL.md vào đúng thư mục. Đây là cách dựng khung nhanh nhất có thể.

disable-model-invocation có tác dụng gì?

Việc đặt disable-model-invocation: true trong frontmatter của skill sẽ ngăn Claude tự động kích hoạt skill đó dựa trên việc khớp prompt. Khi ấy, skill chỉ có thể được gọi bởi người dùng, nó xuất hiện trong bảng lệnh slash dưới dạng /skill-name và chỉ chạy khi được gọi một cách rõ ràng. Hãy dùng nó cho các hành động có tính phá hủy hoặc tất định như /commit hay /deploy.


Hãy xây dựng một vài skill, đưa chúng vào dự án và xem cái nào phát huy hiệu quả. Nếu nhóm của bạn đang gặp phải hàng loạt rắc rối kiểu "skill không được kích hoạt" trên nhiều repo và bạn muốn có thêm người cùng xem xét thiết lập .claude/skills/ của mình, hãy liên hệ, rất sẵn lòng cùng bạn tìm hiểu.

Thẻ

claude skillsclaude codeSKILL.mdchuẩn agent skillsMCPhướng dẫn claude

Chia sẻ bài viết này

Bài viết liên quan

Thêm từ chuyên mục ai-machine-learning

ai-machine-learning
Jul 24, 2026

Claude Opus 5 Đã Ra Mắt: Trí Tuệ Gần Bằng Fable 5 Với Nửa Giá

Anthropic đã phát hành Claude Opus 5 vào ngày 24 tháng 7 năm 2026. Nó đạt điểm cao hơn gấp đôi Opus 4.8 trên Frontier-Bench và giữ nguyên mức giá của Opus, nhưng lại thua Fable 5 và Mythos 5 ở một vài bài kiểm tra. Dưới đây là bảng benchmark, mức giá và khuyến nghị nên chuyển đổi, chờ đợi hay giữ nguyên.

10 min read phút đọc
Đọc
ai-machine-learning
Jul 20, 2026

8 API Web Scraping AI Tốt Nhất Năm 2026 (Đã Kiểm Thử Trên Chính Agent Stack Của Chúng Tôi)

Chúng tôi đã kiểm thử 8 API web scraping AI với mức giá thực tế năm 2026 được kéo qua chính agent stack của mình. Firecrawl, Bright Data, ScrapingBee và 5 công cụ khác, xếp hạng theo đầu ra sẵn sàng cho LLM, khả năng vượt anti-bot và hỗ trợ MCP.

9 min read phút đọc
Đọc
ai-machine-learning
Jul 20, 2026

Kỹ thuật Prompt cho Lập trình: 7 Mẫu Chúng Tôi Dùng Hàng Ngày trong Claude Code và Cursor (2026)

Hầu hết các bài viết về 'prompt lập trình AI' chỉ đưa cho bạn 50 mẫu để sao chép. Bài này dạy 7 mẫu chúng tôi dùng mỗi ngày để vận hành quy trình Claude Code gồm 16 agent, với ví dụ thực tế trước-và-sau cho từng mẫu, cùng vị trí áp dụng từng mẫu trong Claude Code, Cursor và Copilot năm 2026.

11 min read phút đọc
Đọc
Xem tất cả bài viết
Khởi động dự án của bạn

Sẵn sàng tạo nên điều gì đó đột phá?

Hãy biến tầm nhìn của bạn thành hiện thực. Đội ngũ của chúng tôi sẵn sàng đồng hành cùng bạn tạo ra phần mềm tạo nên sự khác biệt.

Đặt lịch gọi ý tưởng 30 phútXem dự án của chúng tôi

Công cụ hot trong kho

Claude Skills

Xem tất cả
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

Tự động hoá AI

Xem tất cả
  • Security Auditor

    Weekly SCA + IaC scan with prioritized fix PRs.

  • Cold Email Writer

    Generates first-touch emails grounded in one specific public detail.

  • Lead Research Agent

    Enrich an email into a profile, score fit, alert in Slack.

Công cụ hot trong kho

Claude Skills

Xem tất cả
  • New Post

    Full SEO blog pipeline: research, brief, write, validate, image, translate, publish to Sanity. Autonomous from start to finish.

  • Content Refresh

    Audit a stale post, find decay drivers, and ship a SERP-aligned refresh without losing existing rankings.

  • SEO Audit

    Site-wide SEO audit with prioritized fix list: technical, on-page, and EEAT signals.

Tự động hoá AI

Xem tất cả
  • Security Auditor

    Weekly SCA + IaC scan with prioritized fix PRs.

  • Cold Email Writer

    Generates first-touch emails grounded in one specific public detail.

  • Lead Research Agent

    Enrich an email into a profile, score fit, alert in Slack.

Dịch vụ

  • Giải pháp doanh nghiệp
  • Ứng dụng di động
  • Ứng dụng web

Giải pháp

  • Hệ thống CRM
  • Tích hợp AI
  • Giải pháp ERP
  • Voice Agent
  • Tự động hóa quy trình
  • Bảo mật thông tin

Thư viện

  • Blog
  • Dự án

Cộng đồng

  • Tự động hoá AI
  • Claude Skills

Công cụ

  • Tính phí làm ứng dụng mobile
  • Tính phí dùng OpenAI / LLM API
  • Tính phí làm MVP
  • Tính phí làm Voice AI Agent

Công ty

  • Giới thiệu
  • Cộng sự
  • Liên hệ

Pháp lý

  • Chính sách quyền riêng tư
  • Điều khoản dịch vụ
  • Chính sách cookie

Dịch vụ

  • Giải pháp doanh nghiệp
  • Ứng dụng di động
  • Ứng dụng web

Giải pháp

  • Hệ thống CRM
  • Tích hợp AI
  • Giải pháp ERP
  • Voice Agent
  • Tự động hóa quy trình
  • Bảo mật thông tin

Thư viện

  • Blog
  • Dự án

Cộng đồng

  • Tự động hoá AI
  • Claude Skills

Công cụ

  • Tính phí làm ứng dụng mobile
  • Tính phí dùng OpenAI / LLM API
  • Tính phí làm MVP
  • Tính phí làm Voice AI Agent

Công ty

  • Giới thiệu
  • Cộng sự
  • Liên hệ
Pháp lýChính sách quyền riêng tưĐiều khoản dịch vụChính sách cookie
TECHSY
© 2026 Techsy. Bảo lưu mọi quyền.