Hướng dẫn phát triển Skill
Skill "meta" cung cấp quy trình 6 bước và checklist để thiết kế, viết và kiểm tra skill cho Claude Code / plugin.
Lập trìnhTrung cấp★ 549⑂ 48Điểm AI 7/10Cập nhật lần cuối: 16 thg 9, 2026
Làm được gì
- Thiết kế cấu trúc skill: khi nào dùng
references/,examples/,scripts/,assets/và nội dung nào nên nằm ở đâu. - Viết câu kích hoạt (trigger): chỉnh
descriptiontrong frontmatter theo dạng ngôi thứ ba kèm các cụm từ người dùng thật sự nói, có ví dụ tốt/xấu. - Progressive disclosure: ba mức nạp ngữ cảnh (metadata → thân SKILL.md 1.500–2.000 từ → tài nguyên kèm theo) để tránh phình context.
- Quy tắc văn phong: dùng câu mệnh lệnh, tránh ngôi thứ hai ("bạn nên...").
- Quy trình 6 bước + checklist kiểm tra trước khi phát hành skill.
Phù hợp với ai
- Lập trình viên lần đầu viết skill cho Claude Code
- Người có skill nhưng không tự kích hoạt đúng lúc
- Người đóng gói nhiều skill trong một plugin để phân phối
- Người có SKILL.md quá dài, tốn ngữ cảnh
Ví dụ sử dụng
- "Tạo giúp tôi một skill xử lý PDF" → hỏi các ví dụ sử dụng → đề xuất
scripts/rotate_pdf.py→ tạo thư mục → viết SKILL.md. - "Skill của tôi không tự chạy" → viết lại description theo ngôi thứ ba với cụm từ kích hoạt cụ thể.
- "SKILL.md của tôi dài 8.000 từ" → tách chi tiết sang
references/patterns.mdvàreferences/advanced.md, giữ phần cốt lõi gọn nhẹ.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/tzachbon/smart-ralph/HEAD/.agents/skills/Skill Development/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục .agents/skills/Skill Development từ repo GitHub tzachbon/smart-ralph vào ~/.claude/skills/skill-development/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph && mkdir -p ~/.claude/skills/skill-development && cp -r "/tmp/smart-ralph/.agents/skills/Skill Development/." ~/.claude/skills/skill-development/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở Terminal.
- Clone repo:
git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph - Tạo thư mục skill:
mkdir -p ~/.claude/skills/skill-development - Copy nội dung:
cp -r "/tmp/smart-ralph/.agents/skills/Skill Development/." ~/.claude/skills/skill-development/ - Kiểm tra:
ls ~/.claude/skills/skill-developmentphải thấySKILL.md. - Khởi động lại Claude Code, thử yêu cầu "tạo một skill mới" để xem skill có được kích hoạt.
- (Tùy chọn) Nếu chỉ dùng cho một dự án, copy vào
.claude/skills/trong dự án đó.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT