graphos-tools

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:

1. Select skills - Choose which skills to install
2. Select agents - Pick target agents (Claude Code, Codex, Cursor, Gemini CLI, Goose, OpenCode)
3. Installation scope - Project (committed with your code) or Global
4. 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:

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.

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 @key patterns (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