Creating your first skill

• "Kỹ năng" là các hướng dẫn tùy chỉnh cho Claude trong Claude Code, được định nghĩa bằng tên, mô tả để khớp với lời nhắc, và các chỉ dẫn cụ thể, giúp Claude thực hiện nhiệm vụ một cách nhất quán.
• Claude Code tải siêu dữ liệu (tên và mô tả) của các kỹ năng khi khởi động, sau đó khớp các lời nhắc của người dùng với mô tả kỹ năng và yêu cầu xác nhận trước khi thực thi toàn bộ nội dung kỹ năng.
• Hệ thống ưu tiên (Doanh nghiệp > Cá nhân > Dự án > Plugin) giải quyết xung đột tên kỹ năng, cho phép các tổ chức duy trì tiêu chuẩn trong khi vẫn hỗ trợ người dùng tùy chỉnh với các tên kỹ năng khác biệt.

• Để tạo một kỹ năng, hãy tạo một thư mục riêng biệt (ví dụ: skills/tên_kỹ_năng_của_bạn) trong thư mục gốc của bạn và đặt tệp skill.md bên trong.
• Tệp skill.md phải bao gồm tên kỹ năng, mô tả (làm tiêu chí khớp cho Claude), và các hướng dẫn thực hiện (sau hai dấu gạch ngang --).
• Luôn khởi động lại phiên làm việc của Claude Code sau khi tạo hoặc chỉnh sửa kỹ năng để các thay đổi có hiệu lực.
• Khi bạn gửi một lời nhắc, Claude sẽ so sánh nó với mô tả của các kỹ năng có sẵn và yêu cầu bạn xác nhận việc tải kỹ năng đó trước khi xử lý.
• Nắm rõ thứ tự ưu tiên của kỹ năng: Doanh nghiệp (cao nhất) > Cá nhân > Dự án > Plugin (thấp nhất) để quản lý xung đột tên.
• Để tránh xung đột tên, hãy sử dụng các tên kỹ năng cụ thể và mô tả chi tiết, ví dụ: "kiểm tra PR front-end" thay vì chỉ "review".
• Cập nhật kỹ năng bằng cách chỉnh sửa trực tiếp tệp skill.md và xóa kỹ năng bằng cách xóa thư mục chứa nó, sau đó khởi động lại Claude Code.

• kỹ năng — skill
• Claude Code — Claude Code (an IDE/platform)
• lời nhắc — prompt (user input to AI)
• phiên làm việc — session (e.g., an IDE session)
• ngữ cảnh — context (for AI understanding)
• mô tả PR — PR description (Pull Request description)
• bản diff — diff (changes between files)
• doanh nghiệp — enterprise (highest priority skill category)
• tiêu chí khớp — matching criteria (for skill selection)

Giới thiệu và Tạo Kỹ năng Cá nhân

Để tạo một kỹ năng, chúng ta sẽ hướng dẫn Claude cách giải thích mã nguồn bằng cách sử dụng sơ đồ trực quan và các phép tương tự. Sau đó, chúng ta sẽ tìm hiểu cơ chế hoạt động bên trong khi Claude áp dụng kỹ năng này.

Đầu tiên, hãy tạo một thư mục cho kỹ năng của bạn. Chúng ta sẽ tạo một kỹ năng cá nhân, vì vậy nó sẽ được sử dụng trong nhiều dự án và sẽ nằm trong thư mục gốc của bạn. Lưu ý rằng chúng ta đang tạo một thư mục có tên kỹ năng bên trong thư mục skills.

Bây giờ, hãy tạo kỹ năng. Tên sẽ xác định kỹ năng của bạn. Phần mô tả sẽ cho Claude biết khi nào nên sử dụng kỹ năng này – đây là tiêu chí khớp. Mọi thứ sau hai dấu gạch ngang thứ hai là các hướng dẫn mà Claude sẽ làm theo.

Claude Code tải các kỹ năng khi khởi động. Vì vậy, hãy khởi động lại phiên làm việc của bạn. Sau đó, xác minh rằng kỹ năng đã có sẵn. Bạn sẽ thấy "mô tả PR" trong danh sách.

Bây giờ, hãy kiểm tra nó. Thực hiện một số thay đổi trên một nhánh và nói: "Write a PR description for my changes" (Viết mô tả PR cho các thay đổi của tôi). Claude sau đó sẽ cho bạn thấy rằng nó đang sử dụng kỹ năng mô tả PR. Sau đó, nó sẽ kiểm tra bản diff của bạn và viết mô tả theo mẫu của bạn, với cùng một định dạng mỗi lần.

Cách Claude Code Xử lý Kỹ năng

Khi Claude Code khởi động, nó quét bốn vị trí để tìm các kỹ năng: các đường dẫn doanh nghiệp, các kỹ năng Claude cá nhân của bạn, các kỹ năng Claude của dự án, và các plugin đã cài đặt. Nó chỉ tải tên và mô tả của mỗi kỹ năng, chứ không phải toàn bộ nội dung. Điều này quan trọng cho các bước sau.

Khi bạn gửi một lời nhắc, Claude sẽ so sánh nó với mô tả các kỹ năng của bạn. Chẳng hạn, lời nhắc "Explain what this function does" (Giải thích chức năng này làm gì) có thể khớp với một kỹ năng được mô tả là "explain code with visual diagrams" (giải thích mã bằng sơ đồ trực quan) vì ý định của chúng trùng lặp. Sau đó, Claude sẽ yêu cầu bạn xác nhận việc tải kỹ năng đó. Bước xác nhận này giúp bạn biết được ngữ cảnh mà Claude đang sử dụng. Sau khi bạn xác nhận, Claude sẽ đọc toàn bộ tệp và làm theo hướng dẫn của nó.

Xử lý Xung đột và Độ ưu tiên của Kỹ năng

Giả sử bạn sao chép một kho lưu trữ Git và có một kỹ năng với tên trùng lặp. Vậy kỹ năng nào sẽ được ưu tiên? Dưới đây là danh sách ưu tiên:

1. Doanh nghiệp: Có độ ưu tiên cao nhất, nằm trong cài đặt quản lý.
2. Cá nhân: Nằm trong cấu hình thư mục gốc của bạn, giống như cách chúng ta đang thực hiện.
3. Dự án: Nằm trong thư mục claw bên trong kho lưu trữ của bạn.
4. Plugin: Có độ ưu tiên thấp nhất, nơi bạn lưu trữ các plugin tải từ internet.

Điều này cho phép các tổ chức thực thi các tiêu chuẩn trong khi vẫn cho phép cá nhân tùy chỉnh thông qua các kỹ năng được đặt tên khác nhau. Nếu công ty bạn có một kỹ năng kiểm tra mã doanh nghiệp và bạn tạo một kỹ năng kiểm tra mã cá nhân, phiên bản doanh nghiệp sẽ được ưu tiên. Để tránh xung đột, hãy sử dụng các tên mô tả chi tiết. Thay vì "review" (kiểm tra), hãy sử dụng "kiểm tra PR front-end" hoặc "kiểm tra bảo mật".

Cập nhật, Xóa và Tóm tắt Kỹ năng

Để cập nhật một kỹ năng, chỉ cần chỉnh sửa tệp skill.md của nó. Rất đơn giản. Để xóa một kỹ năng, hãy xóa thư mục chứa nó. Khởi động lại Claude Code sau khi thực hiện các thay đổi để chúng có hiệu lực.

Tóm lại, việc tạo một kỹ năng có nghĩa là tạo một thư mục chứa tệp skill.md bao gồm siêu dữ liệu và hướng dẫn. Claude tải tên và mô tả kỹ năng khi khởi động, so sánh các lời nhắc đến với các mô tả đó và yêu cầu xác nhận trước khi tải toàn bộ nội dung. Các quy tắc ưu tiên xử lý xung đột tên là: doanh nghiệp ghi đè cá nhân, cá nhân ghi đè dự án, và dự án ghi đè plugin. Để cập nhật một kỹ năng, hãy chỉnh sửa tệp skill.md và khởi động lại Claude Code để các thay đổi có hiệu lực.