{"id":"f1522992-5a38-42f1-aeb2-fd994652f9d4","shortId":"vWCdta","kind":"skill","title":"rover","tagline":"Guide for using Apollo Rover CLI to manage GraphQL schemas and federation. Use this skill when: (1) publishing or fetching subgraph/graph schemas, (2) composing supergraph schemas locally or via GraphOS, (3) running local supergraph development with rover dev, (4) validating sche","description":"# Apollo Rover CLI Guide\n\nRover is the official CLI for Apollo GraphOS. It helps you manage schemas, run composition locally, publish to GraphOS, and develop supergraphs on your local machine.\n\n## Quick Start\n\n### Step 1: Install\n\n```bash\n# macOS/Linux\ncurl -sSL https://rover.apollo.dev/nix/latest | sh\n\n# npm (cross-platform)\nnpm install -g @apollo/rover\n\n# Windows PowerShell\niwr 'https://rover.apollo.dev/win/latest' | iex\n```\n\n### Step 2: Authenticate\n\n```bash\n# Interactive authentication (opens browser)\nrover config auth\n\n# Or set environment variable\nexport APOLLO_KEY=your-api-key\n```\n\n### Step 3: Verify Installation\n\n```bash\nrover --version\nrover config whoami\n```\n\n## Core Commands Overview\n\n| Command | Description | Use Case |\n|---------|-------------|----------|\n| `rover subgraph publish` | Publish subgraph schema to GraphOS | CI/CD, schema updates |\n| `rover subgraph check` | Validate schema changes | PR checks, pre-deploy |\n| `rover subgraph fetch` | Download subgraph schema | Local development |\n| `rover supergraph compose` | Compose supergraph locally | Local testing |\n| `rover dev` | Local supergraph development | Development workflow |\n| `rover graph publish` | Publish monograph schema | Non-federated graphs |\n\n## Graph Reference Format\n\nMost commands require a graph reference in the format:\n\n```\n<GRAPH_ID>@<VARIANT>\n```\n\nExamples:\n- `my-graph@production`\n- `my-graph@staging`\n- `my-graph@current` (default variant)\n\nSet as environment variable:\n```bash\nexport APOLLO_GRAPH_REF=my-graph@production\n```\n\n## Subgraph Workflow\n\n### Publishing a Subgraph\n\n```bash\n# From schema file\nrover subgraph publish my-graph@production \\\n  --name products \\\n  --schema ./schema.graphql \\\n  --routing-url https://products.example.com/graphql\n\n# From running server (introspection)\nrover subgraph publish my-graph@production \\\n  --name products \\\n  --schema <(rover subgraph introspect http://localhost:4001/graphql) \\\n  --routing-url https://products.example.com/graphql\n```\n\n### Checking Schema Changes\n\n```bash\n# Check against production traffic\nrover subgraph check my-graph@production \\\n  --name products \\\n  --schema ./schema.graphql\n```\n\n### Fetching Schema\n\n```bash\n# Fetch from GraphOS\nrover subgraph fetch my-graph@production --name products\n\n# Introspect running server\nrover subgraph introspect http://localhost:4001/graphql\n```\n\n## Supergraph Composition\n\n### Local Composition\n\nCreate `supergraph.yaml`:\n\n```yaml\nfederation_version: =2.9.0\nsubgraphs:\n  products:\n    routing_url: http://localhost:4001/graphql\n    schema:\n      file: ./products/schema.graphql\n  reviews:\n    routing_url: http://localhost:4002/graphql\n    schema:\n      subgraph_url: http://localhost:4002/graphql\n```\n\nCompose:\n```bash\nrover supergraph compose --config supergraph.yaml > supergraph.graphql\n```\n\n### Fetch Composed Supergraph\n\n```bash\nrover supergraph fetch my-graph@production\n```\n\n## Local Development with `rover dev`\n\nStart a local Router with automatic schema composition:\n\n```bash\n# Start with supergraph config\nrover dev --supergraph-config supergraph.yaml\n\n# Start with GraphOS variant as base\nrover dev --graph-ref my-graph@staging --supergraph-config local.yaml\n```\n\n### With MCP Integration\n\n```bash\n# Start with MCP server enabled\nrover dev --supergraph-config supergraph.yaml --mcp\n```\n\n## Reference Files\n\nDetailed documentation for specific topics:\n\n- [Subgraphs](references/subgraphs.md) - fetch, publish, check, lint, introspect, delete\n- [Graphs](references/graphs.md) - monograph commands (non-federated)\n- [Supergraphs](references/supergraphs.md) - compose, fetch, config format\n- [Dev](references/dev.md) - rover dev for local development\n- [Configuration](references/configuration.md) - install, auth, env vars, profiles\n\n## Common Patterns\n\n### CI/CD Pipeline\n\n```bash\n# 1. Check schema changes\nrover subgraph check $APOLLO_GRAPH_REF \\\n  --name $SUBGRAPH_NAME \\\n  --schema ./schema.graphql\n\n# 2. If check passes, publish\nrover subgraph publish $APOLLO_GRAPH_REF \\\n  --name $SUBGRAPH_NAME \\\n  --schema ./schema.graphql \\\n  --routing-url $ROUTING_URL\n```\n\n### Schema Linting\n\n```bash\n# Lint against GraphOS rules\nrover subgraph lint --name products ./schema.graphql\n\n# Lint monograph\nrover graph lint my-graph@production ./schema.graphql\n```\n\n### Output Formats\n\n```bash\n# JSON output for scripting\nrover subgraph fetch my-graph@production --name products --format json\n\n# Plain output (default)\nrover subgraph fetch my-graph@production --name products --format plain\n```\n\n## Ground Rules\n\n- ALWAYS authenticate before using GraphOS commands (`rover config auth` or `APOLLO_KEY`)\n- ALWAYS use the correct graph reference format: `graph@variant`\n- PREFER `rover subgraph check` before `rover subgraph publish` in CI/CD\n- USE `rover dev` for local supergraph development instead of running Router manually\n- NEVER commit `APOLLO_KEY` to version control; use environment variables\n- USE `--format json` when parsing output programmatically\n- SPECIFY `federation_version` explicitly in supergraph.yaml for reproducibility\n- USE `rover subgraph introspect` to extract schemas from running services","tags":["rover","skills","apollographql","agent-skills","apollo","graphql"],"capabilities":["skill","source-apollographql","skill-rover","topic-agent-skills","topic-apollo","topic-graphql"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/apollographql/skills/rover","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add apollographql/skills","source_repo":"https://github.com/apollographql/skills","install_from":"skills.sh"}},"qualityScore":"0.736","qualityRationale":"deterministic score 0.74 from registry signals: · indexed on github topic:agent-skills · official publisher · 71 github stars · SKILL.md body (5,127 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:57:02.366Z","embedding":null,"createdAt":"2026-04-18T20:36:34.453Z","updatedAt":"2026-05-18T18:57:02.366Z","lastSeenAt":"2026-05-18T18:57:02.366Z","tsv":"'/graphql':260,285 '/nix/latest':84 '/products/schema.graphql':346 '/schema.graphql':254,304,496,512,530,540 '/win/latest''':99 '1':18,76,482 '2':24,102,497 '2.9.0':337 '3':32,124 '4':40 '4001/graphql':279,327,343 '4002/graphql':351,356 'alway':575,587 'api':121 'apollo':5,43,53,117,228,489,505,585,620 'apollo/rover':93 'auth':111,473,583 'authent':103,106,576 'automat':386 'base':405 'bash':78,104,127,226,240,289,307,358,368,389,422,481,520,543 'browser':108 'case':139 'chang':156,288,485 'check':153,158,286,290,296,446,483,488,499,599 'ci/cd':148,479,605 'cli':7,45,51 'command':134,136,199,453,580 'commit':619 'common':477 'compos':25,172,173,357,361,366,459 'composit':61,329,331,388 'config':110,131,362,393,398,417,432,461,582 'configur':470 'control':624 'core':133 'correct':590 'creat':332 'cross':88 'cross-platform':87 'curl':80 'current':219 'default':220,561 'delet':449 'deploy':161 'descript':137 'detail':437 'dev':39,179,380,395,407,429,463,466,608 'develop':36,67,169,182,183,377,469,612 'document':438 'download':165 'enabl':427 'env':474 'environ':114,224,626 'exampl':207 'explicit':638 'export':116,227 'extract':648 'feder':13,193,335,456,636 'fetch':21,164,305,308,313,365,371,444,460,550,564 'file':243,345,436 'format':197,206,462,542,557,571,593,629 'g':92 'graph':186,194,195,202,210,214,218,229,233,249,270,299,316,374,409,413,450,490,506,534,538,553,567,591,594 'graph-ref':408 'grapho':31,54,65,147,310,402,523,579 'graphql':10 'ground':573 'guid':2,46 'help':56 'iex':100 'instal':77,91,126,472 'instead':613 'integr':421 'interact':105 'introspect':264,277,320,325,448,646 'iwr':96 'json':544,558,630 'key':118,122,586,621 'lint':447,519,521,527,531,535 'local':28,34,62,71,168,175,176,180,330,376,383,468,610 'local.yaml':418 'localhost':278,326,342,350,355 'machin':72 'macos/linux':79 'manag':9,58 'manual':617 'mcp':420,425,434 'monograph':189,452,532 'my-graph':208,212,216,231,247,268,297,314,372,411,536,551,565 'name':251,272,301,318,492,494,508,510,528,555,569 'never':618 'non':192,455 'non-feder':191,454 'npm':86,90 'offici':50 'open':107 'output':541,545,560,633 'overview':135 'pars':632 'pass':500 'pattern':478 'pipelin':480 'plain':559,572 'platform':89 'powershel':95 'pr':157 'pre':160 'pre-deploy':159 'prefer':596 'product':211,234,250,252,271,273,292,300,302,317,319,339,375,529,539,554,556,568,570 'products.example.com':259,284 'products.example.com/graphql':258,283 'profil':476 'programmat':634 'publish':19,63,142,143,187,188,237,246,267,445,501,504,603 'quick':73 'ref':230,410,491,507 'refer':196,203,435,592 'references/configuration.md':471 'references/dev.md':464 'references/graphs.md':451 'references/subgraphs.md':443 'references/supergraphs.md':458 'reproduc':642 'requir':200 'review':347 'rout':256,281,340,348,514,516 'router':384,616 'routing-url':255,280,513 'rover':1,6,38,44,47,109,128,130,140,151,162,170,178,185,244,265,275,294,311,323,359,369,379,394,406,428,465,486,502,525,533,548,562,581,597,601,607,644 'rover.apollo.dev':83,98 'rover.apollo.dev/nix/latest':82 'rover.apollo.dev/win/latest''':97 'rule':524,574 'run':33,60,262,321,615,651 'sche':42 'schema':11,23,27,59,145,149,155,167,190,242,253,274,287,303,306,344,352,387,484,495,511,518,649 'script':547 'server':263,322,426 'servic':652 'set':113,222 'sh':85 'skill':16 'skill-rover' 'source-apollographql' 'specif':440 'specifi':635 'ssl':81 'stage':215,414 'start':74,381,390,400,423 'step':75,101,123 'subgraph':141,144,152,163,166,235,239,245,266,276,295,312,324,338,353,442,487,493,503,509,526,549,563,598,602,645 'subgraph/graph':22 'supergraph':26,35,68,171,174,181,328,360,367,370,392,397,416,431,457,611 'supergraph-config':396,415,430 'supergraph.graphql':364 'supergraph.yaml':333,363,399,433,640 'test':177 'topic':441 'topic-agent-skills' 'topic-apollo' 'topic-graphql' 'traffic':293 'updat':150 'url':257,282,341,349,354,515,517 'use':4,14,138,578,588,606,625,628,643 'valid':41,154 'var':475 'variabl':115,225,627 'variant':221,403,595 'verifi':125 'version':129,336,623,637 'via':30 'whoami':132 'window':94 'workflow':184,236 'yaml':334 'your-api-key':119","prices":[{"id":"7f0eed26-7e50-42da-a0f5-cc83c1d26010","listingId":"f1522992-5a38-42f1-aeb2-fd994652f9d4","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"apollographql","category":"skills","install_from":"skills.sh"},"createdAt":"2026-04-18T20:36:34.453Z"}],"sources":[{"listingId":"f1522992-5a38-42f1-aeb2-fd994652f9d4","source":"github","sourceId":"apollographql/skills/rover","sourceUrl":"https://github.com/apollographql/skills/tree/main/skills/rover","isPrimary":false,"firstSeenAt":"2026-04-18T22:17:27.468Z","lastSeenAt":"2026-05-18T18:57:02.366Z"},{"listingId":"f1522992-5a38-42f1-aeb2-fd994652f9d4","source":"skills_sh","sourceId":"apollographql/skills/rover","sourceUrl":"https://skills.sh/apollographql/skills/rover","isPrimary":true,"firstSeenAt":"2026-04-18T20:36:34.453Z","lastSeenAt":"2026-05-07T22:40:41.140Z"}],"details":{"listingId":"f1522992-5a38-42f1-aeb2-fd994652f9d4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"apollographql","slug":"rover","github":{"repo":"apollographql/skills","stars":71,"topics":["agent-skills","apollo","graphql"],"license":"mit","html_url":"https://github.com/apollographql/skills","pushed_at":"2026-05-14T17:14:05Z","description":"Apollo GraphQL Agent Skills","skill_md_sha":"218abfe64eeb7a6aefc00df08e2bed77bbf2bb04","skill_md_path":"skills/rover/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/apollographql/skills/tree/main/skills/rover"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"rover","license":"MIT","description":"Guide for using Apollo Rover CLI to manage GraphQL schemas and federation. Use this skill when: (1) publishing or fetching subgraph/graph schemas, (2) composing supergraph schemas locally or via GraphOS, (3) running local supergraph development with rover dev, (4) validating schemas with check and lint commands, (5) configuring Rover authentication and environment.","compatibility":"Node.js v18+, Linux/macOS/Windows"},"skills_sh_url":"https://skills.sh/apollographql/skills/rover"},"updatedAt":"2026-05-18T18:57:02.366Z"}}