@momo-kits/native-kits 0.157.1-debug → 0.157.1-skill.1-debug

package/building-skill-for-claude.md

@@ -0,0 +1,1190 @@
+# Hướng Dẫn Toàn Diện Xây Dựng Skills Cho Claude
+
+---
+
+## Mục lục
+
+- [Giới thiệu](#giới-thiệu)
+- [Cơ bản](#chương-1-cơ-bản)
+- [Lập kế hoạch và thiết kế](#chương-2-lập-kế-hoạch-và-thiết-kế)
+- [Kiểm thử và cải tiến](#chương-3-kiểm-thử-và-cải-tiến)
+- [Phân phối và chia sẻ](#chương-4-phân-phối-và-chia-sẻ)
+- [Các mẫu và xử lý sự cố](#chương-5-các-mẫu-và-xử-lý-sự-cố)
+- [Tài nguyên và tham khảo](#chương-6-tài-nguyên-và-tham-khảo)
+
+---
+
+## Giới thiệu
+
+Một skill là một bộ hướng dẫn - được đóng gói thành một thư mục đơn giản - dạy cho Claude cách xử lý các tác vụ hoặc quy trình cụ thể. Skills là một trong những cách mạnh mẽ nhất để tùy chỉnh Claude cho nhu cầu cụ thể của bạn. Thay vì phải giải thích lại sở thích, quy trình và chuyên môn của bạn trong mỗi cuộc trò chuyện, skills cho phép bạn dạy Claude một lần và hưởng lợi mỗi khi sử dụng.
+
+Skills đặc biệt mạnh mẽ khi bạn có các quy trình có thể lặp lại: tạo thiết kế frontend từ spec, thực hiện nghiên cứu với phương pháp nhất quán, tạo tài liệu theo style guide của team, hoặc điều phối các quy trình nhiều bước. Chúng hoạt động tốt với các khả năng tích hợp sẵn của Claude như thực thi code và tạo tài liệu. Đối với những người xây dựng tích hợp MCP, skills bổ sung thêm một lớp mạnh mẽ giúp chuyển đổi quyền truy cập công cụ thô thành các quy trình đáng tin cậy và được tối ưu hóa.
+
+Hướng dẫn này bao gồm mọi thứ bạn cần biết để xây dựng skills hiệu quả - từ lập kế hoạch và cấu trúc đến kiểm thử và phân phối. Cho dù bạn đang xây dựng skill cho bản thân, team hay cộng đồng, bạn sẽ tìm thấy các mẫu thực tế và ví dụ thực tế xuyên suốt.
+
+**Bạn sẽ học được:**
+
+- Yêu cầu kỹ thuật và best practices cho cấu trúc skill
+- Các mẫu cho skills độc lập và quy trình làm việc nâng cao với MCP
+- Các mẫu chúng tôi đã thấy hoạt động tốt trong các trường hợp sử dụng khác nhau
+- Cách kiểm thử, cải tiến và phân phối skills của bạn
+
+**Đối tượng:**
+
+- Developers muốn Claude tuân theo các quy trình cụ thể một cách nhất quán
+- Power users muốn Claude tuân theo các quy trình cụ thể
+- Teams muốn chuẩn hóa cách Claude hoạt động trong tổ chức
+
+### Hai Con Đường Qua Hướng Dẫn Này
+
+Xây dựng skills độc lập? Tập trung vào **Cơ bản**, **Lập kế hoạch và Thiết kế**, và mục 1-2. Nâng cao tích hợp MCP? Phần "Skills + MCP" và mục 3 dành cho bạn. Cả hai con đường đều chia sẻ cùng yêu cầu kỹ thuật, nhưng bạn chọn những gì phù hợp với trường hợp sử dụng của mình.
+
+**Bạn sẽ nhận được gì từ hướng dẫn này:** Đến cuối, bạn sẽ có thể xây dựng một skill hoạt động trong một buổi. Dự kiến khoảng 15-30 phút để xây dựng và kiểm thử skill đầu tiên của bạn bằng skill-creator.
+
+---
+
+## Chương 1: Cơ Bản
+
+### Skill là gì?
+
+Một skill là một thư mục chứa:
+
+- **SKILL.md** (bắt buộc): Hướng dẫn bằng Markdown với YAML frontmatter
+- **scripts/** (tùy chọn): Code thực được (Python, Bash, v.v.)
+- **references/** (tùy chọn): Tài liệu được tải khi cần
+- **assets/** (tùy chọn): Templates, fonts, icons được sử dụng trong output
+
+### Nguyên tắc thiết kế cốt lõi
+
+#### Hiển thị Tăng dần (Progressive Disclosure)
+
+Skills sử dụng hệ thống ba cấp độ:
+
+- **Cấp độ 1** (YAML frontmatter): Luôn được tải vào system prompt của Claude. Cung cấp đủ thông tin để Claude biết khi nào mỗi skill nên được sử dụng mà không cần tải tất cả vào context.
+- **Cấp độ 2** (Phần body của SKILL.md): Được tải khi Claude nghĩ rằng skill liên quan đến tác vụ hiện tại. Chứa hướng dẫn đầy đủ.
+- **Cấp độ 3** (Các file liên kết): Các file bổ sung được đóng gói trong thư mục skill mà Claude có thể chọn để điều hướng và khám phá khi cần.
+
+Việc hiển thị tăng dần này giúp giảm thiểu token usage trong khi vẫn duy trì chuyên môn chuyên sâu.
+
+#### Khả năng Kết hợp (Composability)
+
+Claude có thể tải nhiều skills cùng lúc. Skill của bạn nên hoạt động tốt cùng với các skill khác, không giả định đó là khả năng duy nhất.
+
+#### Khả năng Di chuyển (Portability)
+
+Skills hoạt động giống nhau trên Claude.ai, Claude Code và API. Tạo skill một lần và nó hoạt động trên tất cả các nền tảng mà không cần sửa đổi, miễn là môi trường hỗ trợ các dependencies mà skill yêu cầu.
+
+### Dành cho MCP Builders: Skills + Connectors
+
+> 💡 **Lưu ý:** Xây dựng skills độc lập mà không có MCP? Bỏ qua phần này và đến phần **Lập kế hoạch và Thiết kế** - bạn có thể quay lại sau.
+
+Nếu bạn đã có một MCP server hoạt động, bạn đã làm phần khó nhất. Skills là lớp knowledge bên trên - nắm bắt các quy trình và best practices mà bạn đã biết, để Claude có thể áp dụng chúng một cách nhất quán.
+
+#### Analogy về nhà bếp
+
+- **MCP** cung cấp nhà bếp chuyên nghiệp: quyền truy cập công cụ, nguyên liệu và thiết bị.
+- **Skills** cung cấp công thức nấu ăn: hướng dẫn từng bước về cách tạo ra thứ có giá trị.
+
+Cùng nhau, chúng cho phép người dùng hoàn thành các tác vụ phức tạp mà không cần tự mình tìm ra từng bước.
+
+#### Cách chúng hoạt động cùng nhau
+
+| MCP (Kết nối) | Skills (Kiến thức) |
+|---------------|-------------------|
+| Kết nối Claude với dịch vụ của bạn (Notion, Asana, Linear, v.v.) | Dạy Claude cách sử dụng dịch vụ của bạn một cách hiệu quả |
+| Cung cấp truy cập dữ liệu thời gian thực và gọi công cụ | Nắm bắt các quy trình và best practices |
+| **Điều Claude CÓ THỂ làm** | **Điều Claude NÊN làm** |
+
+#### Tại sao điều này quan trọng cho người dùng MCP của bạn
+
+**Không có skills:**
+- Người dùng kết nối MCP của bạn nhưng không biết phải làm gì tiếp
+- Ticket hỏi "làm thế nào để làm X với tích hợp của bạn"
+- Mỗi cuộc trò chuyện bắt đầu từ đầu
+- Kết quả không nhất quán vì người dùng prompt khác nhau mỗi lần
+- Người dùng đổ lỗi cho connector khi vấn đề thực sự là hướng dẫn quy trình
+
+**Với skills:**
+- Quy trình được xây dựng sẵn tự động kích hoạt khi cần
+- Sử dụng công cụ nhất quán và đáng tin cậy
+- Best practices được nhúng trong mỗi tương tác
+- Đường cong học tập thấp hơn cho tích hợp của bạn
+
+---
+
+## Chương 2: Lập Kế Hoạch và Thiết Kế
+
+### Bắt đầu với các trường hợp sử dụng
+
+Trước khi viết bất kỳ code nào, xác định 2-3 trường hợp sử dụng cụ thể mà skill của bạn nên hỗ trợ.
+
+**Định nghĩa trường hợp sử dụng tốt:**
+
+```
+Trường hợp sử dụng: Lập kế hoạch Sprint Dự án
+Kích hoạt: Người dùng nói "giúp tôi lập kế hoạch sprint này" hoặc "tạo task sprint"
+
+Các bước:
+1. Lấy trạng thái dự án hiện tại từ Linear (qua MCP)
+2. Phân tích velocity và capacity của team
+3. Đề xuất ưu tiên task
+4. Tạo task trong Linear với labels và estimates phù hợp
+
+Kết quả: Sprint đã lập kế hoạch đầy đủ với các task đã tạo
+```
+
+**Tự hỏi bản thân:**
+- Người dùng muốn đạt được gì?
+- Quy trình nhiều bước nào được yêu cầu?
+- Công cụ nào cần thiết (built-in hay MCP?)
+- Kiến thức domain hoặc best practices nào nên được nhúng?
+
+### Các danh mục trường hợp sử dụng skill phổ biến
+
+Tại Anthropic, chúng tôi đã quan sát ba trường hợp sử dụng phổ biến:
+
+#### Danh mục 1: Tạo Tài liệu & Tài sản
+
+**Sử dụng cho:** Tạo output nhất quán và chất lượng cao bao gồm tài liệu, presentations, apps, designs, code, v.v.
+
+**Ví dụ thực tế:** frontend-design skill (xem thêm skills cho docx, pptx, xlsx, và ppt)
+
+> "Tạo giao diện frontend production-grade với chất lượng thiết kế cao. Sử dụng khi xây dựng web components, pages, artifacts, posters, hoặc applications."
+
+**Kỹ thuật chính:**
+- Style guides và brand standards được nhúng
+- Cấu trúc template cho output nhất quán
+- Quality checklists trước khi hoàn thiện
+- Không cần công cụ bên ngoài - sử dụng khả năng built-in của Claude
+
+#### Danh mục 2: Tự động hóa Quy trình
+
+**Sử dụng cho:** Các quy trình nhiều bước được hưởng lợi từ phương pháp nhất quán, bao gồm điều phối qua nhiều MCP servers.
+
+**Ví dụ thực tế:** skill-creator skill
+
+> "Hướng dẫn tương tác để tạo skills mới. Dẫn dắt người dùng qua định nghĩa trường hợp sử dụng, tạo frontmatter, viết hướng dẫn và validation."
+
+**Kỹ thuật chính:**
+- Quy trình từng bước với các cổng validation
+- Templates cho các cấu trúc phổ biến
+- Đề xuất review và cải tiến được tích hợp
+- Vòng lặp cải tiến lặp lại
+
+#### Danh mục 3: Nâng cao MCP
+
+**Sử dụng cho:** Hướng dẫn quy trình để nâng cao quyền truy cập công cụ mà một MCP server cung cấp.
+
+**Ví dụ thực tế:** sentry-code-review skill (từ Sentry)
+
+> "Tự động phân tích và sửa lỗi được phát hiện trong GitHub Pull Requests sử dụng dữ liệu giám sát lỗi của Sentry qua MCP server của họ."
+
+**Kỹ thuật chính:**
+- Điều phối nhiều lệnh gọi MCP theo trình tự
+- Nhúng chuyên môn domain
+- Cung cấp context mà người dùng otherwise cần chỉ định
+- Xử lý lỗi cho các vấn đề MCP phổ biến
+
+### Định nghĩa tiêu chí thành công
+
+Làm thế nào để biết skill của bạn đang hoạt động?
+
+Đây là các mục tiêu mang tính lý tưởng - các điểm benchmark gần đúng hơn là ngưỡng chính xác. Hướng tới sự nghiêm ngặt nhưng chấp nhận rằng sẽ có yếu tố đánh giá dựa trên cảm tính. Chúng tôi đang phát triển hướng dẫn đo lường và công cụ mạnh mẽ hơn.
+
+#### Metrics định lượng:
+
+- **Skill kích hoạt trên 90% các truy vấn liên quan**
+  - Cách đo: Chạy 10-20 truy vấn test nên kích hoạt skill. Theo dõi bao nhiêu lần nó tự động tải so với yêu cầu gọi rõ ràng.
+- **Hoàn thành quy trình trong X lệnh gọi công cụ**
+  - Cách đo: So sánh cùng một tác vụ có và không có skill. Đếm số lệnh gọi công cụ và tổng tokens tiêu thụ.
+- **0 lệnh gọi API thất bại mỗi quy trình**
+  - Cách đo: Theo dõi logs của MCP server trong các lần chạy test. Theo dõi tỷ lệ thử lại và mã lỗi.
+
+#### Metrics định tính:
+
+- **Người dùng không cần prompt Claude về các bước tiếp theo**
+  - Cách đánh giá: Trong quá trình test, chú ý tần suất bạn cần điều hướng hoặc làm rõ. Xin phản hồi từ người dùng beta.
+- **Quy trình hoàn thành không cần người dùng sửa**
+  - Cách đánh giá: Chạy cùng yêu cầu 3-5 lần. So sánh output về tính nhất quán cấu trúc và chất lượng.
+- **Kết quả nhất quán giữa các phiên**
+  - Cách đánh giá: Người dùng mới có thể hoàn thành tác vụ trong lần thử đầu tiên với hướng dẫn tối thiểu?
+
+### Yêu cầu Kỹ thuật
+
+#### Cấu trúc File
+
+```
+your-skill-name/
+├── SKILL.md              # Bắt buộc - file skill chính
+├── scripts/              # Tùy chọn - code thực thi
+│   ├── process_data.py   # Ví dụ
+│   └── validate.sh       # Ví dụ
+├── references/           # Tùy chọn - tài liệu
+│   ├── api-guide.md      # Ví dụ
+│   └── examples/         # Ví dụ
+└── assets/               # Tùy chọn - templates, v.v.
+    └── report-template.md # Ví dụ
+```
+
+#### Quy tắc quan trọng
+
+**Đặt tên SKILL.md:**
+- Phải chính xác là `SKILL.md` (phân biệt hoa thường)
+- Không chấp nhận các biến thể (SKILL.MD, skill.md, v.v.)
+
+**Đặt tên thư mục skill:**
+- Sử dụng kebab-case: `notion-project-setup` ✅
+- Không có dấu cách: `Notion Project Setup` ❌
+- Không có dấu gạch dưới: `notion_project_setup` ❌
+- Không có viết hoa: `NotionProjectSetup` ❌
+
+**Không có README.md:**
+- Không bao gồm README.md trong thư mục skill của bạn
+- Tất cả tài liệu đi vào SKILL.md hoặc references/
+- Lưu ý: khi phân phối qua GitHub, bạn vẫn muốn có README.md ở cấp repo cho người dùng — xem phần Phân phối và Chia sẻ.
+
+### YAML frontmatter: Phần quan trọng nhất
+
+YAML frontmatter là cách Claude quyết định có tải skill của bạn hay không. Làm điều này đúng.
+
+#### Định dạng tối thiểu bắt buộc
+
+```yaml
+---
+name: your-skill-name
+description: What it does. Use when user asks to [specific phrases].
+---
+```
+
+Đó là tất cả những gì bạn cần để bắt đầu.
+
+#### Yêu cầu trường
+
+**name** (bắt buộc):
+- Chỉ sử dụng kebab-case
+- Không có dấu cách hoặc viết hoa
+- Nên khớp với tên thư mục
+
+**description** (bắt buộc):
+- PHẢI bao gồm CẢ HAI:
+  - Skill làm gì
+  - Khi nào sử dụng nó (điều kiện kích hoạt)
+- Dưới 1024 ký tự
+- Không có thẻ XML (`<` hoặc `>`)
+- Bao gồm các cụm từ cụ thể mà người dùng có thể nói
+- Đề cập các loại file nếu liên quan
+
+**license** (tùy chọn):
+- Sử dụng nếu làm skill open source
+- Phổ biến: MIT, Apache-2.0
+
+**compatibility** (tùy chọn)
+- 1-500 ký tự
+- Cho biết yêu cầu môi trường: ví dụ sản phẩm dự định, gói hệ thống cần thiết, nhu cầu truy cập mạng, v.v.
+
+**metadata** (tùy chọn):
+- Bất kỳ cặp key-value tùy chỉnh nào
+- Đề xuất: author, version, mcp-server
+- Ví dụ:
+```yaml
+metadata:
+  author: ProjectHub
+  version: 1.0.0
+  mcp-server: projecthub
+```
+
+#### Hạn chế bảo mật
+
+**Cấm trong frontmatter:**
+- Dấu ngoặc góc XML (`<` `>`)
+- Skills có "claude" hoặc "anthropic" trong tên (đã đặt trước)
+
+Tại sao: Frontmatter xuất hiện trong system prompt của Claude. Nội dung độc hại có thể inject hướng dẫn.
+
+### Viết Skills Hiệu quả
+
+#### Trường description
+
+Theo blog kỹ thuật của Anthropic: "Metadata này...cung cấp đủ thông tin để Claude biết khi nào mỗi skill nên được sử dụng mà không cần tải tất cả vào context." Đây là cấp độ đầu tiên của progressive disclosure.
+
+**Cấu trúc:**
+[Skill làm gì] + [Khi nào sử dụng] + [Khả năng chính]
+
+**Ví dụ mô tả tốt:**
+
+```yaml
+# Tốt - cụ thể và có thể hành động
+description: Analyzes Figma design files and generates
+developer handoff documentation. Use when user uploads .fig
+files, asks for "design specs", "component documentation", or
+"design-to-code handoff".
+
+# Tốt - bao gồm cụm từ kích hoạt
+description: Manages Linear project workflows including sprint
+planning, task creation, and status tracking. Use when user
+mentions "sprint", "Linear tasks", "project planning", or asks
+to "create tickets".
+
+# Tốt - đề xuất giá trị rõ ràng
+description: End-to-end customer onboarding workflow for
+PayFlow. Handles account creation, payment setup, and
+subscription management. Use when user says "onboard new
+customer", "set up subscription", or "create PayFlow account".
+```
+
+**Ví dụ mô tả xấu:**
+
+```yaml
+# Quá mơ hồ
+description: Helps with projects.
+
+# Thiếu điều kích hoạt
+description: Creates sophisticated multi-page documentation
+systems.
+
+# Quá kỹ thuật, không có trigger cho người dùng
+description: Implements the Project entity model with
+hierarchical relationships.
+```
+
+#### Viết hướng dẫn chính
+
+Sau frontmatter, viết hướng dẫn thực tế bằng Markdown.
+
+**Cấu trúc được khuyến nghị:**
+
+```markdown
+---
+name: your-skill
+description: [Mô tả.]
+---
+
+# Your Skill Name
+
+## Hướng dẫn
+
+### Bước 1: [Bước Chính Đầu Tiên]
+Giải thích rõ ràng điều gì xảy ra.
+
+Ví dụ:
+```bash
+python scripts/fetch_data.py --project-id PROJECT_ID
+```
+Kết quả mong đợi: [mô tả thành công như thế nào]
+```
+
+(Thêm nhiều bước khi cần)
+
+### Ví dụ
+
+**Ví dụ 1:** [Kịch bản phổ biến]
+- Người dùng nói: "Set up a new marketing campaign"
+- Hành động:
+  1. Fetch existing campaigns via MCP
+  2. Create new campaign with provided parameters
+- Kết quả: Campaign created with confirmation link
+
+(Thêm nhiều ví dụ khi cần)
+
+### Xử lý sự cố
+
+**Lỗi:** [Thông báo lỗi phổ biến]
+- Nguyên nhân: [Tại sao nó xảy ra]
+- Giải pháp: [Cách sửa]
+
+(Thêm nhiều trường hợp lỗi khi cần)
+
+### Best Practices cho Hướng dẫn
+
+#### Cụ thể và Có thể hành động
+
+✅ **Tốt:**
+```
+Run `python scripts/validate.py --input {filename}` to check
+data format.
+
+If validation fails, common issues include:
+- Missing required fields (add them to the CSV)
+- Invalid date formats (use YYYY-MM-DD)
+```
+
+❌ **Xấu:**
+```
+Validate the data before proceeding.
+```
+
+#### Bao gồm xử lý lỗi
+
+```markdown
+### Vấn đề Phổ biến
+
+#### MCP Connection Failed
+If you see "Connection refused":
+1. Verify MCP server is running: Check Settings > Extensions
+2. Confirm API key is valid
+3. Try reconnecting: Settings > Extensions > [Your Service] > Reconnect
+```
+
+#### Tham chiếu tài nguyên được đóng gói rõ ràng
+
+```
+Before writing queries, consult `references/api-patterns.md` for:
+- Rate limiting guidance
+- Pagination patterns
+- Error codes and handling
+```
+
+#### Sử dụng Progressive Disclosure
+
+Giữ SKILL.md tập trung vào hướng dẫn cốt lõi. Di chuyển tài liệu chi tiết vào `references/` và liên kết đến nó. (Xem Nguyên tắc Thiết kế Cốt lõi để biết cách hệ thống ba cấp độ hoạt động.)
+
+---
+
+## Chương 3: Kiểm Thử và Cải Tiến
+
+Skills có thể được kiểm thử ở các mức độ nghiêm ngặt khác nhau tùy thuộc vào nhu cầu của bạn:
+
+- **Kiểm thử thủ công trong Claude.ai** - Chạy truy vấn trực tiếp và quan sát hành vi. Iteration nhanh, không cần thiết lập.
+- **Kiểm thử có script trong Claude Code** - Tự động hóa các test cases để validation có thể lặp lại qua các thay đổi.
+- **Kiểm thử lập trình qua Skills API** - Xây dựng bộ đánh giá chạy có hệ thống với các test sets đã định nghĩa.
+
+Chọn cách tiếp cận phù hợp với yêu cầu chất lượng và mức độ hiển thị của skill. Skill được sử dụng nội bộ bởi một team nhỏ có nhu cầu kiểm thử khác với skill được triển khai cho hàng nghìn người dùng doanh nghiệp.
+
+> **Pro Tip:** Iteration trên một tác vụ trước khi mở rộng
+>
+> Chúng tôi nhận thấy những người tạo skill hiệu quả nhất iteration trên một tác vụ khó cho đến khi Claude thành công, sau đó trích xuất cách tiếp cận chiến thắng vào một skill. Điều này tận dụng in-context learning của Claude và cung cấp signal nhanh hơn so với kiểm thử rộng. Khi đã có nền tảng hoạt động, mở rộng sang nhiều test cases để coverage.
+
+### Phương pháp Kiểm thử Được khuyến nghị
+
+Dựa trên kinh nghiệm ban đầu, kiểm thử skills hiệu quả thường bao gồm ba lĩnh vực:
+
+#### 1. Kiểm tra Kích hoạt
+
+**Mục tiêu:** Đảm bảo skill của bạn tải vào đúng lúc.
+
+**Test cases:**
+- ✅ Kích hoạt trên các tác vụ rõ ràng
+- ✅ Kích hoạt trên các yêu cầu được diễn giải lại
+- ❌ Không kích hoạt trên các chủ đề không liên quan
+
+**Ví dụ test suite:**
+
+*Nên kích hoạt:*
+- "Help me set up a new ProjectHub workspace"
+- "I need to create a project in ProjectHub"
+- "Initialize a ProjectHub project for Q4 planning"
+
+*Không nên kích hoạt:*
+- "What's the weather in San Francisco?"
+- "Help me write Python code"
+- "Create a spreadsheet" (trừ khi ProjectHub skill xử lý sheets)
+
+#### 2. Kiểm tra Chức năng
+
+**Mục tiêu:** Xác minh skill tạo ra output đúng.
+
+**Test cases:**
+- Output hợp lệ được tạo
+- Lệnh gọi API thành công
+- Xử lý lỗi hoạt động
+- Edge cases được cover
+
+**Ví dụ:**
+
+```
+Test: Create project with 5 tasks
+Given: Project name "Q4 Planning", 5 task descriptions
+When: Skill executes workflow
+Then:
+  - Project created in ProjectHub
+  - 5 tasks created with correct properties
+  - All tasks linked to project
+  - No API errors
+```
+
+#### 3. So sánh Hiệu suất
+
+**Mục tiêu:** Chứng minh skill cải thiện kết quả so với baseline.
+
+Sử dụng các metrics từ phần Định nghĩa Tiêu chí Thành công. Đây là cách một so sánh có thể trông:
+
+**So sánh Baseline:**
+
+*Không có skill:*
+- Người dùng cung cấp hướng dẫn mỗi lần
+- 15 tin nhắn qua lại
+- 3 lệnh gọi API thất bại cần thử lại
+- 12,000 tokens tiêu thụ
+
+*Với skill:*
+- Thực thi quy trình tự động
+- Chỉ 2 câu hỏi làm rõ
+- 0 lệnh gọi API thất bại
+- 6,000 tokens tiêu thụ
+
+### Sử dụng skill-creator skill
+
+Skill-creator skill - có sẵn trong Claude.ai qua plugin directory hoặc tải về cho Claude Code - có thể giúp bạn xây dựng và iteration trên skills. Nếu bạn có MCP server và biết 2-3 quy trình hàng đầu của mình, bạn có thể xây dựng và kiểm thử một skill hoạt động trong một buổi - thường trong 15-30 phút.
+
+**Tạo skills:**
+- Tạo skills từ mô tả ngôn ngữ tự nhiên
+- Tạo SKILL.md đúng định dạng với frontmatter
+- Đề xuất cụm từ kích hoạt và cấu trúc
+
+**Reviewing skills:**
+- Đánh dấu các vấn đề phổ biến (mô tả mơ hồ, thiếu triggers, vấn đề cấu trúc)
+- Xác định rủi ro kích hoạt quá nhiều/quá ít
+- Đề xuất test cases dựa trên mục đích stated của skill
+
+**Cải tiến lặp lại:**
+- Sau khi sử dụng skill và gặp edge cases hoặc failures, mang những ví dụ đó quay lại skill-creator
+- Ví dụ: "Use the issues & solution identified in this chat to improve how the skill handles [specific edge case]"
+
+**Cách sử dụng:**
+```
+"Use the skill-creator skill to help me build a skill for [your use case]"
+```
+
+Lưu ý: skill-creator giúp bạn thiết kế và cải tiến skills nhưng không thực hiện automated test suites hoặc tạo kết quả đánh giá định lượng.
+
+### Iteration dựa trên phản hồi
+
+Skills là tài liệu sống. Lên kế hoạch để iteration dựa trên:
+
+**Tín hiệu kích hoạt thiếu (Undertriggering):**
+- Skill không tải khi nên tải
+- Người dùng bật thủ công
+- Câu hỏi hỗ trợ về khi nào sử dụng
+
+**Giải pháp:** Thêm chi tiết và sắc thái vào mô tả - điều này có thể bao gồm đặc biệt là các thuật ngữ kỹ thuật
+
+**Tín hiệu kích hoạt quá nhiều (Overtriggering):**
+- Skill tải cho các truy vấn không liên quan
+- Người dùng tắt nó
+- Nhầm lẫn về mục đích
+
+**Giải pháp:** Thêm negative triggers, cụ thể hơn
+
+**Vấn đề thực thi:**
+- Kết quả không nhất quán
+- Lệnh gọi API thất bại
+- Cần người dùng sửa
+
+**Giải pháp:** Cải tiến hướng dẫn, thêm xử lý lỗi
+
+---
+
+## Chương 4: Phân Phối và Chia Sẻ
+
+Skills làm cho tích hợp MCP của bạn hoàn thiện hơn. Khi người dùng so sánh connectors, những cái có skills cung cấp con đường nhanh hơn đến giá trị, mang lại cho bạn lợi thế so với các alternatives chỉ có MCP.
+
+### Mô hình phân phối hiện tại (January 2026)
+
+**Cách người dùng cá nhân nhận skills:**
+
+1. Tải thư mục skill
+2. Nén thư mục (nếu cần)
+3. Tải lên Claude.ai qua Settings > Capabilities > Skills
+4. Hoặc đặt trong thư mục skills của Claude Code
+
+**Skills cấp tổ chức:**
+- Admins có thể triển khai skills toàn workspace (ra mắt December 18, 2025)
+- Cập nhật tự động
+- Quản lý tập trung
+
+### Một tiêu chuẩn mở
+
+Chúng tôi đã công bố Agent Skills như một tiêu chuẩn mở. Giống như MCP, chúng tôi tin rằng skills nên di động giữa các công cụ và nền tảng - cùng một skill nên hoạt động cho dù bạn đang sử dụng Claude hay các nền tảng AI khác. Tuy nhiên, một số skills được thiết kế để tận dụng đầy đủ khả năng của một nền tảng cụ thể; các tác giả có thể ghi chú điều này trong trường compatibility của skill. Chúng tôi đã cộng tác với các thành viên của hệ sinh thái về tiêu chuẩn, và chúng tôi hào hứng với việc áp dụng sớm.
+
+### Sử dụng Skills qua API
+
+Cho các trường hợp sử dụng lập trình - như xây dựng ứng dụng, agents, hoặc quy trình tự động tận dụng skills - API cung cấp quyền kiểm soát trực tiếp việc quản lý và thực thi skill.
+
+**Khả năng chính:**
+- Endpoint `/v1/skills` để liệt kê và quản lý skills
+- Thêm skills vào yêu cầu Messages API qua tham số `container.skills`
+- Version control và quản lý qua Claude Console
+- Hoạt động với Claude Agent SDK để xây dựng custom agents
+
+**Khi nào sử dụng Skills qua API vs. Claude.ai:**
+
+| Trường hợp sử dụng | Nền tảng tốt nhất |
+|-------------------|-------------------|
+| Người dùng cuối tương tác trực tiếp với skills | Claude.ai / Claude Code |
+| Kiểm thử thủ công và iteration trong phát triển | Claude.ai / Claude Code |
+| Quy trình ad-hoc cá nhân | Claude.ai / Claude Code |
+| Ứng dụng sử dụng skills lập trình | API |
+| Triển khai production quy mô lớn | API |
+| Pipelines tự động và hệ thống agent | API |
+
+Lưu ý: Skills trong API yêu cầu Code Execution Tool beta, cung cấp môi trường bảo mà skills cần để chạy.
+
+Để biết chi tiết triển khai, xem:
+- Skills API Quickstart
+- Create Custom Skills
+- Skills in the Agent SDK
+
+### Phương pháp Được khuyến nghị Hôm nay
+
+Bắt đầu bằng việc host skill của bạn trên GitHub với repo công khai, README rõ ràng (cho khách truy cập - điều này tách biệt với thư mục skill của bạn, không nên chứa README.md), và ví dụ sử dụng với screenshots. Sau đó thêm một phần vào tài liệu MCP của bạn liên kết đến skill, giải thích tại sao sử dụng cả hai cùng nhau có giá trị, và cung cấp hướng dẫn bắt đầu nhanh.
+
+1. **Host trên GitHub**
+   - Repo công khai cho open-source skills
+   - README rõ ràng với hướng dẫn cài đặt
+   - Ví dụ sử dụng và screenshots
+
+2. **Tài liệu trong Repo MCP của bạn**
+   - Liên kết đến skills từ tài liệu MCP
+   - Giải thích giá trị của việc sử dụng cả hai cùng nhau
+   - Cung cấp hướng dẫn bắt đầu nhanh
+
+3. **Tạo Hướng dẫn Cài đặt**
+
+```markdown
+# Cài đặt skill [Your Service]
+
+1. Tải skill:
+   - Clone repo: `git clone https://github.com/yourcompany/skills`
+   - Hoặc tải ZIP từ Releases
+
+2. Cài đặt trong Claude:
+   - Mở Claude.ai > Settings > Skills
+   - Click "Upload skill"
+   - Chọn thư mục skill (đã nén)
+
+3. Kích hoạt skill:
+   - Bật skill [Your Service]
+   - Đảm bảo MCP server của bạn được kết nối
+
+4. Test:
+   - Hỏi Claude: "Set up a new project in [Your Service]"
+```
+
+### Định vị Skill của bạn
+
+Cách bạn mô tả skill xác định liệu người dùng có hiểu giá trị của nó và thực sự thử nó hay không. Khi viết về skill - trong README, tài liệu, hoặc marketing - giữ các nguyên tắc này trong đầu.
+
+**Tập trung vào kết quả, không phải tính năng:**
+
+✅ **Tốt:**
+> "Skill ProjectHub cho phép teams thiết lập không gian làm việc dự án hoàn chỉnh trong vài giây — bao gồm pages, databases, và templates — thay vì dành 30 phút cho thiết lập thủ công."
+
+❌ **Xấu:**
+> "Skill ProjectHub là một thư mục chứa YAML frontmatter và Markdown instructions gọi các công cụ MCP server của chúng tôi."
+
+**Nổi bật câu chuyện MCP + skills:**
+> "MCP server của chúng tôi cung cấp cho Claude quyền truy cập các dự án Linear của bạn. Skills của chúng tôi dạy Claude quy trình lập kế hoạch sprint của team bạn. Cùng nhau, chúng cho phép quản lý dự án được AI hỗ trợ."
+
+---
+
+## Chương 5: Các Mẫu và Xử Lý Sự Cố
+
+Các mẫu này xuất phát từ skills được tạo bởi những người dùng sớm và các teams nội bộ. Chúng đại diện cho các cách tiếp cận phổ biến mà chúng tôi đã thấy hoạt động tốt, không phải templates bắt buộc.
+
+### Chọn cách tiếp cận của bạn: Problem-first vs. Tool-first
+
+Hãy nghĩ về Home Depot. Bạn có thể vào với một vấn đề - "Tôi cần sửa tủ bếp" - và một nhân viên chỉ bạn đến công cụ phù hợp. Hoặc bạn có thể chọn một chiếc máy khoan mới và hỏi cách sử dụng nó cho công việc cụ thể của bạn.
+
+Skills hoạt động tương tự:
+
+- **Problem-first:** "Tôi cần thiết lập không gian làm việc dự án" → Skill của bạn điều phối các lệnh gọi MCP đúng theo đúng trình tự. Người dùng mô tả kết quả; skill xử lý công cụ.
+- **Tool-first:** "Tôi đã kết nối Notion MCP" → Skill của bạn dạy Claude các quy trình tối ưu và best practices. Người dùng có quyền truy cập; skill cung cấp chuyên môn.
+
+Hầu hết skills nghiêng về một hướng. Biết khung nào phù hợp với trường hợp sử dụng của bạn giúp bạn chọn mẫu đúng bên dưới.
+
+### Mẫu 1: Điều phối Quy trình Tuần tự
+
+**Sử dụng khi:** Người dùng cần các quy trình nhiều bước theo thứ tự cụ thể.
+
+**Cấu trúc ví dụ:**
+
+```markdown
+## Workflow: Onboard New Customer
+
+### Bước 1: Create Account
+Gọi MCP tool: `create_customer`
+Parameters: name, email, company
+
+### Bước 2: Setup Payment
+Gọi MCP tool: `setup_payment_method`
+Chờ: payment method verification
+
+### Bước 3: Create Subscription
+Gọi MCP tool: `create_subscription`
+Parameters: plan_id, customer_id (từ Bước 1)
+
+### Bước 4: Send Welcome Email
+Gọi MCP tool: `send_email`
+Template: welcome_email_template
+```
+
+**Kỹ thuật chính:**
+- Thứ tự bước rõ ràng
+- Dependencies giữa các bước
+- Validation tại mỗi giai đoạn
+- Hướng dẫn rollback cho failures
+
+### Mẫu 2: Điều phối Multi-MCP
+
+**Sử dụng khi:** Quy trình span nhiều dịch vụ.
+
+**Ví dụ:** Chuyển giao từ thiết kế sang phát triển
+
+```markdown
+### Phase 1: Design Export (Figma MCP)
+1. Export design assets từ Figma
+2. Generate design specifications
+3. Tạo asset manifest
+
+### Phase 2: Asset Storage (Drive MCP)
+1. Tạo project folder trong Drive
+2. Upload tất cả assets
+3. Generate shareable links
+
+### Phase 3: Task Creation (Linear MCP)
+1. Tạo development tasks
+2. Đính kèm asset links vào tasks
+3. Giao cho engineering team
+
+### Phase 4: Notification (Slack MCP)
+1. Post handoff summary đến #engineering
+2. Bao gồm asset links và task references
+```
+
+**Kỹ thuật chính:**
+- Phân tách phase rõ ràng
+- Truyền dữ liệu giữa các MCPs
+- Validation trước khi chuyển sang phase tiếp theo
+- Xử lý lỗi tập trung
+
+### Mẫu 3: Cải tiến Lặp lại
+
+**Sử dụng khi:** Chất lượng output được cải thiện với iteration.
+
+**Ví dụ:** Tạo báo cáo
+
+```markdown
+## Iterative Report Creation
+
+### Initial Draft
+1. Fetch data via MCP
+2. Generate first draft report
+3. Save to temporary file
+
+### Quality Check
+1. Run validation script: `scripts/check_report.py`
+2. Identify issues:
+   - Missing sections
+   - Inconsistent formatting
+   - Data validation errors
+
+### Refinement Loop
+1. Address each identified issue
+2. Regenerate affected sections
+3. Re-validate
+4. Repeat until quality threshold met
+
+### Finalization
+1. Apply final formatting
+2. Generate summary
+3. Save final version
+```
+
+**Kỹ thuật chính:**
+- Tiêu chí chất lượng rõ ràng
+- Cải tiến lặp lại
+- Validation scripts
+- Biết khi nào dừng iteration
+
+### Mẫu 4: Lựa chọn Công cụ Nhận biết Context
+
+**Sử dụng khi:** Cùng kết quả, công cụ khác nhau tùy thuộc context.
+
+**Ví dụ:** Lưu trữ file
+
+```markdown
+## Smart File Storage
+
+### Decision Tree
+1. Check file type and size
+2. Determine best storage location:
+   - Large files (>10MB): Use cloud storage MCP
+   - Collaborative docs: Use Notion/Docs MCP
+   - Code files: Use GitHub MCP
+   - Temporary files: Use local storage
+
+### Execute Storage
+Based on decision:
+- Call appropriate MCP tool
+- Apply service-specific metadata
+- Generate access link
+
+### Provide Context to User
+Explain why that storage was chosen
+```
+
+**Kỹ thuật chính:**
+- Tiêu chí quyết định rõ ràng
+- Fallback options
+- Minh bạch về các lựa chọn
+
+### Mẫu 5: Trí tuệ Domain-Specific
+
+**Sử dụng khi:** Skill của bạn bổ sung kiến thức chuyên môn vượt quá quyền truy cập công cụ.
+
+**Ví dụ:** Tuân thủ tài chính
+
+```markdown
+## Payment Processing with Compliance
+
+### Before Processing (Compliance Check)
+1. Fetch transaction details via MCP
+2. Apply compliance rules:
+   - Check sanctions lists
+   - Verify jurisdiction allowances
+   - Assess risk level
+3. Document compliance decision
+
+### Processing
+IF compliance passed:
+  - Call payment processing MCP tool
+  - Apply appropriate fraud checks
+  - Process transaction
+ELSE:
+  - Flag for review
+  - Create compliance case
+
+### Audit Trail
+- Log all compliance checks
+- Record processing decisions
+- Generate audit report
+```
+
+**Kỹ thuật chính:**
+- Chuyên môn domain được nhúng trong logic
+- Tuân thủ trước khi hành động
+- Tài liệu toàn diện
+- Quản trị rõ ràng
+
+---
+
+## Xử Lý Sự Cố
+
+### Skill không tải lên được
+
+**Lỗi:** "Could not find SKILL.md in uploaded folder"
+
+- **Nguyên nhân:** File không đặt tên chính xác SKILL.md
+- **Giải pháp:**
+  - Đổi tên thành SKILL.md (phân biệt hoa thường)
+  - Xác minh với: `ls -la` sẽ hiển thị SKILL.md
+
+**Lỗi:** "Invalid frontmatter"
+
+- **Nguyên nhân:** Vấn đề định dạng YAML
+- **Lỗi phổ biến:**
+
+```yaml
+# Sai - thiếu delimiters
+name: my-skill
+description: Does things
+
+# Sai - quotes chưa đóng
+name: my-skill
+description: "Does things
+
+# Đúng
+---
+name: my-skill
+description: Does things
+---
+```
+
+**Lỗi:** "Invalid skill name"
+
+- **Nguyên nhân:** Tên có dấu cách hoặc viết hoa
+
+```yaml
+# Sai
+name: My Cool Skill
+
+# Đúng
+name: my-cool-skill
+```
+
+### Skill không kích hoạt
+
+**Triệu chứng:** Skill không bao giờ tự động tải
+
+**Sửa:**
+Sửa trường description của bạn. Xem phần Trường Description để xem ví dụ tốt/xấu.
+
+**Checklist nhanh:**
+- Có quá mơ hồ không? ("Helps with projects" sẽ không hoạt động)
+- Có bao gồm cụm từ kích hoạt mà người dùng thực sự nói không?
+- Có đề cập các loại file liên quan nếu áp dụng không?
+
+**Cách debug:**
+Hỏi Claude: "When would you use the [skill name] skill?" Claude sẽ trích dẫn mô tả. Điều chỉnh dựa trên những gì còn thiếu.
+
+### Skill kích hoạt quá thường xuyên
+
+**Triệu chứng:** Skill tải cho các truy vấn không liên quan
+
+**Giải pháp:**
+
+1. **Thêm negative triggers**
+   ```yaml
+   description: Advanced data analysis for CSV files. Use for
+   statistical modeling, regression, clustering. Do NOT use for
+   simple data exploration (use data-viz skill instead).
+   ```
+
+2. **Cụ thể hơn**
+   ```yaml
+   # Quá rộng
+   description: Processes documents
+
+   # Cụ thể hơn
+   description: Processes PDF legal documents for contract review
+   ```
+
+3. **Làm rõ phạm vi**
+   ```yaml
+   description: PayFlow payment processing for e-commerce. Use
+   specifically for online payment workflows, not for general
+   financial queries.
+   ```
+
+### Vấn đề kết nối MCP
+
+**Triệu chứng:** Skill tải nhưng lệnh gọi MCP thất bại
+
+**Checklist:**
+
+1. **Xác minh MCP server được kết nối**
+   - Claude.ai: Settings > Extensions > [Your Service]
+   - Nên hiển thị trạng thái "Connected"
+
+2. **Kiểm tra xác thực**
+   - API keys hợp lệ và chưa hết hạn
+   - Permissions/scopes phù hợp được cấp
+   - OAuth tokens được refresh
+
+3. **Test MCP độc lập**
+   - Yêu cầu Claude gọi MCP trực tiếp (không có skill)
+   - "Use [Service] MCP to fetch my projects"
+   - Nếu thất bại, vấn đề là MCP không phải skill
+
+4. **Xác minh tên công cụ**
+   - Skill tham chiếu đúng tên MCP tool
+   - Kiểm tra tài liệu MCP server
+   - Tên công cụ phân biệt hoa thường
+
+### Hướng dẫn không được tuân theo
+
+**Triệu chứng:** Skill tải nhưng Claude không tuân theo hướng dẫn
+
+**Nguyên nhân phổ biến:**
+
+1. **Hướng dẫn quá dài**
+   - Giữ hướng dẫn ngắn gọn
+   - Sử dụng bullet points và numbered lists
+   - Di chuyển tài liệu tham chiếu chi tiết vào file riêng
+
+2. **Hướng dẫn bị chôn**
+   - Đặt hướng dẫn quan trọng ở trên cùng
+   - Sử dụng headers ## Important hoặc ## Critical
+   - Lặp lại các điểm chính nếu cần
+
+3. **Ngôn ngữ mơ hồ**
+
+```yaml
+# Xấu
+Make sure to validate things properly
+
+# Tốt
+CRITICAL: Before calling create_project, verify:
+- Project name is non-empty
+- At least one team member assigned
+- Start date is not in the past
+```
+
+> **Kỹ thuật nâng cao:** Cho các validation quan trọng, cân nhắc đóng gói một script thực hiện các kiểm tra theo chương trình thay vì dựa vào hướng dẫn bằng ngôn ngữ. Code là deterministic; việc diễn giải ngôn ngữ thì không. Xem Office skills để biết ví dụ về mẫu này.
+
+4. **Model "lười"** - Thêm khuyến khích rõ ràng:
+   ```markdown
+   ## Performance Notes
+   - Take your time to do this thoroughly
+   - Quality is more important than speed
+   - Do not skip validation steps
+   ```
+
+   Lưu ý: Thêm điều này vào user prompts hiệu quả hơn trong SKILL.md
+
+### Vấn đề Large Context
+
+**Triệu chứng:** Skill có vẻ chậm hoặc responses suy giảm
+
+**Nguyên nhân:**
+- Nội dung skill quá lớn
+- Quá nhiều skills được bật cùng lúc
+- Tất cả nội dung được tải thay vì progressive disclosure
+
+**Giải pháp:**
+
+1. **Tối ưu kích thước SKILL.md**
+   - Di chuyển tài liệu chi tiết vào references/
+   - Liên kết đến references thay vì inline
+   - Giữ SKILL.md dưới 5,000 từ
+
+2. **Giảm số skills được bật**
+   - Đánh giá nếu bạn có hơn 20-50 skills được bật cùng lúc
+   - Khuyến nghị bật chọn lọc
+   - Cân nhắc "packs" cho các khả năng liên quan
+
+---
+
+## Chương 6: Tài Nguyên và Tham Khảo
+
+Nếu bạn đang xây dựng skill đầu tiên, hãy bắt đầu với Best Practices Guide, sau đó tham khảo API docs khi cần.
+
+### Tài liệu Chính thức
+
+**Anthropic Resources:**
+- Best Practices Guide
+- Skills Documentation
+- API Reference
+- MCP Documentation
+
+**Blog Posts:**
+- Introducing Agent Skills
+- Engineering Blog: Equating Agents for the Real World
+- Skills Explained
+- How to Create Skills for Claude
+- Building Skills for Claude Code
+- Improving Frontend Design through Skills
+
+### Skills mẫu
+
+**Kho skills công khai:**
+- GitHub: anthropics/skills
+- Chứa các skills được tạo bởi Anthropic mà bạn có thể tùy chỉnh
+
+### Công cụ và Tiện ích
+
+**skill-creator skill:**
+- Được tích hợp sẵn trong Claude.ai và có sẵn cho Claude Code
+- Có thể tạo skills từ mô tả
+- Reviews và đưa ra đề xuất
+- Sử dụng: "Help me build a skill using skill-creator"
+
+**Validation:**
+- skill-creator có thể đánh giá skills của bạn
+- Hỏi: "Review this skill and suggest improvements"
+
+### Nhận Hỗ trợ
+
+**Cho câu hỏi kỹ thuật:**
+- Câu hỏi chung: Community forums tại Claude Developers Discord
+
+**Cho báo cáo lỗi:**
+- GitHub Issues: anthropics/skills/issues
+- Bao gồm: Tên skill, thông báo lỗi, các bước để tái tạo
+
+---
+
+## Phụ lục A: Checklist Nhanh
+
+Sử dụng checklist này để validate skill của bạn trước và sau khi tải lên. Nếu bạn muốn bắt đầu nhanh hơn, hãy sử dụng skill-creator skill để tạo bản nháp đầu tiên, sau đó chạy qua danh sách này để đảm bảo bạn không bỏ sót gì.
+
+**Trước khi bắt đầu**
+- [ ] Xác định 2-3 trường hợp sử dụng cụ thể
+- [ ] Xác định công cụ (built-in hoặc MCP)
+- [ ] Xem lại hướng dẫn này và ví dụ skills
+- [ ] Lên kế hoạch cấu trúc thư mục
+
+**Trong quá trình phát triển**
+- [ ] Thư mục đặt tên bằng kebab-case
+- [ ] File SKILL.md tồn tại (đúng chính tả)
+- [ ] YAML frontmatter có delimiters `---`
+- [ ] Trường name: kebab-case, không dấu cách, không viết hoa
+- [ ] Mô tả bao gồm WHAT và WHEN
+- [ ] Không có thẻ XML (`<` `>`) ở bất kỳ đâu
+- [ ] Hướng dẫn rõ ràng và có thể hành động
+- [ ] Bao gồm xử lý lỗi
+- [ ] Cung cấp ví dụ
+- [ ] References được liên kết rõ ràng
+
+**Trước khi tải lên**
+- [ ] Test kích hoạt trên các tác vụ rõ ràng
+- [ ] Test kích hoạt trên các yêu cầu được diễn giải lại
+- [ ] Xác minh không kích hoạt trên các chủ đề không liên quan
+- [ ] Functional tests pass
+- [ ] Tích hợp công cụ hoạt động (nếu áp dụng)
+- [ ] Nén thành file .zip
+
+**Sau khi tải lên**
+- [ ] Test trong các cuộc trò chuyện thực
+- [ ] Theo dõi under/over-triggering
+- [ ] Thu thập phản hồi người dùng
+- [ ] Iteration trên mô tả và hướng dẫn
+- [ ] Cập nhật version trong metadata
+
+---
+
+## Phụ lục B: YAML Frontmatter
+
+### Các trường bắt buộc
+
+```yaml
+---
+name: skill-name-in-kebab-case
+description: What it does and when to use it. Include specific
+trigger phrases.
+---
+```
+
+### Tất cả các trường tùy chọn
+
+```yaml
+name: skill-name
+description: [required description]
+license: MIT # Optional: License for open-source
+allowed-tools: "Bash(python:*) Bash(npm:*) WebFetch" # Optional: Restrict tool access
+metadata: # Optional: Custom fields
+  author: Company Name
+  version: 1.0.0
+  mcp-server: server-name
+  category: productivity
+  tags: [project-management, automation]
+  documentation: https://example.com/docs
+  support: support@example.com
+```
+
+### Ghi chú bảo mật
+
+**Cho phép:**
+- Bất kỳ loại YAML tiêu chuẩn nào (strings, numbers, booleans, lists, objects)
+- Trường metadata tùy chỉnh
+- Mô tả dài (đến 1024 ký tự)
+
+**Cấm:**
+- Dấu ngoặc góc XML (`<` `>`) - hạn chế bảo mật
+- Thực thi code trong YAML (sử dụng safe YAML parsing)
+- Skills có tên tiền tố "claude" hoặc "anthropic" (đã đặt trước)
+
+---
+
+## Phụ lục C: Ví Dụ Skills Hoàn Chỉnh
+
+Để xem các skills production-ready đầy đủ minh họa các mẫu trong hướng dẫn này:
+- **Document Skills** - Tạo PDF, DOCX, PPTX, XLSX
+- **Example Skills** - Các mẫu quy trình khác nhau
+- **Partner Skills Directory** - Xem skills từ các đối tác như Asana, Atlassian, Canva, Figma, Sentry, Zapier, và nhiều hơn nữa
+
+Các repositories này được cập nhật thường xuyên và bao gồm các ví dụ bổ sung ngoài những gì được đề cập ở đây. Clone chúng, sửa đổi cho trường hợp sử dụng của bạn, và sử dụng chúng làm templates.
+
+---
+
+*Tài liệu này được dịch từ "The Complete Guide to Building Skills for Claude" của Anthropic.*