Apollo GraphQL Agent Skills

A collection of skills for AI coding agents working with Apollo GraphQL tools and technologies.

Skills follow the Agent Skills format and are available on skill.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 7 skills
│
◆  Select skills to install
│  ◼ apollo-client
│  ◼ apollo-connectors
│  ◼ apollo-server
│  ○ ...
└

◇  Detected 6 agents
│
◆  Select agents to install skills to
│  ◼ Claude Code (.claude/skills)
│  ◼ Cursor
│  ○ ...
└

Or in Claude Code:

/install-skill https://github.com/apollographql/skills

Available Skills

apollo-connectors

Write Apollo Connectors schemas to integrate REST APIs into GraphQL.

Install:

# Skills CLI
npx skills add https://github.com/apollographql/skills --skill apollo-connectors

# Claude Code
/install-skill https://github.com/apollographql/skills --skill apollo-connectors

# Manual: Copy skills/apollo-connectors to your .claude/skills directory

Use when:

• Connecting REST APIs to a GraphQL supergraph
• Writing @source and @connect directives
• Implementing entity resolvers with batching
• Validating connector schemas with rover

Categories covered:

• Selection mapping grammar
• HTTP methods and headers
• Variable interpolation ($args, $this, $config)
• Entity patterns and @key directives
• Batch requests with @listSize

Examples:

• "Connect my REST API to my GraphQL schema"
• "Write a connector for this OpenAPI spec"
• "Add entity resolvers with batching for my users endpoint"

References: SKILL.md · Grammar · Methods · Variables · Entities · Validation · Troubleshooting

---

apollo-mcp-server

Configure and use Apollo MCP Server to connect AI agents with GraphQL APIs.

Install:

# Skills CLI
npx skills add https://github.com/apollographql/skills --skill apollo-mcp-server

# Claude Code
/install-skill https://github.com/apollographql/skills --skill apollo-mcp-server

# Manual: Copy skills/apollo-mcp-server to your .claude/skills directory

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-server

Build GraphQL servers with Apollo Server 4.x, including schemas, resolvers, authentication, and plugins.

Install:

# Skills CLI
npx skills add https://github.com/apollographql/skills --skill apollo-server

# Claude Code
/install-skill https://github.com/apollographql/skills --skill apollo-server

# Manual: Copy skills/apollo-server to your .claude/skills directory

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](skill

...