Từ "biết cách làm" đến "có đồ nghề"
Có những việc viết hướng dẫn cho AI tự làm là phí phạm: resize ảnh, parse file Excel, gọi API nội bộ. Thay vì mô tả 20 bước, đính kèm script — Claude sẽ chạy nó.
Ví dụ: skill nén & chuẩn hóa ảnh
chuan-hoa-anh/
├── SKILL.md
└── scripts/
└── optimize.py
SKILL.md:
---
name: chuan-hoa-anh
description: Nén, resize và đổi tên ảnh theo chuẩn upload web (max 1200px, JPEG 85%, tên kebab-case). Dùng khi user cần xử lý, nén, hoặc chuẩn hóa ảnh trước khi upload.
---
# Chuẩn hóa ảnh upload
## Quy trình
1. Nhận đường dẫn ảnh hoặc thư mục từ user
2. Chạy script: \`python3 scripts/optimize.py <input> <output>\`
3. Báo cáo: kích thước trước/sau, % tiết kiệm
4. KHÔNG tự viết lại logic xử lý ảnh — luôn dùng script
scripts/optimize.py — script Python dùng Pillow: mở ảnh, resize về max 1200px, save JPEG quality 85, đổi tên kebab-case.
Nguyên tắc vàng khi viết script cho skill
- Script phải chạy được độc lập: nhận tham số CLI, in kết quả ra stdout — như viết cho đồng nghiệp dùng
- Nói rõ trong SKILL.md: "luôn dùng script, không tự viết lại" — không thì AI thỉnh thoảng "sáng tạo" code riêng, mất tính nhất quán
- In lỗi rõ ràng: AI đọc stderr để tự sửa cách gọi — error message tốt giúp AI tự phục hồi
- Khai báo dependency ngay đầu SKILL.md (cần
pip install pillow)
Vì sao mạnh hơn hướng dẫn thuần?
Script = deterministic. Mô tả bằng lời, AI mỗi lần làm hơi khác nhau; script thì 1000 lần chạy cho 1000 kết quả giống hệt. Quy tắc chọn: việc cần chính xác tuyệt đối → script; việc cần linh hoạt ngữ cảnh → hướng dẫn.