Lộ trình học›Claude Code›Claude Code chuyên sâu — Tham khảo đầy đủ Mở bản đồ

3.1 · Cấu trúc Skill: SKILL.md, scripts, templates

Bài viếtTrung cấp6 phút đọc

Một skill không chỉ là một file .md — cấu trúc thư mục chuẩn cho phép skill mang theo cả script hỗ trợ và template output.

Sau bài này, bạn sẽ
  1. Nắm cấu trúc thư mục chuẩn của một skill
  2. Biết 5 trường frontmatter YAML của SKILL.md
  3. Phân biệt nội dung nên để trong SKILL.md và nội dung nên tách ra

Cấu trúc thư mục chuẩn

~/.claude/skills/skill-name/
├── SKILL.md          # Định nghĩa & hướng dẫn
├── scripts/          # Script hỗ trợ (python, bash…)
└── templates/        # Template output tái sử dụng

5 trường frontmatter

TrườngKiểuÝ nghĩa
namestringTên hiển thị của skill
descriptionstringMô tả skill làm gì — quyết định việc so khớp kích hoạt
autoInvokearrayCụm từ kích hoạt cho auto-invocation
effortstringMức độ effort lý luận: low / medium / high
shellstringShell dùng cho scripts: bash / zsh / sh

Đặt gì ở đâu

  • SKILL.md: hướng dẫn cốt lõi, ví dụ ngắn, quy tắc chính — dưới 500 dòng
  • scripts/: logic phức tạp, lặp lại, chạy được độc lập (Python, shell)
  • templates/: khuôn mẫu output cố định (báo cáo, PR description, cấu trúc file)
Kiểm tra nhanh1 câu hỏi · chọn đáp án để xem giải thích
    Bạn đã hoàn thành bài này chưa?Tiến độ lưu trên trình duyệt của bạn.