Agent Skill
2/7/2026

graphql-federation

GraphQL Federation skill for creating correct federation subgraphs. Use when: (1) Creating new federation subgraphs, (2) Adding entities with @key directives, (3) Extending types across subgraphs, (4) Using federation directives (@shareable, @external, @override, @provides, @requires, @inaccessible, @interfaceObject, @authenticated, @requiresScopes), (5) Debugging composition errors, (6) Understanding federation rules and patterns. MANDATORY TRIGGERS: federation, subgraph, @key, entity, federated graph, supergraph, GraphQL composition, router schema

W
wundergraph
5GitHub Stars
1Views
npx skills add wundergraph/graphql-federation-skill

SKILL.md

Namegraphql-federation
DescriptionGraphQL Federation skill for creating correct federation subgraphs. Use when: (1) Creating new federation subgraphs, (2) Adding entities with @key directives, (3) Extending types across subgraphs, (4) Using federation directives (@shareable, @external, @override, @provides, @requires, @inaccessible, @interfaceObject, @authenticated, @requiresScopes), (5) Debugging composition errors, (6) Understanding federation rules and patterns. MANDATORY TRIGGERS: federation, subgraph, @key, entity, federated graph, supergraph, GraphQL composition, router schema

GraphQL Federation Skill for Claude Code

A Claude Code skill that teaches Claude how to write correct GraphQL Federation schemas with WunderGraph Cosmo or Apollo Federation.

What it covers

  • Federation directives (@key, @shareable, @external, @requires, @provides, @override, @inaccessible, @interfaceObject)
  • Authorization directives (@authenticated, @requiresScopes)
  • Composition validation rules and how to fix violations
  • Entity design and cross-subgraph resolution patterns
  • Real-world multi-subgraph architecture patterns

Install

/plugin marketplace add wundergraph/graphql-federation-skill
/plugin install graphql-federation@wundergraph-graphql-federation

Usage

Once installed, Claude Code automatically activates the skill when you work on GraphQL Federation tasks. You can also invoke it explicitly:

Use the graphql-federation skill to create an entity type for my user service

What's Included

FileDescription
skills/graphql-federation/SKILL.mdCore skill with essential directives, patterns, and error prevention
skills/graphql-federation/references/directives.mdComplete specification of all 14 federation directives
skills/graphql-federation/references/composition-rules.mdAll validation rules for successful composition
skills/graphql-federation/references/patterns.mdAdvanced patterns for real-world federation scenarios

License

Apache-2.0

Skills Info
Original Name:graphql-federationAuthor:wundergraph