Mổ xẻ file SKILL.md
Mọi skill bắt đầu bằng file SKILL.md với 2 phần: YAML frontmatter (metadata) và phần thân Markdown (hướng dẫn).
---
name: bao-cao-tuan
description: Soạn báo cáo tuần theo format chuẩn của công ty. Dùng khi user yêu cầu viết, tổng hợp hoặc format báo cáo tuần/tháng.
---
# Báo cáo tuần
## Quy trình
1. Hỏi user về các đầu việc đã hoàn thành trong tuần
2. Phân loại theo: Done / In Progress / Blocked
3. Viết theo template trong template.md
4. Tone: ngắn gọn, bullet points, số liệu cụ thể
Frontmatter — 2 trường bắt buộc
- name: định danh skill, viết thường, gạch nối (kebab-case), tối đa 64 ký tự
- description: mô tả skill làm gì và khi nào dùng — đây là trường QUAN TRỌNG NHẤT (bài 7 sẽ đào sâu)
Tùy nền tảng còn có trường mở rộng như allowed-tools (giới hạn tool skill được dùng trong Claude Code) hay license.
Phần thân — viết cho AI đọc
Phần thân là hướng dẫn nghiệp vụ. Nguyên tắc viết:
- Cụ thể hơn là trừu tượng: "Luôn dùng định dạng ngày DD/MM/YYYY" tốt hơn "format ngày cho đúng"
- Có cấu trúc: heading, numbered list — AI bám theo cấu trúc rất tốt
- Kèm ví dụ mẫu: một ví dụ input/output chuẩn đáng giá hơn 10 dòng mô tả
Thư mục tài nguyên đi kèm
bao-cao-tuan/
├── SKILL.md
├── template.md # Template báo cáo — Claude đọc khi cần
├── vi-du-mau.md # Báo cáo mẫu đạt chuẩn
└── scripts/
└── export_pdf.py # Script Claude có thể chạy
Trong SKILL.md, bạn tham chiếu các file này bằng đường dẫn tương đối. Claude sẽ chỉ mở chúng khi thật sự cần — cơ chế này gọi là progressive disclosure, chủ đề của bài sau.