Skills 使用指南

本指南将深入介绍如何在不同平台和场景中有效使用 Anthropic Skills。

使用 Skills 的方式

1. Claude.ai (Web 界面)

Claude.ai 的付费计划已包含所有示例技能。

激活技能

自动激活: 在对话中提及技能相关的任务，Claude 会自动加载相应技能。

示例对话:
用户: "帮我创建一个算法艺术作品"
→ Claude 自动激活 algorithmic-art 技能

手动指定: 明确告诉 Claude 使用特定技能。

示例对话:
用户: "使用 docx 技能帮我创建一份报告"
→ Claude 加载 docx 技能

上传自定义技能

  1. 访问 Claude.ai
  2. 进入 Settings
  3. 选择 Skills 部分
  4. 上传 .skill 文件

详见 在 Claude 中使用 Skills

2. Claude API

通过 API 使用技能提供了最大的灵活性和控制。

基本使用

import anthropic

client = anthropic.Anthropic(api_key="your-api-key")

# 创建消息时指定技能
message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "帮我创建一个财务报表"
        }
    ],
    # 指定技能
    skills=["xlsx"]
)

上传自定义技能

# 上传技能
skill = client.skills.create(
    name="my-custom-skill",
    file=open("my-skill.skill", "rb")
)

# 使用上传的技能
message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    skills=[skill.id],
    messages=[...]
)

详见 Skills API 快速开始

3. Claude Code

Claude Code 通过插件市场提供技能管理。

安装技能市场

# 添加 Anthropic 技能市场
/plugin marketplace add anthropics/skills

浏览和安装技能

# 方式 1: 交互式浏览
/plugin
# 选择 "Browse and install plugins"
# 选择 "anthropic-agent-skills"
# 选择技能集（document-skills 或 example-skills）

# 方式 2: 直接安装
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

使用已安装的技能

# 在对话中直接提及
"使用 PDF 技能从 report.pdf 中提取表单字段"

# 或明确指定
"@pdf-skill 帮我填写这个 PDF 表单"

Skills 的工作原理

渐进式加载机制

Skills 使用三级加载系统来优化上下文使用：

Level 1: 元数据 (name + description)
         ↓ 始终在上下文中 (~100 词)
         ↓ Claude 用它决定是否触发技能
         
Level 2: SKILL.md 正文
         ↓ 技能触发后加载 (<5k 词)
         ↓ 包含核心指令和工作流程
         
Level 3: 打包资源 (scripts, references, assets)
         ↓ Claude 按需读取或执行
         ↓ 无大小限制（脚本可直接执行）

触发机制

Claude 根据 description 字段决定是否激活技能：

---
name: pdf
description: |
  Comprehensive PDF manipulation toolkit for extracting text and tables,
  creating new PDFs, merging/splitting documents, and handling forms.
  Use when Claude needs to:
  (1) Extract text or tables from PDFs
  (2) Create new PDF documents
  (3) Fill PDF forms
  (4) Merge or split PDFs
---

当用户请求与这些场景匹配时，Claude 自动加载技能。

按场景使用 Skills

场景 1: 创意内容生成

目标: 创建算法艺术作品

用户请求:
"创建一个使用流场 (flow field) 的生成艺术作品"

触发技能: algorithmic-art

Claude 会:
1. 加载 algorithmic-art 技能
2. 使用 p5.js 生成代码
3. 应用流场算法
4. 创建 HTML artifact 供预览

相关技能:

  • algorithmic-art - 算法艺术
  • canvas-design - 视觉设计
  • theme-factory - 主题样式

场景 2: Web 应用开发

目标: 构建响应式待办事项应用

用户请求:
"构建一个现代化的待办事项应用，使用 React 和 Tailwind"

触发技能: web-artifacts-builder

Claude 会:
1. 加载 web-artifacts-builder 技能
2. 使用 React + Tailwind + shadcn/ui
3. 创建完整的交互式应用
4. 包含状态管理和本地存储

相关技能:

  • web-artifacts-builder - Web 应用构建
  • webapp-testing - 应用测试
  • frontend-design - 前端设计

场景 3: 文档处理

目标: 创建带追踪更改的 Word 报告

用户请求:
"创建一个财务报告，并标记需要审核的部分"

触发技能: docx

Claude 会:
1. 加载 docx 技能
2. 使用 python-docx 创建文档
3. 应用 Redlining 追踪更改
4. 添加注释和格式

相关技能:

  • docx - Word 文档
  • xlsx - Excel 表格
  • pptx - PowerPoint 演示
  • pdf - PDF 文档

场景 4: 企业沟通

目标: 编写内部周报

用户请求:
"帮我写一份工程团队的周报，使用 3P 格式"

触发技能: internal-comms

Claude 会:
1. 加载 internal-comms 技能
2. 应用 3P 格式（Progress/Plans/Problems）
3. 使用信息优先级算法
4. 生成结构化报告

相关技能:

  • internal-comms - 内部沟通
  • brand-guidelines - 品牌规范
  • frontend-design - 设计美学

最佳实践

✅ 有效使用 Skills

  1. 明确任务需求

    ❌ "帮我处理这个文件"
✅ "使用 PDF 技能从这个表单中提取所有字段"

  2. 提供必要上下文

    ❌ "创建一个图表"
✅ "创建一个展示月度收入趋势的图表，使用蓝色主题"

  3. 分步骤进行复杂任务

    步骤 1: "分析 PDF 表单的字段结构"
步骤 2: "创建字段映射 JSON"
步骤 3: "填写表单并验证"

  4. 利用技能的专业知识

    ✅ "按照 algorithmic-art 技能的最佳实践创建作品"
✅ "使用 xlsx 技能的财务建模标准"

❌ 常见误区

  1. 假设技能自动适用所有情况

    • Skills 需要明确触发
    • 提供清晰的任务描述

  2. 忽略技能的限制

    • 每个技能有特定适用范围
    • 查看文档了解能力边界

  3. 不查看技能文档

    • 技能文档包含重要的工作流程
    • 最佳实践能显著提升效果

组合使用多个 Skills

示例 1: 完整的演示文稿工作流

步骤 1: 使用 brand-guidelines 确定配色方案
步骤 2: 使用 pptx 创建演示文稿
步骤 3: 使用 theme-factory 应用自定义主题

示例 2: 数据分析报告

步骤 1: 使用 xlsx 处理和分析数据
步骤 2: 使用 canvas-design 创建数据可视化
步骤 3: 使用 docx 生成分析报告

示例 3: Web 应用开发和测试

步骤 1: 使用 web-artifacts-builder 构建应用
步骤 2: 使用 frontend-design 优化 UI/UX
步骤 3: 使用 webapp-testing 编写测试

技能性能优化

提高响应质量

  1. 提供具体示例

    "创建类似这样的流场艺术: [提供参考图片或描述]"

  2. 指定输出格式

    "生成 PDF 报告，包含目录和页码"

  3. 说明约束条件

    "GIF 大小不超过 1MB，适合 Slack"

减少迭代次数

  1. 一次性提供完整要求

    ✅ "创建蓝色主题的待办应用，支持拖拽排序和本地存储"
❌ "创建待办应用" → "加个拖拽" → "加个存储" → "改成蓝色"

  2. 引用技能的标准流程

    ✅ "按照 docx 技能的 Redlining 工作流处理文档"

故障排除

技能未触发

可能原因:

  • 请求不够明确
  • 技能未安装（Claude Code）
  • 描述与任务不匹配

解决方案:

明确指定: "使用 [技能名] 技能完成 [任务]"

输出不符合预期

可能原因:

  • 缺少必要上下文
  • 约束条件不清晰

解决方案:

  • 提供更详细的要求
  • 参考技能文档的最佳实践
  • 提供示例输出

技能功能不足

解决方案:

  • 查看是否有相关技能可以组合使用
  • 考虑创建自定义技能（见 创建技能指南）

下一步

相关资源