skill-creator – Agent Skill 创建与打包 Skill

3周前更新 7 0 0 0

skill-creator 是用于指导 AI Agent 按照规范结构创建和打包新 Skill 的开发型 Skill,适合需要把可复用流程、模板或领域知识整理成 Skill 供 Agent 调用的开发者。

Skill 安装

多 Agent 安装
npx skills add https://github.com/anthropics/financial-services-plugins --skill skill-creator

使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

skill-creator 是 Anthropic 官方在 anthropics/financial-services-plugins 仓库中提供的一个 Skill 创建辅助 Skill。它的作用是帮助用户按照规范编写、整理和校验 Skill 的描述文件(SKILL.md),而不是一个可以独立运行的程序或服务。安装之后,Agent 会在处理「创建 Skill / 整理 Skill / 检查 Skill 结构」这类任务时多出一套可参考的规范与流程。

它主要解决的问题是:Skill 的元数据、描述、触发条件、目录结构容易写得随意,导致 Agent 无法正确识别或加载。skill-creator 通过提供结构化的模板和检查思路,让用户能更快产出一个格式正确、描述清晰的 Skill。

核心能力(根据官方 Skill 定位整理)

  • 辅助生成 SKILL.md 的主体结构与字段。
  • 指导 Skill 名称、描述、适用场景的写法。
  • 检查已有 Skill 文件是否符合规范(字段缺失、描述模糊等)。
  • 把零散的说明、笔记整理为结构化 Skill 描述。

它不是什么

  • 不是可以独立运行的软件或 CLI 工具。
  • 不负责安装、发布或托管 Skill。
  • 不替代 Agent 自身的 Skill 加载机制。
  • 不面向具体业务(如财务、开发、设计)执行任务,而是面向「把 Skill 写对」这一步。

适合谁

  • 正在为 Claude Code 或其他支持 Skills 的 Agent 编写自定义 Skill 的用户。
  • 需要把内部流程、笔记、Prompt 整理成规范 Skill 的团队。
  • 想检查自己已有 SKILL.md 是否规范的开发者。

不适合什么需求

  • 只想让 Agent 直接完成某个业务任务(例如抓取网页、写代码),不需要创建 Skill。
  • 希望用一个命令自动部署或发布 Skill 到市场。

需要说明的是,skill-creator 本身属于规范 / 流程类 Skill,实质是指导 Agent 如何组织和校验 Skill 文件,属于提示与工作流性质,不包含复杂运行时。它所在的仓库是面向金融服务的插件集合,但该 Skill 本身是通用的 Skill 创建辅助。

Skill 安全评估

总体判断:来自 Anthropic 官方仓库,来源可信度较高。它本身是规范 / 流程类 Skill,正常情况下不需要网络访问、不需要 API Key,也不涉及凭证处理。安全关注点主要在于「创建 Skill 过程中会读写本地文件」这一点。

主要安全关注点

  • 来源可信度:属于 Anthropic 官方组织仓库,相较于第三方同名项目可信度更高。但使用前仍建议以仓库当前实际内容为准,避免引用来源不明的镜像或 fork。
  • 文件读取 / 写入:创建或校验 Skill 时,Agent 通常需要读取已有的 SKILL.md、目录结构,并可能写入或修改文件。这是该 Skill 正常用途所必需的,但用户应确认操作目录是自己预期的项目目录。
  • Shell 权限:如果底层 Agent 开启了自动执行 Shell,Skill 创建过程可能触发文件操作命令。不需要自动执行时,可以关闭自动执行,由用户手动确认。
  • Prompt Injection:如果读取的源文件内容不可信(例如从外部复制的文档),理论上存在被注入指令的风险。整理陌生来源内容时,建议人工确认生成结果。

降低风险的建议

  • 只从 Anthropic 官方仓库获取该 Skill,不要使用未经验证的第三方副本。
  • 在不熟悉的目录操作时,先备份或使用版本控制,避免误覆盖已有文件。
  • 如果只是让 Agent 输出 SKILL.md 草稿,可以关闭自动写入 / 自动执行,由用户自行保存。
  • 文档本身没有提供明确的安全审计或扫描结果,本文不对其做绝对安全性结论;具体表现请以官方最新说明为准。

Skill 使用要求

一、Agent / 客户端

该 Skill 属于 Anthropic 官方 Skills 体系,与 Claude Code 高度适配,建议优先在 Claude Code 中使用。官方目前没有公布完整的第三方 Agent 兼容列表。由于 Skill 本质是提供给 Agent 的指令与文件,从工作方式看,在支持 Skills、自定义 Skill 或类似指令加载机制的环境中,通常可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等 Agent 中使用,但不同 Agent 的加载方式与兼容程度可能不同,具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

项目 要求
Agent Claude Code 优先,其他兼容 Agent 可尝试
Node.js / Python 官方未把 skill-creator 本身列为需要单独安装的语言运行时
网络 获取 Skill 时通常需要;创建 Skill 本身一般不需要

官方没有明确列出该 Skill 必装的第三方依赖,本文不自行补充版本号。

三、权限

  • 文件读取:通常需要(读取已有 SKILL.md、目录结构)——必需。
  • 文件写入:创建或修改 Skill 文件时需要——视任务而定。
  • Shell:取决于底层 Agent 的加载与执行方式——可选。
  • 网络:创建 Skill 本身一般不需要。

四、账号 / API Key

skill-creator 本身不需要单独的账号、API Key 或 Token。它不调用第三方 API。如果后续你创建的 Skill 涉及外部服务,那部分凭证需求属于你新 Skill 的事情,与 skill-creator 无关。

最小使用条件

  1. 一个支持 Skills 或其他自定义指令机制的 Agent(推荐 Claude Code)。
  2. 可以写入 Skill 文件的目录或权限。
  3. 已经明确要创建或检查的 Skill 目标。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令,粘贴到你的 Agent 或终端中执行,无需手动逐条输入 git clone、复制目录等操作。

如果你不清楚自己的 Agent 该如何安装这个 Skill,可以直接在对话里询问当前 Agent:

如何安装 anthropics/financial-services-plugins#skill-creator?

如何在 Claude Code 中安装 anthropics/financial-services-plugins#skill-creator?

如何在 Cursor 中安装 anthropics/financial-services-plugins#skill-creator?

让 Agent 根据自己的 Skill 加载或管理机制指导你完成安装。官方没有为该 Skill 提供必须额外执行的独立安装命令,无需自行添加复杂步骤。

二、安装后如何使用

安装后,当你的任务涉及「创建 Skill」「整理 SKILL.md」「检查 Skill 结构」时,Agent 会参考该 Skill 的规范来处理。你不需要记忆特殊命令,直接用自然语言说明即可。

使用 skill-creator,帮我为公司的内部 API 设计一个技能目录结构。

使用 skill-creator,把这份 Markdown 笔记整理成规范的 SKILL.md。

使用 skill-creator,检查我现有的 SKILL.md 字段和描述是否符合规范。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一的卸载命令,直接询问当前 Agent 更稳妥:

如何卸载 anthropics/financial-services-plugins#skill-creator?

也可以使用对应 Agent 或 Skill 管理器提供的删除方式,移除该 Skill 对应的文件即可。本文不提供未经官方确认的卸载命令。

常见问题

1. 安装后 Agent 没有识别这个 Skill,怎么办?
先确认 Skill 文件是否放在了当前 Agent 的 Skill 目录中,以及是否需要重启会话或重新加载。不同 Agent 的加载方式不同,可以直接问当前 Agent「为什么没有识别到 skill-creator」。

2. 可以同时安装到多个 Agent 吗?
可以。该 Skill 本质是文件,复制到不同 Agent 对应的 Skill 目录即可,互不影响。但各 Agent 的兼容程度可能不同,实际效果以对应 Agent 为准。

3. 这个 Skill 会修改我已有的项目吗?
只有在你的任务涉及写入或改文件时,Agent 才可能修改内容。如果只想生成草稿,可以要求只输出文本、不要写入文件,或关闭 Agent 的自动执行 / 自动写入。

4. 中国大陆使用有网络要求吗?
获取 Skill 时通常需要访问 GitHub,网络环境可能影响下载速度。创建 Skill 本身一般不依赖外网。具体连通性取决于你的环境和所用 Agent。

5. skill-creator 和我自己写 SKILL.md 有什么区别?
它提供的是结构化的规范与检查思路,能减少字段缺失、描述模糊等问题,但最终内容仍需你自己确认。它不替代你对 Skill 目标与边界的设计。

6. 更新后需要重新安装吗?
如果 Skill 是直接从官方仓库获取,仓库更新后通常需要重新拉取或覆盖对应文件。具体刷新方式取决于你使用的 Agent,可询问当前 Agent 如何更新已安装的 Skill。

7. 适合在生产环境中使用吗?
它属于辅助类 Skill,不直接执行业务逻辑,本身不涉及生产数据处理。是否在生产环境使用,主要看你是否允许 Agent 在对应目录下读写文件。

Skill 更新日志

版本列表
无版本号
重构仓库并添加命名代理(#81) - 将垂直领域从仓库根目录移至 plugins/vertical-plugins/,将合作伙伴 插件移至 plugins/partner-built/ - 在 plugins/agent-plugins/ 下添加 10 个命名的、自包含的代理插件 (Pitch Agent、Market Researcher、Earnings Reviewer、Model Builder、 Meeting Prep、GL Reconciler、Month-End Closer、Statement Auditor、 Valuation Reviewer、KYC Screener)——每个都捆绑自己的技能,因此可以 独立安装 - 添加 managed-agent-cookbooks/(每个代理一个),包含子代理隔离 和用于 /v1/agents 部署的引导示例 - 添加 fund-admin 和 operations 垂直领域,以便 finance-ops/onboarding 代理提供真实的领域技能 - 添加 scripts/(check.py 清单 lint、sync-agent-skills.py、 deploy-managed-agent.sh、orchestrate.py 参考循环、 test-cookbooks.sh) - 添加 .github/workflows/secret-scan.yml(gitleaks + 内部引用 grep) - 将代理工具授权收紧为仅限已声明的 MCP——任何代理中均无 Bash、WebFetch 或未声明的 mcp__* 引用 - 在 README 中添加非投资建议免责声明 - 将 claude-in-office 重命名为 claude-for-msft-365-install(内容 不变)

暂无评论

none
暂无评论...