anthropic-apollo-skills
costrict-plugins mirror of anthropic-apollo-skills (auto-generated, do not edit)
- 评测生成时间(北京时间)
- 本报告引擎
- v3.10.0
- 当前引擎
- v3.17.3
本报告与当前引擎使用不同规则;原分数不会自动更新,不同版本的分数不宜直接对比。
进入后确认来源与额度,提交才会创建任务。
代码版本未记录或记录无效,无法核对本报告的 commit 与送评文本;不会用当前项目代码回填历史记录。
综合采用结论
检测到关键风险,修复前不建议接入
- 基础评测完成+25/25确定性评分与静态安全扫描已完成
- README 有效证据+25/2520,540 个去重后的有效字符
- 独立证据来源+20/207 类非重复证据,重复文件不叠加
- 仓库元数据+10/10已取得仓库状态与采用数据
- 活跃记录+5/5已取得最近提交时间
- AI 复核+15/15已完成结构化 AI 证据复核
本报告评了什么
综合分用于静态采用筛选,不是任务成功率,也不代表使用 Skill 后的能力提升。
- 静态检查范围
- 记录 17 个文件 · 149,067 字符
- 只检查采集到的受限文本与已知风险模式;未读取的脚本、依赖和运行环境不在结论内。
- AI 内容复核
- 已使用
- 复核送评文本的说明和设计,不是安装测试或实际任务执行。记录缺失时不推断已使用或未使用。
- 真实任务效果
- 本报告未提供实测证据
- 没有使用/不使用 Skill 的任务对照、重复运行或耗时与 token 成本结果。采用前仍需在隔离环境验证自己的任务。
脚本引用覆盖
脚本引用覆盖记录不可得;不推断没有引用或已经检查。
Apollo技能包架构
展示技能包与安装方式、技能内容的关系
左右滑动查看完整图示
- • README提供三种安装方式
- • 技能列表包含11个技能
- • 每个技能有SKILL.md和references
- README列出11个技能及各自用途
- 安装命令:npx skills add apollographql/skills
- 每个技能有'Use when'和'Examples'部分
- 引用文档链接如skills/apollo-server/references/error-handling.md
- 许可证MIT标识
- 问题与用途描述
- 有效 README
- 安装或接入步骤
- 可执行示例
- 覆盖11个Apollo相关技能,场景具体
- 发现高风险的一键下载执行或安装命令
- 缺少输出或结果说明
- 未展示各SKILL.md的实际内容,无法验证深度
- 设计细节(如权限、错误处理)证据不足
- 部分技能安装命令不一致(如apollo-federation)
使用Apollo工具链的AI编码代理、需要快速接入Apollo技能的开发者、希望统一管理多个GraphQL相关技能的团队、需要参考Apollo最佳实践的Rust开发者
需要离线或非AI环境使用、需要深入了解每个技能内部实现细节的场景
也有自己的公开项目?先免登录查已有报告;没有报告时,可保留地址继续登录评测。
查找我项目的报告 →unsafe-install-commandskills/apollo-mcp-server/SKILL.md:27high confidencecurl -sSL https://mcp.apollo.dev/download/nix/latest | sh修复:固定版本与校验和,先下载审查再执行,避免管道直接交给 Shell。
unsafe-install-commandskills/rover/SKILL.md:29high confidencecurl -sSL https://rover.apollo.dev/nix/latest | sh修复:固定版本与校验和,先下载审查再执行,避免管道直接交给 Shell。
unsafe-install-commandskills/skill-creator/SKILL.md:350high confidence- NEVER include `Bash(curl:*)` in `allowed-tools` as it grants unrestricted network access and enables `curl | sh` remote code execution patterns修复:固定版本与校验和,先下载审查再执行,避免管道直接交给 Shell。
- 01固定版本与校验和,先下载审查再执行,避免管道直接交给 Shell。
- 02补充输出或结果说明
方法、证据与局限展开收起
GitHub Repository API
17 个文件 · 149,067 字符
v3.10.0 · AI 内容复核:已使用(deepseek-chat)
- 静态评测不会安装或执行项目代码
- 安全扫描基于高信号文件与已知模式,不能替代人工审计
- 流行度只反映采用程度,不代表安全或工程质量
30 天热度趋势
README
Apollo GraphQL Agent Skills
A collection of skills for AI coding agents working with Apollo GraphQL tools and technologies.
Apollo Skills follow the Agent Skills format and are available on skills.sh.
Installation
Install skills using the Skills CLI:
npx skills add apollographql/skills
The CLI guides you through an interactive installation:
- Select skills - Choose which skills to install
- Select agents - Pick target agents (Claude Code, Codex, Cursor, Gemini CLI, Goose, OpenCode)
- Installation scope - Project (committed with your code) or Global
- Installation method - Symlink (recommended) or Copy
◇ Found 11 skills
│
◆ Select skills to install
│ ◼ apollo-client
│ ◼ apollo-connectors
│ ◼ apollo-server
│ ○ ...
└
Claude Code Plugin
You can also install skills as a Claude Code plugin:
First, add the marketplace:
/plugin marketplace add apollographql/skills
Then, install the plugin:
/plugin install apollo-skills@apollo-marketplace
Once installed, skills are available as namespaced slash commands:
| Slash Command | Description |
|---|---|
/apollo-skills:apollo-client | Apollo Client 4.x for React — queries, mutations, caching, local state |
/apollo-skills:apollo-connectors | Deprecated — use /apollo-skills:graphos-factory instead |
/apollo-skills:apollo-ios | Apollo iOS — GraphQL client for Swift (iOS, macOS, tvOS, watchOS, visionOS) |
/apollo-skills:apollo-kotlin | Apollo Kotlin — GraphQL client for Android and Kotlin |
/apollo-skills:apollo-mcp-server | Apollo MCP Server — connect AI agents with GraphQL APIs |
/apollo-skills:apollo-server | Apollo Server 4.x — schemas, resolvers, auth, plugins |
/apollo-skills:graphos-factory | GraphOS Factory — build and iterate on an Apollo Connectors subgraph from a REST API |
/apollo-skills:graphql-operations | GraphQL operations — queries, mutations, fragments |
/apollo-skills:graphql-schema | GraphQL schema design — types, naming, pagination, errors |
/apollo-skills:rover | Rover CLI — schema management and local supergraph development |
/apollo-skills:rust-best-practices | Rust best practices — idiomatic Rust following Apollo conventions |
/apollo-skills:skill-creator | Skill creator — guide for creating new Apollo skills |
GitHub CLI
You can also install skills with the GitHub CLI using gh skill (preview):
# Install skills into the current project for Claude Code
gh skill install apollographql/skills --agent claude-code
# Install at user scope (available everywhere)
gh skill install apollographql/skills --agent claude-code --scope user
# Pin to a specific release (skipped during updates so it won't auto-upgrade)
gh skill install apollographql/skills --pin v1.0.0 --agent claude-code
# Preview skills before installing
gh skill preview apollographql/skills
--agent supports many hosts beyond Claude Code (Cursor, Codex, Gemini CLI, GitHub Copilot, and more); run gh skill install --help for the full list.
Releases
Releases are tagged with semver and published automatically whenever a content change is merged to main. The full list lives at github.com/apollographql/skills/releases.
| Install path | What you get |
|---|---|
gh skill install apollographql/skills <name> | Latest tagged release |
gh skill install apollographql/skills <name> --pin v1.0.0 | Pinned to a specific release (skipped during updates) |
npx skills add apollographql/skills@<name> | Latest content from main (no tag) |
Claude Code plugin (claude plugin install) | Latest plugin version (auto-updates via claude plugin update) |
If you need stability, pin via gh skill install … --pin vX.Y.Z. Pinned skills are skipped during gh skill upgrade, so you upgrade deliberately. For the freshest content, the other paths track main HEAD directly.
Available Skills
graphos-factory
Build and iterate on an Apollo Connectors subgraph for a GraphOS supergraph from a REST API, with or without an OpenAPI or Swagger spec. It works with any agent that can run shell commands (Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and others), and replaces the apollo-connectors skill. It is developed in apollographql/graphos-factory; skills/graphos-factory/ here is a read-only copy of its latest release, updated by that repository's release workflow.
Install:
npx skills add apollographql/skills@graphos-factory
Or from its own repository, with either CLI:
npx skills add apollographql/graphos-factory
gh skill install apollographql/graphos-factory graphos-factory --agent claude-code # or codex, cursor, github-copilot, ...
In Claude Code it is also part of the apollo-skills plugin, as /apollo-skills:graphos-factory. The first time the agent uses it, the skill downloads its graphos-factory binary (about 3 MB) from the release it ships with.
Use when:
- Wrapping a REST API as a GraphQL subgraph for your supergraph
- Adding or removing operations or fields on an existing connector subgraph
- Refreshing a connector subgraph against a new version of its spec
- Recording live API traffic as test fixtures
Categories covered:
- API discovery and spec intake (OpenAPI 3.x, Swagger 2.0, or no spec)
- Operation and field selection, recorded in a dedicated git workspace
- Connectors schema authoring, naming and mapping
- Verification: composition, connector unit tests, mocked end-to-end and live runs
- Design decisions and hand edits kept across regenerations
Examples:
- "Turn this REST API into a subgraph for my supergraph"
- "Build a connector subgraph from this OpenAPI spec"
- "Add the list-issues endpoint to my Gitea subgraph"
References: SKILL.md · README · Connectors Language · Mapping Language · Schema Authoring · Testing · Verification
apollo-federation
Author Apollo Federation subgraph schemas with entities, sharing, and cross-subgraph field resolution.
Install:
npx skills add apollographql/skills --skill apollo-federation
Use when:
- Creating new subgraph schemas for a federated supergraph
- Defining or modifying entities with
@key - Sharing types/fields across subgraphs with
@shareable - Working with federation directives (
@external,@requires,@provides,@override) - Troubleshooting composition errors
Categories covered:
- Entity definition and
@keypatterns (compound, multiple, differing) - Reference resolvers and computed fields
- Value types with
@shareable - Field migration with
@override(including progressive rollout) - Entity interfaces with
@interfaceObject - Common composition errors and fixes
Examples:
- "Create a federated subgraph for my products service"
- "Add a computed field that requires data from another subgraph"
- "Migrate this field from one subgraph to another"
References: SKILL.md · Directives · Schema Patterns · Composition
apollo-mcp-server
Configure and use Apollo MCP Server to connect AI agents with GraphQL APIs.
Install:
npx skills add apollographql/skills@apollo-mcp-server
Use when:
- Setting up Apollo MCP Server for Claude or other AI agents
- Defining MCP tools from GraphQL operations
- Using introspection tools (introspect, search, validate, execute)
- Troubleshooting MCP server connectivity issues
Categories covered:
- Server configuration (endpoints, schemas, headers)
- Built-in tools and compact notation
- Operation sources (files, collections, persisted queries)
- Authentication and security
- Health checks and debugging
Examples:
- "Set up Apollo MCP Server for my GraphQL endpoint"
- "Configure MCP tools from my GraphQL operations"
- "Debug MCP server connection issues"
References: SKILL.md · Tools · Configuration · Troubleshooting
apollo-router
Configure and run Apollo Router for federated GraphQL supergraphs.
Install:
npx skills add apollographql/skills@apollo-router
Use when:
- Setting up Apollo Router to run a supergraph
- Configuring routing, headers, or CORS
- Implementing custom plugins (Rhai scripts or coprocessors)
- Configuring telemetry and observability
- Troubleshooting Router performance or connectivity issues
Categories covered:
- Installation and quick start
- Router configuration (YAML)
- Header propagation and manipulation
- CORS and authentication
- Rhai scripts and coprocessors
- Telemetry (tracing, metrics, logging)
Examples:
- "Set up Apollo Router for my supergraph"
- "Configure CORS for my Router"
- "Add header propagation for authentication"
References: SKILL.md · Configuration · Headers · Plugins · Telemetry · Troubleshooting
apollo-server
Build GraphQL servers with Apollo Server 4.x, including schemas, resolvers, authentication, and plugins.
Install:
npx skills add apollographql/skills@apollo-server
Use when:
- Setting up a new Apollo Server project
- Writing resolvers or defining GraphQL schemas
- Implementing authentication or authorization
- Creating plugins or custom data sources
- Troubleshooting Apollo Server errors or performance issues
Categories covered:
- Quick start setup (standalone and Express)
- Schema definition and type system
- Resolver patterns and best practices
- Context and authentication
- Plugins and lifecycle hooks
- Data sources and DataLoader
- Error handling and formatting
Examples:
- "Create an Apollo Server with user authentication"
- "Write resolvers for my GraphQL schema"
- "Add a custom plugin to log all queries"
References: SKILL.md · Resolvers · Context & Auth · Plugins · Data Sources · Error Handling · Troubleshooting
apollo-client
Build React applications with Apollo Client 4.x for GraphQL data management, caching, and local state.
Install:
npx skills add apollographql/skills@apollo-client
Use when:
- Setting up Apollo Client in a React project
- Writing GraphQL queries or mutations with hooks
- Configuring caching or cache policies
- Managing local state with reactive variables
- Troubleshooting Apollo Client errors or performance issues
Categories covered:
- Quick start setup (install, client, provider, query)
- useQuery and useLazyQuery hooks
- useMutation with optimistic UI
- InMemoryCache and type policies
- Reactive variables and local state
- Error handling and error links
- Performance optimization
Examples:
- "Set up Apollo Client in my React app"
- "Implement optimistic UI for my mutation"
- "Configure cache policies for my queries"
References: SKILL.md · Queries · Mutations · Caching · State Management · Error Handling · Troubleshooting
apollo-ios
Build Apple-platform applications with Apollo iOS, the strongly-typed GraphQL client for Swift (iOS, macOS, tvOS, watchOS, visionOS).
Install:
npx skills add apollographql/skills@apollo-ios
Use when:
- Adding Apollo iOS to a Swift Package Manager or Xcode project
- Configuring
apollo-codegen-config.jsonand running code generation - Configuring an
ApolloClientwith auth, interceptors, and caching - Writing queries, mutations, or subscriptions from SwiftUI views
- Writing tests against generated operation mocks
Categories covered:
- SPM installation, product linking (
ApollovsApolloAPI), andapollo-ios-clisetup - Code generation config (
apollo-codegen-config.json) with the canonicalswiftPackage+relativedefaults - Custom scalars (default
Stringtypealias, when and how to replace it) - Queries, mutations, watchers, and cache policies with async/await
- Normalized cache,
@typePolicycache keys, manual reads/writes - Interceptor architecture split across HTTP and GraphQL layers (auth token attachment + token refresh + retry)
- Subscriptions over HTTP multipart and WebSocket, with scene-phase pause/resume
- Testing with
ApolloTestSupportand generatedMock<Type>fixtures (enabled lazily when tests need them)
Examples:
- "Set up Apollo iOS in a new SwiftUI app"
- "Add an auth token to every GraphQL request"
- "Subscribe to a GraphQL subscription from a SwiftUI view"
References: SKILL.md · Setup · Codegen · Custom Scalars · Operations · Caching · Interceptors · Subscriptions · Testing
apollo-kotlin
Build applications with Apollo Kotlin, the GraphQL client library for Android and Kotlin.
Install:
npx skills add apollographql/skills@apollo-kotlin
Use when:
- Setting up Apollo Kotlin in a Gradle project for Android, Kotlin/JVM, or KMP
- Configuring schema download and codegen for GraphQL services
- Configuring an
ApolloClientwith auth, interceptors, and caching - Writing queries, mutations, or subscriptions
Categories covered:
- Gradle plugin setup and service configuration
- Schema management and code generation
- ApolloClient configuration
- Coroutines and Flow usage patterns
- Normalized cache and cache policies
Examples:
- "Set up Apollo Kotlin in my Android app"
- "Configure code generation for multiple GraphQL services"
- "Add normalized caching for offline support"
References: SKILL.md · Setup · Operations · Caching ·
rover
Manage GraphQL schemas and run local supergraph development with Apollo Rover CLI.
Install:
npx skills add apollographql/skills@rover
Use when:
- Publishing or fetching subgraph schemas to/from GraphOS
- Composing supergraph schemas locally
- Running local supergraph development with rover dev
- Validating schemas with check and lint commands
Categories covered:
- Subgraph commands (fetch, publish, check, lint)
- Graph commands (monograph management)
- Supergraph composition
- Local development with rover dev
- Authentication and configuration
Examples:
- "Publish my subgraph schema to GraphOS"
- "Run rover dev to test my supergraph locally"
- "Check my schema changes before deploying"
References: SKILL.md · Subgraphs · Graphs · Supergraphs · Dev · Configuration
graphql-schema
Design GraphQL schemas following industry best practices for type design, naming, pagination, errors, and security.
Install:
npx skills add apollographql/skills@graphql-schema
Use when:
- Designing a new GraphQL schema or API
- Reviewing existing schema for improvements
- Deciding on type structures or nullability
- Implementing pagination or error patterns
- Ensuring security in schema design
Categories covered:
- Type design patterns (interfaces, unions, custom scalars)
- Naming conventions for types, fields, and arguments
- Cursor-based pagination (Connection pattern)
- Error modeling and result types
- Security best practices (depth limiting, complexity, authorization)
Examples:
- "Design a GraphQL schema for my e-commerce API"
- "Review my schema for best practices"
- "Add cursor-based pagination to my queries"
References: SKILL.md · Types · Naming · Pagination · Errors · Security
graphql-operations
Write GraphQL operations (queries, mutations, fragments) following best practices for client-side development.
Install:
npx skills add apollographql/skills@graphql-operations
Use when:
- Writing GraphQL queries or mutations
- Organizing operations with fragments
- Optimizing data fetching patterns
- Setting up type generation or linting
- Reviewing operations for efficiency
Categories covered:
- Query patterns and optimization
- Mutation patterns and error handling
- Fragment organization and colocation
- Variable usage and types
- Tooling (GraphQL Code Generator, ESLint, IDE extensions)
Examples:
- "Write a query with pagination"
- "Organize my operations with fragments"
- "Set up GraphQL Code Generator for type safety"
References: SKILL.md · Queries · Mutations · Fragments · Variables · Tooling
rust-best-practices
Write idiomatic Rust code following Apollo GraphQL's best practices handbook.
Install:
npx skills add apollographql/skills@rust-best-practices
Use when:
- Writing new Rust code or functions
- Reviewing or refactoring existing Rust code
- Deciding between borrowing vs cloning or ownership patterns
- Implementing error handling with Result types
- Optimizing Rust code for performance
- Writing tests or documentation for Rust projects
Categories covered:
- Coding style and idioms (borrowing, Option/Result, iterators)
- Clippy and linting discipline
- Performance optimization and profiling
- Error handling with thiserror and anyhow
- Testing strategies and snapshot testing
- Generics, static and dynamic dispatch
- Type state pattern for compile-time safety
- Documentation best practices
- Pointer types and thread safety
Examples:
- "Review this Rust code for best practices"
- "Help me decide between cloning and borrowing here"
- "Add proper error handling to this function"
References: SKILL.md · Style · Errors · Performance · Testing · Advanced
skill-creator
Guide for creating effective skills for Apollo GraphQL and GraphQL development.
Install:
npx skills add apollographql/skills@skill-creator
Use when:
- Creating a new skill for this repository
- Updating an existing skill's structure or content
- Learning skill best practices and patterns
- Writing SKILL.md files or reference documentation
Categories covered:
- SKILL.md format and frontmatter fields
- Directory structure and reference files
- Description writing for agent activation triggers
- Progressive disclosure and context optimization
- Apollo Voice writing style guidelines
- Validation checklist for new skills
Examples:
- "Create a new skill for Apollo Federation"
- "Help me write a SKILL.md for my custom skill"
- "Review my skill structure for best practices"
References: SKILL.md · Apollo Skills
apollo-connectors
Deprecated. Superseded by graphos-factory (
npx skills add apollographql/skills@graphos-factory). This skill will be removed in a future release.
Write Apollo Connectors schemas to integrate REST APIs into GraphQL.
Install:
npx skills add apollographql/skills@apollo-connectors
Usage
Skills activate automatically once installed. The agent uses them when relevant tasks are detected.
You can also explicitly invoke a skill depending on your tool:
| Tool | Automatic | Explicit Invocation |
|---|---|---|
| Claude Code | Yes | Slash command (e.g., /graphql-schema or /apollo-skills:graphql-schema via plugin) |
| GitHub Copilot | Yes | /agent for custom agents, @github for GitHub skills |
| Cursor | Yes | Rules matched by file patterns (no direct invocation) |
| Windsurf | Yes | Slash command for workflows (e.g., /workflow-name) |
Skill Structure
Each skill contains:
SKILL.md- Instructions for the agent (required)references/- Supporting documentation (optional)
Resources
- Apollo Client Documentation
- Apollo Server Documentation
- Apollo Connectors Documentation
- Apollo Federation Documentation
- Apollo MCP Server
- Apollo iOS Documentation
- Rover CLI Documentation
- Rust Best Practices Handbook
Disclaimer
The code in this repository is experimental and for reference purposes only. Community feedback is welcome but this project is not officially supported in the same way that repositories in the official Apollo GraphQL GitHub organization are. If you need help you can file an issue on this repository, contact Apollo to talk to an expert, or create a ticket directly in Apollo Studio.