Tạo skill đầu tiên của bạn

Hãy cùng tạo một skill từ đầu, rồi xem cách Claude Code thực sự khám phá và khớp skill đằng sau hậu trường.

Tạo một skill

Ta sẽ xây một skill cá nhân dạy Claude cách viết mô tả pull request theo một định dạng nhất quán. Vì là skill cá nhân, nó nằm trong thư mục home của bạn và hoạt động trên mọi project.

Đầu tiên, tạo một thư mục cho skill bên trong thư mục skills. Tên thư mục nên khớp với tên skill:

mkdir -p ~/.claude/skills/pr-description

Sau đó tạo một file SKILL.md bên trong thư mục đó. File có hai phần, ngăn cách bởi các dấu gạch ngang frontmatter:

---
name: pr-description
description: Writes pull request descriptions. Use when creating a PR, writing a PR, or when the user asks to summarize changes for a pull request.
---

When writing a PR description:

1. Run `git diff main...HEAD` to see all changes on this branch
2. Write a description following this format:

## What
One sentence explaining what this PR does.

## Why
Brief context on why this change is needed

## Changes
- Bullet points of specific changes made
- Group related changes together
- Mention any files deleted or renamed

name định danh skill của bạn. description cho Claude biết khi nào nên dùng nó - đây chính là tiêu chí khớp lệnh. Mọi thứ sau cặp dấu gạch ngang thứ hai là chỉ dẫn Claude tuân theo khi skill được kích hoạt.

Kiểm tra skill của bạn

Claude Code nạp skill lúc khởi động, nên hãy khởi động lại phiên sau khi tạo một skill mới. Bạn có thể xác nhận nó khả dụng bằng cách kiểm tra danh sách skill hiện có.

Bạn sẽ thấy skill của mình trong danh sách. Để kiểm tra, hãy thực hiện vài thay đổi trên một nhánh và nói điều gì đó như “viết mô tả PR cho các thay đổi của tôi”. Claude sẽ báo nó đang dùng skill pr-description, kiểm tra diff của bạn, và viết mô tả theo đúng template - cùng một định dạng mỗi lần.

Cách khớp skill hoạt động

Khi Claude Code khởi động, nó quét bốn vị trí để tìm skill, nhưng chỉ nạp tên và description - không nạp toàn bộ nội dung. Đây là chi tiết quan trọng.

Khi bạn gửi một yêu cầu, Claude so sánh tin nhắn của bạn với description của mọi skill khả dụng. Ví dụ, “giải thích hàm này làm gì” có thể khớp với một skill được mô tả là “giải thích code bằng sơ đồ trực quan”, vì ý định có sự chồng lấn.

Một khi tìm được khớp, Claude sẽ hỏi bạn xác nhận trước khi nạp skill. Bước xác nhận này giúp bạn luôn nắm được Claude đang kéo ngữ cảnh gì vào. Sau khi bạn xác nhận, Claude đọc toàn bộ file SKILL.md và làm theo chỉ dẫn trong đó.

Danh sách skill khả dụng sau khi khởi động lại phiên.

Claude hỏi xác nhận trước khi nạp toàn bộ nội dung một skill.

Thứ tự ưu tiên của skill

Nếu bạn clone một repository có một skill trùng tên với một skill cá nhân của bạn, cái nào thắng? Có một thứ tự ưu tiên rõ ràng:

1. Enterprise - cấu hình được quản lý, ưu tiên cao nhất.
2. Personal - thư mục home của bạn (~/.claude/skills).
3. Project - thư mục .claude/skills bên trong một repository.
4. Plugins - plugin đã cài, ưu tiên thấp nhất.

Thứ tự này cho phép tổ chức thực thi các quy chuẩn thông qua skill enterprise, trong khi vẫn cho phép tuỳ biến cá nhân. Nếu công ty bạn có một skill enterprise tên “code-review” và bạn tạo một skill cá nhân cùng tên, phiên bản enterprise sẽ được ưu tiên.

Để tránh xung đột, hãy dùng tên mô tả rõ ràng. Thay vì chỉ “review”, hãy dùng thứ gì đó như “frontend-review” hay “backend-review”.

Cập nhật và xoá skill

Để cập nhật một skill, chỉnh sửa file SKILL.md của nó. Để xoá một skill, xoá thư mục của nó. Hãy khởi động lại Claude Code sau bất kỳ thay đổi nào để chúng có hiệu lực.

Nguồn

Dịch từ bài giảng “Creating your first skill”, khóa Introduction to agent skills trên Claude Academy.