安装
npx skills add apollographql/skills适合谁
如果你已经在用 Apollo GraphQL 的工具，并且希望编码 Agent 按官方技能来写查询、变更和缓存，而不是凭记忆混用旧 API，这组技能更合适。它面向正在使用 Apollo 相关技术的 AI 编码 Agent，遵循 Agent Skills 格式。格式说明见
https://agentskills.io/
技能也可在
https://skills.sh/
找到。它假定你接受一次交互式安装：先选技能，再选目标 Agent。只想读文档、不打算把技能写进本机 Agent 的人，收益有限。向导里会出现若干 Agent 名称，那是安装时的可选项，不要理解成「只有这些产品才能用 Apollo」。
3 分钟完成第一次尝试
官方安装按页面写成这一条：
npx skills add apollographql/skills
CLI 会带你做交互安装：先选择要装的技能，再选择目标 Agent。这会改本机 Agent 的技能配置，不是只读查看。运行前确认本机有 npx，并且你清楚即将写入哪一个 Agent 环境。看完选项再确认，不要在不明环境里一路回车。
装好后做一次只读核对。页面写到安装后可通过带命名空间的斜杠命令使用，其中 /apollo-skills:apollo-client 对应 Apollo Client 4.x for React 的 queries、mutations、caching 和 local state。对 Agent 发出这条命令，或明确要求按该技能检查一条已有查询，先不要改业务代码。成功信号是：回答按 Apollo Client 4.x / React 来谈查询或缓存，而不是提示技能未安装。若它开始重写整个数据层，先停下来。
使用案例
案例一：检查或起草 React 查询与变更。/apollo-skills:apollo-client 的说明包含 queries 和 mutations。把一条现有 GraphQL 操作交给 Agent，只问「按 Apollo Client 4.x 在 React 里该怎么发」。摘录没有给出具体 hook 名，也没有写与其他 GraphQL 客户端的对照。因此你能确认的是：这条技能覆盖 Client 4.x 的查询和变更；具体 API 必须以技能正文或你项目里的 4.x 代码为准。不要让它顺便升级整个客户端大版本。
案例二：核对缓存与本地状态。同一条技能还写了 caching 和 local state。任务应是只读诊断，例如「这段缓存键 / 本地状态按该技能是否合理」。它没有写缓存淘汰策略的完整清单，也没有写本地状态必须用哪一种存储。所以验收只看到：讨论落在 Client 4.x 的缓存或本地状态上；若 Agent 建议改 schema 或加新的链接中间件，已经超出这条摘录。
使用边界
这是 Apollo GraphQL 工具与技术的技能集合，不是通用 GraphQL 教程。离开 Apollo 生态去套用这些斜杠命令，超出页面写出的范围。斜杠命令带 apollo-skills: 前缀；摘录完整描述的只有 /apollo-skills:apollo-client。其他命令即使存在，这份材料也没有给出说明，不要自行补能力。
安装路径就是上面的 npx skills add 交互向导。不要并列另一套安装器。向导会让你选择技能和 Agent；选错环境意味着技能被写进错误的运行时。页面没有写卸载步骤。
第一次停在只读检查。任何改查询、改缓存策略或升级 Apollo Client 的动作，都要先让 Agent 复述将改的文件，你确认后再继续。