skill-creator – Agent Skill 创建 Skill

skill-creator 是用于指导 AI Agent 编写和打包可复用 Skills 的开发型 Skill，适合需要把提示词、工具调用和工作流组织成标准 Skill 结构的开发者。

查看调研报告在来源平台打开

Skill 安装

多 Agent 安装

npx skills add https://github.com/apollographql/skills --skill skill-creator

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

Skill 调研报告

Skill 详细介绍

apollographql/skills#skill-creator 是 Apollo GraphQL 官方 skills 仓库中的一个 Skill，从命名和归属来看，它属于「Skill 创建 / 编写辅助」方向。需要注意，技能名称中的 skill-creator 本身具有通用性，互联网上存在其他同名或近名的 Skill 项目，本文讨论的对象严格限定为 apollographql/skills 仓库下的这一个 Skill，而不是其他作者或组织的同名项目。

它本质上是一个面向 AI Agent 的 Skill（通常由 SKILL.md 与相关辅助文件组成），属于提示词 / 指令集 / 方法论性质的内容，不是一个可以独立运行的软件程序，也不是一个 npm 包或 CLI 工具。安装后，Agent 增加的能力是「按照规范生成、整理或检查 Skill 定义文件」，而不是新增某个外部平台的连接能力。

核心用途

– 帮助用户按规范编写 Skill 定义文件（通常是 SKILL.md 及其目录结构）。
– 辅助生成或整理 Skill 的名称、描述、触发条件、指令内容等。
– 对已有 Skill 定义做结构检查或一致性梳理。

它不是什么

– 不是运行代码的引擎。
– 不是某个第三方服务的 API 封装。
– 不是通用的文档生成器，主要面向「Skill 定义」这一特定对象。

适合的任务

– 第一次撰写 Skill，需要有人帮你搭出正确结构。
– 已有零散说明文档，想整理成规范的 SKILL.md。
– 想对现有 Skill 的字段、描述风格做一次检查。

不适合的任务

– 期望它直接调用某个外部 API 或平台。
– 期望它替代你完成完整的软件工程任务。
– 期望它会安装、执行或调试你的代码。

由于当前 Skill 的原始 SKILL.md 与 README 内容需要以其官方仓库当前版本为准，本文不对其内部实现细节、具体字段清单、依赖工具做超出命名与常规 Skill 结构的推断。若需要精确内容，请以 apollographql/skills 仓库中该 Skill 当前官方说明为准。

Skill 安全评估

总体判断：apollographql/skills#skill-creator 属于「编写型 / 指令型」Skill，风险面相对小，主要安全考量集中在来源可信度与写入行为上，不涉及明显的敏感凭证操作。

一、来源可信度

– 归属为 Apollo GraphQL 官方组织仓库，属于相对可信的来源。
– 仍需注意：技能名称通用，网络上可能存在第三方同名项目，安装时应确认来源确实为 apollographql/skills。

二、文件写入

作为「创建 Skill」类 Skill，它的正常工作很可能涉及在你的项目目录中生成或修改文件（如 SKILL.md）。这是符合其用途的行为，不算异常，但意味着：

– 建议在 Git 仓库中运行，改动可回退。
– 首次使用时可以先让它把内容输出到对话中，确认无误后再落盘。

三、Shell 权限

当前官方资料未明确说明该 Skill 是否需要执行 Shell 命令。如果只需要它生成 / 检查文件文本，可以关闭 Agent 的自动执行 Shell 权限，由你手动执行任何命令。

四、网络访问

创建 Skill 文件本身通常不需要网络。若 Agent 在过程中联网检索，属于 Agent 自身行为，而非该 Skill 的必需条件。

五、凭证 / API Key

就「创建 Skill 定义」这一用途而言，它本身不应该需要 API Key、Token 或 OAuth。如果你在安装说明中看到它要求提供凭证，应当谨慎核实。

六、Prompt 注入 / 内容风险

如果用它来整理你从外部复制的文本，注意被整理的文本可能带有指令性内容。保持「只在需要时整理」的习惯，不盲目让 Agent 执行被整理文本中出现的「命令」。

实操建议：

– 优先在 Git 仓库中使用。
– 必要时关闭自动执行 Shell 权限。
– 对涉及删除、覆盖文件的动作先确认再执行。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Apollo GraphQL 的 skills 仓库，这类 Skill 的通用形态是「SKILL.md + 指令」，凡是支持加载自定义 Skill 或类似机制的 Agent，理论上都可以尝试。Claude Code 是目前对这类 Skill 支持最成熟的环境之一，可以优先在 Claude Code 中使用。

官方未公布完整的第三方 Agent 兼容列表。Codex、Cursor、Trae、OpenClaw、WorkBuddy 等环境是否支持、以及支持到什么程度，取决于各 Agent 当前版本的 Skill 加载方式，需以对应 Agent 的最新说明为准。

二、运行环境 / 依赖

该 Skill 本身属于指令 / 文档类，官方资料未明确要求 Node.js、Python、Docker 等运行时。

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先，其他支持 Skill 的 Agent 可尝试 |
| Node.js / Python | 官方未明确要求 |
| Git | 建议有，便于回退文件改动 |
| 网络 | 创建 Skill 文件本身通常不需要 |

以上环境项以官方当前说明为准，未确认的版本号不做填写。

三、权限

– 文件读取：需要，用于读取现有 Skill 或参考文件。
– 文件写入：很可能需要，用于生成 / 修改 SKILL.md 等文件。
– Shell：可选。如仅需生成文本，可关闭。
– 网络：非必需。
– 凭证类权限：非必需。

四、账号 / API Key

Skill 本身不需要账号或 API Key。如果你用它来为一个将来会调用外部平台的 Skill 写定义文件，那个「被创建出来的 Skill」将来是否需要凭证，取决于那个 Skill 的设计，与本 Skill 无关，两者不要混为一谈。

最小使用条件

1. 一个支持加载自定义 Skill 的 Agent（Claude Code 优先）。
2. 一个可写入的工作目录。
3. 可选：Git，用于回退改动。

Skill 安装、使用与卸载教程

一、安装

本页面上提供了该 Skill 的安装指令，可以直接复制并粘贴到对应的 Agent 或终端中执行。

如果你不确定自己的 Agent 应该如何安装，可以直接问当前 Agent：

如何安装 apollographql/skills#skill-creator？

如何在 Claude Code 中安装 apollographql/skills#skill-creator？

如何在 Cursor 中安装 apollographql/skills#skill-creator？

让 Agent 按照它自己的 Skill 加载 / 管理机制来指导安装，比自己手动拼命令更稳妥。

安装时注意确认来源是 apollographql/skills，避免装到同名的第三方项目。

二、安装后如何使用

安装成功后，该类 Skill 通常在你说出与「创建 Skill / 编写 Skill / 检查 Skill 定义」相关的意图时被 Agent 触发，或在你显式点名该 Skill 时被调用。

适合交给它的任务：

– 从零起草一个 SKILL.md。
– 把已有零散说明整理成规范 Skill 结构。
– 检查一个已有 Skill 定义是否缺字段、描述是否清晰。

自然语言使用示例：

使用 skill-creator，帮我从零写一个用于整理会议纪要的 Skill 定义。

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

使用 skill-creator，检查这个 Skill 的名称和描述字段是否清晰、是否符合规范。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式不同。比较稳妥的做法：

– 使用对应 Agent / Skill 管理器提供的删除方式移除该 Skill。
– 直接问当前 Agent：

如何卸载 apollographql/skills#skill-creator？

如果没有统一的卸载命令，按你所用 Agent 的 Skill 目录手动删除对应文件夹通常也可以。移除后建议重启或重新加载 Agent，确保变更生效。

常见问题

它和其他叫 skill-creator 的项目是同一个吗？
不是。网络上存在多个同名或近名的 Skill，本文只针对 apollographql/skills 仓库下的这个。安装前请确认来源是 apollographql/skills。

它可以同时装到多个 Agent 里吗？
可以。它本质上是文件形式的 Skill，只要你使用的多个 Agent 都支持以相同机制加载，就可以分别安装。各 Agent 的加载方式可能不同，需分别按对应 Agent 的方式处理。

为什么装完 Agent 没有识别到它？
常见原因：Skill 放在了 Agent 不读取的目录、目录结构不符合该 Agent 的规范、或者安装后未重启 / 未重新加载。可以先问 Agent「你现在加载了哪些 Skill」，再按它的提示排查。

Skill 更新后需要重新安装吗？
取决于你使用的 Agent 对 Skill 的管理方式。有些环境是直接读取本地文件，更新对应文件即可；有些需要重新拉取。以当前 Agent 的说明为准。

它可以修改我已有的项目文件吗？
作为「创建 Skill」类 Skill，它的正常工作可能涉及生成或修改文件。建议在 Git 仓库中使用，并在关键改动前用 Git 提交一次，方便回退。

在中国大陆使用有网络要求吗？
创建 Skill 文件本身通常不需要联网，因此一般没有特别的网络要求。是否联网取决于你使用的 Agent 自身行为，以及你是否在安装环节需要拉取仓库。

可以关闭 Shell 权限只用它生成文本吗？
可以。如果只需要它把 Skill 内容生成在对话里，可以先关闭 Agent 的自动执行 Shell 权限，由你确认内容后再手动落盘。

Skill 更新日志

版本列表

v1.2.10 最新 2026-09-24

## 变更内容 * chore(deps): 将依赖 prettier 更新至 v3.9.8，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/79 * docs: 将 connectors 技能指向最新的 Federation 和 Connectors LTS，由 @mabuyo 提交于 https://github.com/apollographql/skills/pull/80 ## 新贡献者 * @mabuyo 在 https://github.com/apollographql/skills/pull/80 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.9...v1.2.10

v1.2.9 2026-07-29

## 变更内容 * feat: 添加 authz、safelisting、config-as-code，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/69 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.8...v1.2.9

v1.2.8 2026-07-28

## 变更内容 * chore: 将 CLAUDE.md 符号链接到 AGENTS.md 并记录版本升级，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/78 * docs: 将 rust-best-practices 技能与上游手册同步，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/76 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.7...v1.2.8

v1.2.7 2026-07-28

## 变更内容 * chore(deps): 将依赖 prettier 更新至 v3.9.4，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/73 * chore(deps): 将依赖 prettier 更新至 v3.9.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/74 * chore(deps): 将依赖 prettier 更新至 v3.9.6，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/75 * docs: 澄清 federation 链接版本是下限，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/77 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.6...v1.2.7

v1.2.6 2026-07-03

## 变更内容 * chore(deps): 将依赖 prettier 更新至 v3.8.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/70 * chore(deps): 将依赖 prettier 更新至 v3.9.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/71 * 修复 list-apollo-kotlin-versions.sh 的链接，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/72 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.5...v1.2.6

v1.2.5 2026-06-04

## 变更内容 * docs: 记录 rover schema --coord 形式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/68 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.4...v1.2.5

v1.2.4 2026-06-03

## 变更内容 * Rover schema 探索，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/67 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.3...v1.2.4

v1.2.3 2026-05-25

## 变更内容 * 更新 Apollo Kotlin 技能以包含迁移指南，由 @martinbonnin 提交于 https://github.com/apollographql/skills/pull/66 ## 新贡献者 * @martinbonnin 在 https://github.com/apollographql/skills/pull/66 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.2...v1.2.3

v1.2.2 2026-05-04

## 变更内容 * docs: 将 gh 技能固定切换为 --pin 标志，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/62 * docs: 澄清 gh cli 注释与多技能安装匹配，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/63 * docs: 修复无效的 SDL 和不匹配的复杂度库，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/64 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.1...v1.2.2

v1.2.1 2026-04-28

## 变更内容 * feat: 将 gh skill cli 与自动发布集成，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/60 * fix(apollo-ios): 记录不受信任内容的威胁模型，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/61 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.0...v1.2.1

v1.2.0 2026-04-28

## 变更内容 * ci: 强制升级插件版本，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/59 * 添加 apollo-ios 技能，由 @AnthonyMDev 提交于 https://github.com/apollographql/skills/pull/58 ## 新贡献者 * @AnthonyMDev 在 https://github.com/apollographql/skills/pull/58 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/compare/v1.0.0...v1.2.0

v1.0.0 2026-04-28

## 变更内容 * 处理 Apollo Client 技能反馈：AC4 模式、TypedDocumentNode、缓存最佳实践，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/2 * 更新 README.md，由 @debergalis 提交于 https://github.com/apollographql/skills/pull/4 * 处理 PR #1 反馈：修复 Apollo Client 4.x 文档问题，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/3 * 为 Next.js、React Router 和 TanStack Start 添加框架特定的 Apollo Client 设置指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/6 * chore: 配置 Renovate，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/9 * 使文档语气与 Apollo Voice 指南保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/8 * 添加针对 Apollo Client 技能的 Copilot 指令，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/12 * 添加 skill-creator 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/10 * 从恢复的文档访问中添加完整的 Apollo Client Suspense hooks 文档，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/11 * 添加强调共置而非复用的 fragments 参考指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/13 * 分离客户端和 SSR 集成指南，将 setup 重命名为 integration，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/16 * 用完整手册章节替换 rust-best-practices 摘要，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/15 * 为 JavaScript/TypeScript 代码示例添加 Prettier 格式化，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/17 * 将 apollo-client 技能与上游提交 7f665110 同步，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/18 * 使 Apollo Server 技能与 Apollo Server 5.x 文档保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/19 * 更新一些导入，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/20 * 将 `skill-creator` 技能添加到活跃的 Copilot Skills，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/23 * 修复 apollo-mcp-server 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/21 * 为 PR 添加 skills-ref 验证工作流，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/25 * 添加 Apollo Kotlin 技能，由 @BoD 提交于 https://github.com/apollographql/skills/pull/26 * Apollo Kotlin 技能：添加脚本以获取最新版本，由 @BoD 提交于 https://github.com/apollographql/skills/pull/28 * 标准化技能版本格式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/29 * 更新指令信息，由 @dariuszkuc 提交于 https://github.com/apollographql/skills/pull/32 * chore(deps): 将依赖 prettier 固定为 3.8.1，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/33 * 修复拼写错误，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/31 * 添加 apollo-federation 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/5 * feat: 为联邦 GraphQL 超级图添加 apollo-router 技能，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/22 * 添加 Claude Code 插件支持，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/34 * 修复 apollo-mcp-server 技能配置示例中不正确的字段名，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/35 * feat(apollo-router): 使交接和快速开始以技能为先，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/36 * feat(skill): apollo-router-plugin-creator，由 @samuelAndalon 提交于 https://github.com/apollographql/skills/pull/30 * 从允许的工具中移除 curl，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/38 * 更新 apollo-mcp-server 技能以确保准确性，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/39 * fix: 修正 apollo-mcp-server 参考中的 CORS 配置选项，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/40 * fix: 修复损坏的链接和语法/拼写问题，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/41 * ci: 添加 AI 驱动的技能同步工作流，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/42 * refactor: 直接将技能与产品源进行比较，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/43 * ci: 在技能同步中包含新功能覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/44 * fix: 使用 structured_output 作为分类结果，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/45 * fix: 将多操作示例拆分为每个文件一个操作，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/46 * 用 Claude CLI 替换 claude-code-action，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/47 * feat: 添加 GraphQL LSP 服务器配置，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/49 * chore(deps): 将依赖 prettier 更新至 v3.8.2，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/50 * chore(deps): 将依赖 prettier 更新至 v3.8.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/51 * feat: 从 apollo-client 仓库同步 apollo-client 技能，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/52 * fix(apollo-router): 围绕 Cache-Control 头重新构建响应缓存，由 @abernix 提交于 https://github.com/apollographql/skills/pull/53 * docs(apollo-router): 扩展可观测性和 Redis 部署指南，由 @abernix 提交于 https://github.com/apollographql/skills/pull/54 * sync: 从 apollo-client@47c63b9795770ad581f77d892932f97b1cb2eb87 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/55 * 为 apollo-router 技能添加响应缓存覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/37 * sync: 从 apollo-client@de252731ffdc61026b01dd4be9f8d11a98daf43e 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/57 ## 新贡献者 * @Copilot 在 https://github.com/apollographql/skills/pull/2 中做出了首次贡献 * @debergalis 在 https://github.com/apollographql/skills/pull/4 中做出了首次贡献 * @svc-secops 在 https://github.com/apollographql/skills/pull/9 中做出了首次贡献 * @phryneas 在 https://github.com/apollographql/skills/pull/12 中做出了首次贡献 * @DaleSeo 在 https://github.com/apollographql/skills/pull/10 中做出了首次贡献 * @BoD 在 https://github.com/apollographql/skills/pull/26 中做出了首次贡献 * @dariuszkuc 在 https://github.com/apollographql/skills/pull/32 中做出了首次贡献 * @jvanderwee 在 https://github.com/apollographql/skills/pull/31 中做出了首次贡献 * @gocamille 在 https://github.com/apollographql/skills/pull/22 中做出了首次贡献 * @samuelAndalon 在 https://github.com/apollographql/skills/pull/30 中做出了首次贡献 * @abernix 在 https://github.com/apollographql/skills/pull/53 中做出了首次贡献 **完整变更日志**: https://github.com/apollographql/skills/commits/v1.0.0

暂无评论

暂无评论...