Tổng quan

Skill trong Claude Code (hay các Agentic Coding Assistant khác) là một công cụ mạnh mẽ để bạn “dạy” cho AI các quy tắc, quy chuẩn (conventions) và cấu trúc kiến trúc (architecture) riêng của dự án. Thay vì mỗi lần giao việc phải lặp lại các yêu cầu chi tiết như “hãy dùng HTML thuần”, “nhớ chia Landing Page thành 10 sections”, “sử dụng Tailwind CSS qua CDN”,… bạn chỉ cần đóng gói tất cả vào một file cấu hình Skill. Khi được gọi, AI sẽ tự động đọc và tuân thủ chính xác các quy tắc đã đề ra. Dưới đây là các bước xây dựng một Skill đơn giản: Landing Page Generator.

Các bước thực hiện

Bước 1: Khởi tạo thư mục Skill

Trong thư mục gốc của dự án, bạn tạo một thư mục dành riêng cho skill. Các Agent thường tìm kiếm và tự động nhận diện các skill trong thư mục .claude/skills/ hoặc .agents/skills/.

Bước 2: Tạo file cấu hình SKILL.md

Tạo file SKILL.md bên trong thư mục vừa tạo. Đây là file quan trọng nhất, chứa toàn bộ “não bộ” và logic hướng dẫn AI thực thi.

Bước 3: Định nghĩa nội dung Skill

Một file SKILL.md hoàn thiện thường bao gồm các phần:
  1. Frontmatter (YAML): Định nghĩa name (tên gọi) và description (mô tả) của skill.
  2. Ngữ cảnh dự án (Project Context): Liệt kê công nghệ cốt lõi và các thư viện (HTML, Tailwind, Vanilla JS, Lucide Icons…).
  3. Cấu trúc (Architecture): Mô tả rõ bố cục (ví dụ: Landing Page với 10 sections chuẩn mực).
  4. Tham số đầu vào (Params): Liệt kê các tuỳ chọn biến thiên (như Chủ đề, Màu chủ đạo, Theme Sáng/Tối).
  5. Quy ước (Conventions): Các quy tắc về Code, UI, Responsive và Animations.
  6. Các bước thực hiện (Step-by-step instructions): Hướng dẫn chi tiết để AI có thể tư duy tuần tự và viết code không bị bỏ sót yêu cầu.

Mẫu Nội dung File SKILL.md

Dưới đây là nội dung mẫu. Bạn có thể copy toàn bộ nội dung này và dán vào file .claude/skills/landing-page/SKILL.md vừa tạo: