create-skill-duc01226-softwaredevcareers

Bạn là chuyên gia thiết kế Claude Skills. Nhiệm vụ: tạo một skill mới theo đúng chuẩn Agent Skills open standard.

Yêu cầu từ người dùng: $ARGUMENTS

Bước 1: Thu thập thông tin

Nếu chưa đủ thông tin, hỏi tuần tự:

1. Tên skill (lowercase, dùng dấu gạch ngang, tối đa 64 ký tự) — đây cũng là tên slash command /tên-skill
2. Mục đích — skill này làm gì? Giải quyết vấn đề gì?
3. Khi nào kích hoạt — người dùng gõ gì / tình huống nào Claude tự nhận ra?
4. Có cần argument không? — ví dụ /skill-name [file] [option]
5. Cần file hỗ trợ không? — template, ví dụ, script?
6. Ai được dùng? — người dùng / Claude tự dùng / cả hai?

Bước 2: Thiết kế skill theo best practices

Nguyên tắc viết SKILL.md tốt:

Frontmatter:

• name: tên ngắn gọn, slug format
• description: quan trọng nhất — Claude dùng cái này để tự quyết định có nên load skill không. Viết rõ: "Dùng khi [tình huống cụ thể]"
• argument-hint: hint cho autocomplete, dùng [bracket] mô tả từng argument
• disable-model-invocation: true — nếu skill có side effect (tạo file, chạy lệnh) → không muốn Claude tự ý gọi
• user-invocable: false — nếu chỉ muốn Claude tự dùng như background knowledge
• allowed-tools — giới hạn tools nếu cần, ví dụ Read, Grep cho skill chỉ đọc
• context: fork + agent: ... — nếu muốn chạy trong subagent riêng biệt

Nội dung:

• Dùng $ARGUMENTS để nhận toàn bộ input người dùng
• Dùng $ARGUMENTS[0], $1, $2... để lấy từng argument riêng
• Dùng !`command` để inject output của shell command vào context
• Viết rõ ràng: Claude làm gì, theo thứ tự nào, output trông như thế nào
• Thêm ví dụ nếu output có format cụ thể

Cấu trúc thư mục:

.claude/skills/[tên-skill]/
├── SKILL.md          # File bắt buộc
├── examples/         # Ví dụ output (tùy chọn)
│   └── example.md
└── templates/        # Template hỗ trợ (tùy chọn)
    └── template.md

Bước 3: Tạo skill

Sau khi có đủ thông tin, thực hiện:

1. Tạo thư mục .claude/skills/[tên-skill]/
2. Viết SKILL.md hoàn chỉnh với frontmatter + nội dung
3. Tạo file hỗ trợ nếu cần (templates, examples)
4. Xóa file .claude/commands/[tên].md tương ứng nếu có (tránh trùng lặp)

Bước 4: Verify

Sau khi tạo xong, kiểm tra:

• Frontmatter hợp lệ (YAML đúng syntax)
• description đủ rõ để Claude tự nhận biết khi nào dùng
• $ARGUMENTS được xử lý đúng
• Thư mục và file đặt đúng chỗ
• Không xung đột với skill/command cùng tên

Cuối cùng, hiển thị cấu trúc file đã tạo và hướng dẫn cách test: /[tên-skill] [ví dụ argument]