Vượt khỏi Claude Code: Skills trong app của chính bạn
Bạn xây SaaS có tính năng AI? Skills dùng được qua Claude API — nghĩa là sản phẩm của bạn cũng có thể có hệ thống "kỹ năng" chuyên nghiệp như Claude.ai.
Cách hoạt động ở tầng API
Skills chạy trong code execution container của API: bạn upload skill, rồi khai báo trong request. Claude trong container sẽ thấy skill như trên Claude Code.
import anthropic
client = anthropic.Anthropic()
# 1. Upload skill (một lần) — qua Skills API
skill = client.beta.skills.create(
display_title="Báo cáo tài chính chuẩn VAS",
files=[...], # SKILL.md + các file phụ
)
# 2. Dùng trong conversation
response = client.beta.messages.create(
model="claude-sonnet-4-6",
max_tokens=4096,
container={"skills": [{"type": "custom", "skill_id": skill.id}]},
tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
messages=[{"role": "user", "content": "Phân tích file báo cáo Q2 đính kèm"}],
)
Với Claude Agent SDK
Agent SDK (Python/TypeScript) cho bạn dựng agent hoàn chỉnh — skills nằm trong thư mục làm việc của agent giống Claude Code (.claude/skills/), agent tự nạp theo cơ chế progressive disclosure quen thuộc.
Kiến trúc gợi ý cho SaaS
[User của bạn] → [Backend của bạn]
↓ chọn skill theo gói/quyền user
[Claude API + container skills]
↓
[Kết quả trả về app]
Điểm hay: skill trở thành sản phẩm. Gói Basic được 3 skills, gói Pro được 10 skills — bạn bán năng lực AI chuyên biệt, không chỉ bán "chat với AI".
Lưu ý vận hành
- Skill upload qua API có version riêng — pin version trong production, đừng trỏ latest
- Container có giới hạn runtime — script nặng cần tối ưu hoặc tách ra ngoài
- Log lại skill nào được kích hoạt cho request nào — không đo được thì không cải thiện được