Biến tài liệu thành SKILL.md

Công cụ viết ra những gì

Một kỹ năng là một thư mục với một tệp bắt buộc, SKILL.md. Tệp bắt đầu bằng một khối YAML ngắn (frontmatter), tiếp theo là phần hướng dẫn của bạn bằng Markdown. Định dạng mở Agent Skills yêu cầu hai trường trong khối đó:

• name: từ 1 đến 64 ký tự, gồm chữ thường, chữ số và dấu gạch nối, không bắt đầu hay kết thúc bằng dấu gạch nối và không có hai dấu gạch nối liền nhau. Tên phải trùng với tên thư mục.
• description: từ 1 đến 1.024 ký tự, nói kỹ năng làm gì và khi nào nên dùng.

Công cụ tạo tên từ tiêu đề đầu tiên của tài liệu, soạn mô tả từ câu đầu tiên, làm gọn các dấu đầu dòng và thêm tiêu đề nếu tài liệu chưa có. Bạn sửa được cả hai trường; tệp cập nhật ngay khi bạn gõ. Quy tắc riêng của Anthropic thêm hai điều: tên không được chứa "anthropic" hay "claude", và không trường nào được chứa thẻ XML. Công cụ kiểm tra cả hai.

Đặt tệp ở đâu

• Claude (web và máy tính): vào Customize > Skills, nhấp vào +, rồi Create skill > Upload a skill, và chọn tệp .zip. Tệp này chứa thư mục có SKILL.md bên trong, đúng dạng Claude yêu cầu. Tính năng thực thi mã (code execution) phải đang bật.
• Claude Code: giải nén vào ~/.claude/skills/ để dùng cho riêng bạn, hoặc vào .claude/skills/ trong một repo cho mọi người clone repo đó.
• Codex, Cursor, OpenCode: mỗi công cụ đọc thư mục kỹ năng từ một vị trí riêng; hướng dẫn đồng bộ liệt kê các vị trí đó.

Mỗi bản bạn tự tay đặt vào là một bản ai đó phải tự tay cập nhật. Đó là việc AI Skill Pod làm thay bạn.

Viết mô tả để AI biết khi nào dùng

AI chỉ thấy tên và mô tả của từng kỹ năng cho đến khi có một kỹ năng khớp với yêu cầu, nên mô tả quyết định kỹ năng của bạn có bao giờ được mở hay không. Ba thói quen giúp ích:

• Bắt đầu bằng việc kỹ năng làm: "Soạn thư trả lời yêu cầu hoàn tiền theo giọng văn hỗ trợ của chúng tôi."
• Rồi nói khi nào: "Dùng khi khách hàng yêu cầu hoàn tiền, trả hàng hoặc bồi hoàn (chargeback)."
• Nêu những từ mọi người hay gõ: tên sản phẩm, loại tệp, thuật ngữ riêng của nhóm.