Xây dựng Skills cho Claude — Phần 6: Tài liệu tham khảo và Checklist hoàn chỉnh

Dịch và biên soạn từ "The Complete Guide to Building Skills for Claude" của Anthropic.

Đây là phần cuối cùng của serial. Bạn đã đi qua toàn bộ hành trình từ khái niệm cơ bản, thiết kế, testing, phân phối, đến patterns thực chiến. Phần này tổng hợp tất cả thành checklist và tài liệu tham khảo nhanh để bạn dùng hàng ngày.

Quick Checklist: Xác thực Skill

Dùng checklist này để kiểm tra skill trước và sau khi upload. Nếu muốn bắt đầu nhanh hơn, dùng skill-creator để tạo bản nháp đầu tiên, rồi chạy qua danh sách này.

Trước khi bắt đầu

• Đã xác định 2-3 use case cụ thể
• Đã xác định công cụ cần thiết (built-in hoặc MCP)
• Đã đọc hướng dẫn này và xem ví dụ skill
• Đã lên kế hoạch cấu trúc thư mục

Trong quá trình phát triển

• Tên thư mục dạng kebab-case
• File SKILL.md tồn tại (đúng chính tả, đúng hoa thường)
• YAML frontmatter có delimiter ---
• Trường name: kebab-case, không dấu cách, không viết hoa
• Trường description bao gồm CẢ "làm gì" VÀ "khi nào dùng"
• Không có thẻ XML (< >) ở bất kỳ đâu
• Instructions rõ ràng và có thể hành động
• Xử lý lỗi được bao gồm
• Ví dụ được cung cấp
• References được liên kết rõ ràng

Trước khi upload

• Đã test triggering trên các tác vụ rõ ràng
• Đã test triggering trên các yêu cầu diễn đạt khác
• Đã xác nhận không trigger trên chủ đề không liên quan
• Functional tests đạt
• Tool integration hoạt động (nếu áp dụng)
• Đã nén thành file .zip

Sau khi upload

• Test trong cuộc trò chuyện thực
• Theo dõi under/over-triggering
• Thu thập feedback người dùng
• Iterate description và instructions
• Cập nhật version trong metadata

Tham chiếu YAML Frontmatter đầy đủ

Các trường bắt buộc

---
name: skill-name-in-kebab-case
description: Mo ta skill lam gi va khi nao dung. Bao gom cac cum tu trigger cu the.
---

Tất cả các trường tuỳ chọn

---
name: skill-name
description: [mo ta bat buoc]
license: MIT                                    # Tuy chon: License ma nguon mo
allowed-tools: "Bash(python:*) Bash(npm:*) WebFetch"  # Tuy chon: Gioi han quyen truy cap
metadata:                                       # Tuy chon: Cac truong tuy chinh
  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
---

Chi tiết từng trường

Ghi chú bảo mật

Được phép

• Bất kỳ kiểu YAML chuẩn nào (strings, numbers, booleans, lists, objects)
• Các trường metadata tuỳ chỉnh
• Descriptions dài (tối đa 1024 ký tự)

Bị cấm

• Dấu ngoặc nhọn XML (< >) -- hạn chế bảo mật vì frontmatter nằm trong system prompt
• Thực thi code trong YAML -- sử dụng safe YAML parsing
• Tên skill chứa "claude" hoặc "anthropic" -- từ khoá dành riêng

Lý do: YAML frontmatter xuất hiện trong system prompt của Claude. Nội dung độc hại có thể inject các chỉ dẫn không mong muốn. Anthropic áp dụng safe YAML parsing để ngăn chặn điều này.

Ví dụ Skill hoàn chỉnh

Dưới đây là một skill mẫu hoàn chỉnh áp dụng tất cả kiến thức từ serial:

---
name: shopify-theme-review
description: Review va toi uu Shopify theme code. Kiem tra
  performance, accessibility, SEO, va Liquid best practices.
  Dung khi nguoi dung noi "review theme", "kiem tra Shopify code",
  "toi uu Liquid", hoac upload file .liquid.
license: MIT
metadata:
  author: Claude.vn
  version: 1.0.0
  category: e-commerce
  tags: [shopify, liquid, theme-review]
---

# Shopify Theme Review

## Instructions

### Buoc 1: Thu Thap Code
Yeu cau nguoi dung cung cap file hoac repo can review.
Uu tien cac file:
- layout/theme.liquid
- sections/*.liquid
- snippets/*.liquid
- assets/*.css va *.js

### Buoc 2: Kiem Tra Performance
Danh gia theo cac tieu chi:
1. **Render-blocking resources**: CSS/JS co block rendering khong?
2. **Image optimization**: Co lazy loading khong? Format WebP?
3. **Liquid loops**: Co N+1 query trong vong lap khong?
4. **Unused code**: CSS/JS khong duoc su dung?

### Buoc 3: Kiem Tra Accessibility
1. Alt text cho tat ca hinh anh
2. ARIA labels cho interactive elements
3. Keyboard navigation support
4. Color contrast ratio (toi thieu 4.5:1)

### Buoc 4: Kiem Tra SEO
1. Meta title va description
2. Structured data (JSON-LD)
3. Canonical URLs
4. Heading hierarchy (H1 > H2 > H3)

### Buoc 5: Liquid Best Practices
1. Su dung render thay vi include
2. Tranh Liquid logic phuc tap trong templates
3. Su dung section settings dung cach
4. Xu ly nil/blank values

### Buoc 6: Bao Cao
Tao bao cao co cau truc:
- Tom tat tong quan (diem manh + diem can cai thien)
- Bang phat hien chi tiet (muc do: Cao/Trung binh/Thap)
- De xuat cu the cho tung van de
- Uu tien xu ly theo muc do anh huong

## Examples
Vi du 1: Review theme moi
Nguoi dung noi: "Review Shopify theme cua toi"
Hanh dong: Yeu cau file, chay kiem tra 4 buoc, tao bao cao
Ket qua: Bao cao chi tiet voi de xuat cai thien

## Troubleshooting
Loi: Khong doc duoc file .liquid
Giai phap: Dam bao file duoc upload dung dinh dang, khong bi nen

Tài nguyên hữu ích

Tài liệu chính thức từ Anthropic

• Best Practices Guide -- Hướng dẫn best practices cho skills
• Skills Documentation -- Tài liệu chính thức về skills
• API Reference -- Tham chiếu API
• MCP Documentation -- Tài liệu về Model Context Protocol

Bài viết trên blog Anthropic

• Introducing Agent Skills
• Engineering Blog: Equipping Agents for the Real World
• Skills Explained
• How to Create Skills for Claude
• Building Skills for Claude Code
• Improving Frontend Design through Skills

Ví dụ Skills

• GitHub: anthropics/skills -- Repository public chứa skills do Anthropic tạo, có thể tuỳ chỉnh
• Document Skills -- PDF, DOCX, PPTX, XLSX creation
• Example Skills -- Các workflow patterns khác nhau
• Partner Skills Directory -- Skills từ Asana, Atlassian, Canva, Figma, Sentry, Zapier, v.v.

Công cụ và tiện ích

• skill-creator skill: Có sẵn trên Claude.ai và Claude Code. Tạo skill từ mô tả, review và đề xuất cải thiện. Dùng: "Help me build a skill using skill-creator"
• Validation: skill-creator có thể đánh giá skill của bạn. Hỏi: "Review this skill and suggest improvements"

Hỗ trợ

• Câu hỏi kỹ thuật: Claude Developers Discord
• Báo cáo lỗi: GitHub Issues tại anthropics/skills/issues (bao gồm: tên skill, thông báo lỗi, các bước tái tạo)

Lộ trình học tập được khuyến nghị

Dựa trên kinh nghiệm của Anthropic, đây là lộ trình tối ưu:

1. Đọc Best Practices Guide nếu bạn đang xây dựng skill đầu tiên
2. Dùng skill-creator để tạo bản nháp trong 15-30 phút
3. Chạy qua Quick Checklist ở trên để xác nhận không bỏ sót gì
4. Test với 10-20 truy vấn (5 nên trigger, 5 không nên, 10 functional)
5. Chia sẻ cho 2-3 người dùng thử và thu thập feedback
6. Iterate dựa trên feedback, đặc biệt là description và instructions
7. Clone repo anthropics/skills để tham khảo production-ready examples

Lời kết

Qua 6 phần của serial này, bạn đã có đầy đủ kiến thức để:

• Hiểu kiến trúc và nguyên tắc thiết kế của Skills
• Lập kế hoạch và thiết kế skill cho use case cụ thể
• Test và tối ưu skill một cách có hệ thống
• Phân phối skill cho cá nhân, team, hoặc cộng đồng
• Áp dụng 5 patterns thiết kế đã được chứng minh
• Xử lý các lỗi phổ biến khi skill không hoạt động như mong đợi

Skills là tài liệu sống. Skill tốt nhất không phải viết một lần là xong, mà được cải thiện liên tục qua phản hồi thực tế. Hãy bắt đầu với một use case đơn giản, iterate nhanh, và mở rộng dần.

Chúc bạn xây dựng được những skill hiệu quả cho Claude.