# apollo-router

> Claude/Codex skill by [@apollographql](https://omgskills.com/library/apollographql/index.md) · 123 stars · Updated 2026-11-01

Version-aware guide for configuring and running Apollo Router for federated GraphQL supergraphs. Generates correct YAML for both Router v1.x and v2.x. Use this skill when: (1) setting up Apollo Router to run a supergraph, (2) configuring routing, headers, or CORS, (3) implementing custom plugins (Rhai scripts or coprocessors), (4) configuring telemetry (tracing, metrics, logging), (5) troubleshooting Router performance or connectivity issues, (6) securing the graph with JWT, declarative field-level authorization directives, or persisted-query safelisting, (7) managing router.yaml as version-controlled config with CI/CD validation.

Tags: agent-skills, apollo, graphql

## Install

```sh
git clone https://github.com/apollographql/skills /tmp/skills && ln -s /tmp/skills/skills/apollo-router ~/.claude/skills/apollo-router
```

## From README

Apollo Router Config Generator Apollo Router is a high-performance graph router written in Rust for running Apollo Federation 2 supergraphs. It sits in front of your subgraphs and handles query planning, execution, and response composition. This skill generates version-correct configuration. Router v1 and v2 have incompatible config schemas in several critical sections (CORS, JWT auth, connectors). Always determine the target version before generating any config. Step 1: Version Selection Ask the user before generating any config: If the user picks \[3\], display: Store the selection as ROUTERVERSION=v1|v2 to gate all subsequent template generation. Step 2: Environment Selection Ask: Production or Development?

## Links

- HTML page: https://omgskills.com/library/apollographql/skills/apollo-router/
- GitHub: https://github.com/apollographql/skills
- Author: [@apollographql](https://omgskills.com/library/apollographql/index.md)

## More from this repo

- [apollo-client](https://omgskills.com/library/apollographql/skills/skills/apollo-client/index.md) — Guide for building React applications with Apollo Client 4.x.
   - [@apollographql](https://omgskills.com/library/apollographql/index.md) · 123 stars
- [apollo-connectors](https://omgskills.com/library/apollographql/skills/apollo-connectors/index.md) — DEPRECATED: superseded by the graphos-factory skill (npx skills add apollographql/skills@graphos-factory), which builds...
   - [@apollographql](https://omgskills.com/library/apollographql/index.md) · 123 stars
- [apollo-federation](https://omgskills.com/library/apollographql/skills/skills/apollo-federation/index.md) — Guide for authoring Apollo Federation subgraph schemas.
   - [@apollographql](https://omgskills.com/library/apollographql/index.md) · 123 stars