在上一篇博客中，我们介绍了 Agent Skills 的概念和原理。本文将聚焦于实战，介绍如何安装 Claude Code、加载和使用 Agent Skills，并以官方的 skill-creator 为例，演示如何创建自定义 Skill。

Claude Code 安装

Claude Code 是 Anthropic 推出的命令行工具，可以在终端中直接与 Claude 交互，是使用 Agent Skills 的主要方式之一。

  1. 安装 Claude Code

    1
    npm install -g @anthropic-ai/claude-code

  2. 修改~/.claude/settings.json文件，使用中转站

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    {
      "alwaysThinkingEnabled": true,
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "sk-bHWPKD8Ns5",
        "ANTHROPIC_BASE_URL": "https://api.duojie.games",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-5-20251101",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-5-20251101",
        "ANTHROPIC_MODEL": "claude-opus-4-5-20251101"
      },
      "model": "opus",
      "permissions": {
        "allow": ["Edit","Write","Read","Glob","Grep","Bash","Bash(kill:*)","Bash(pkill:*)","Bash(:*kill:*)","Bash(:*xargs:*)","Bash(cd:*)"],
        "deny": []
      }
    }

  3. 在主目录创建 .claude.json

    1
    2
    3
    下载链接：https://wwaue.lanzouv.com/iTLAr3fdlrhc
    密码：5yds
    文件下载后要改名，claude.txt改名为.claude.json

  4. 开始使用

安装完成后，进入你的项目目录并启动 Claude Code：

1
2
cd your-project
claude

Agent Skills 的存放位置

在 Claude Code 中，Skills 的存放位置决定了其作用范围：

位置 路径 适用范围
个人 ~/.claude/skills/ 你的所有项目
项目 .claude/skills/ 当前项目的所有协作者
企业 托管设置 组织内所有用户
插件 与插件捆绑 安装了该插件的用户

如果两个 Skills 有相同的名称，优先级从高到低为：企业 > 个人 > 项目 > 插件。

使用官方 skill-creator 创建 Skill

Anthropic 在 GitHub 上开源了一系列 Agent Skills，其中 skill-creator 是一个用于创建新 Skill 的元技能（meta-skill）。安装后，你只需用自然语言告诉 Claude 你想创建什么 Skill，Claude 就会自动调用 skill-creator 帮你完成所有工作。

仓库地址：https://github.com/anthropics/skills

skill-creator 简介

skill-creator 的核心理念是：让 Claude 帮你创建 Skill，而不是手动编写。它包含：

  • 创建 Skill 的核心原则和最佳实践
  • 初始化脚本 init_skill.py（Claude 会自动调用）
  • 打包脚本 package_skill.py（Claude 会自动调用）
  • 参考文档（workflows.md、output-patterns.md）

安装 skill-creator

将 skill-creator 下载到你的个人 Skills 目录：

1
2
3
4
cd ~/.claude/skills
git clone https://github.com/anthropics/skills.git temp-skills
cp -r temp-skills/skills/skill-creator ./
rm -rf temp-skills

或者直接下载 skill-creator 文件夹放到 ~/.claude/skills/ 目录下。

安装完成后，在 Claude Code 中验证：

1
What Skills are available?

你应该能看到 skill-creator 出现在列表中。

实战：用对话创建 PR Review Skill

安装 skill-creator 后，创建新 Skill 变得非常简单。你只需要用自然语言描述你的需求，Claude 会自动完成所有工作。

第一步：描述需求

在 Claude Code 中直接说：

1
2
3
4
我想创建一个用于代码审查的 Skill，叫 pr-review。
它应该能帮我审查 PR 中的代码质量、安全性和最佳实践。
审查时需要检查：代码可读性、潜在 bug、安全漏洞、性能问题、测试覆盖率。
输出格式要包含：文件路径、行号、严重程度、问题描述、修复建议。

第二步：Claude 自动创建 Skill

Claude 会识别到这是一个创建 Skill 的请求，自动触发 skill-creator，然后：

  • 向你确认 Skill 的功能和使用场景
  • 自动运行 init_skill.py 初始化 Skill 目录
  • 根据你的描述编写 SKILL.md
  • 根据需要创建辅助脚本或参考文档

整个过程中，Claude 可能会问一些澄清问题，比如：

  • “这个 Skill 应该支持哪些功能？”
  • “你能给一些使用这个 Skill 的例子吗？”
  • “审查结果的输出格式有什么偏好？”

第三步：迭代优化

Skill 创建完成后，可以直接测试：

1
Review the changes in my current branch

如果效果不理想，继续和 Claude 对话来优化：

1
审查结果太冗长了，能不能只显示 Critical 和 Warning 级别的问题？

Claude 会自动修改 SKILL.md 来满足你的需求。

第四步：打包分发（可选）

如果你想把 Skill 分享给其他人，告诉 Claude：

1
帮我把 pr-review Skill 打包成 .skill 文件

Claude 会自动运行 package_skill.py，生成可分发的 .skill 文件。

更多创建 Skill 的提示词示例

以下是一些创建不同类型 Skill 的提示词示例：

创建 API 文档生成 Skill

1
2
3
我想创建一个 Skill，能够根据代码自动生成 API 文档。
支持 Python 和 TypeScript。
输出格式为 Markdown，包含：函数签名、参数说明、返回值、使用示例。

创建数据库查询 Skill

1
2
3
帮我创建一个 BigQuery 查询 Skill。
我们的数据库有以下表：users、orders、products。
Skill 需要包含这些表的 Schema 信息，帮助生成正确的 SQL 查询。

skill-creator 的工作原理

当你请求创建 Skill 时，skill-creator 会指导 Claude 完成以下步骤：

  • 理解 Skill 的使用场景：通过具体例子了解 Skill 应该如何被使用
  • 规划 Skill 内容：分析需要哪些脚本、参考文档和资源
  • 初始化 Skill：运行 init_skill.py 创建标准目录结构
  • 编写 Skill 内容：实现脚本、编写 SKILL.md
  • 测试和迭代：根据实际使用效果进行优化
  • 打包分发：运行 package_skill.py 生成 .skill 文件

在 Claude.ai 中使用 Skills

除了 Claude Code，你也可以在 Claude.ai 网页端使用自定义 Skills：

  • 访问 Settings > Capabilities > Skills
  • 点击 Upload skill 上传 .skill 文件（zip 格式）
  • 上传后，Claude 会在相关对话中自动使用该 Skill

注意：Claude.ai 中的自定义 Skills 是个人级别的，不会在组织内共享。

总结

本文介绍了 Agent Skills 的实战使用方法：

  • Claude Code 的安装和基本使用
  • Skills 的存放位置和作用范围
  • 使用官方 skill-creator 创建自定义 Skill
  • Skill 创建的核心原则和标准结构

通过 Agent Skills，你可以将领域知识、工作流程和最佳实践封装成可复用的模块，让 Claude 从通用助手变成专业领域的专家。

拓展链接