05 · 在 API / Claude Code / Agent SDK 中用 Skills

04-创建自定义Skill ｜ 返回 00-课程总览

同一个 Skill，四种环境复用

写好的 Skill 文件夹不用改，可以在多个环境里挂载使用。这是 Skill「一次写好、到处能用」的兑现。

1) Claude Code 里用

project/
└── .claude/
    └── skills/
        └── weekly-report/
            ├── SKILL.md
            └── templates/weekly.md

• 放好后，你说「写周报」，Claude Code 读到 description 匹配 → 自动触发。
• 个人级放 ~/.claude/skills/，项目级放项目内 .claude/skills/。

2) Claude API 里用

• 通过 API 把 Skill 一并提供给模型；模型按渐进式披露只在需要时加载内容。
• 适合你做一个对外产品，让后端的 Claude 自带某些专门能力。
• 配合 code execution / 文件能力，Skill 里的脚本可被执行。

# 概念示意（具体以官方 SDK 文档为准）
import anthropic
client = anthropic.Anthropic()
resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=2048,
    # 挂载 skill（按官方最新参数）
    messages=[{"role": "user", "content": "帮我写本周周报"}],
)

⚠️ Skills 在 API 的具体挂载参数会演进，以 docs.claude.com 最新文档为准。

3) Claude Agent SDK 里用

• Agent SDK 用来搭自己的智能体（带工具、记忆、循环）。
• 指定 Skill 目录后，你的智能体就拥有这些专门能力。
• 适合做垂直智能体产品：法务助手、运营助手、数据分析助手……

选型小结

只是自己日常用      → Claude.ai 启用
在项目里写代码      → Claude Code 的 .claude/skills/
做后端/产品 API     → Claude API 挂载
做完整智能体产品    → Agent SDK 配 Skill 目录

全课收束

Skill = 可移植的「领域能力包」。配合 Claude Code 的工程能力 + MCP 的外部接入，就能把「一次性教 AI」变成「沉淀成组织资产」。

本节实操

• 把你写的 Skill 放进 Claude Code 的 .claude/skills/
• 用一句自然语言触发它，验证 description 写得够准
• 想一个把它接进 API/Agent SDK 的产品点子

🎓 课程结束 → 继续 Codex 课 ｜ 返回 三课合集