Skip to content
Get packs

GraphQL Architect

Design GraphQL schemas, Apollo Federation setups, resolvers and real-time subscriptions.

Source Download skill
Repository
Jeffallan/claude-skills
Stars
12,176
Licence
MIT
Files
7 files

What it does

When installed, this skill makes the agent work like a GraphQL API architect. It guides the agent to model business data as a GraphQL schema, split it across services with Apollo Federation, write resolvers that avoid repeated database lookups (using DataLoader), add query complexity and depth limits, and set up real-time subscriptions. It bundles reference notes on schema design, resolvers, federation, subscriptions, security and migrating from REST, and includes sample schema, resolver and complexity-check code for the agent to adapt.

Great for

  • Backend developers designing a new GraphQL API or schema
  • Teams splitting a monolith into multiple services using Apollo Federation
  • Developers who need to fix N+1 query performance problems in existing resolvers
  • Engineers migrating a REST API to GraphQL

Skip it if

  • Non-developers or anyone without an existing GraphQL server, since the output is code that must be run and maintained by someone technical
  • Production systems where generated schemas and security rules are deployed without review, because the skill's guidance is generic and must be checked against your actual data and auth model

Try asking

  • “Design a GraphQL schema for an e-commerce catalog with products, reviews and users split across two Apollo Federation subgraphs”
  • “Add DataLoader batching to my resolvers to fix N+1 queries on the orders endpoint”
  • “Set up query complexity and depth limits for my Apollo Server”
  • “Add real-time order status updates using GraphQL subscriptions over WebSocket”
Step-by-step guide: how to use GraphQL ArchitectInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 7 original files, the MIT licence and an attribution note.

    graphql-architect.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip graphql-architect.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip graphql-architect.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent your existing schema or service list up front so it designs against your real types rather than generic examples.
  • Ask it to run schema composition and complexity checks, and review the thresholds it proposes against your actual query patterns.
  • Treat the authorization and security advice as a starting checklist and verify field-level auth against your own access rules before deploying.

What's inside

  • references/federation.md
  • references/migration-from-rest.md
  • references/resolvers.md
  • references/schema-design.md
  • references/security.md
  • references/subscriptions.md
  • SKILL.md

Redistributed unmodified from Jeffallan/claude-skills under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.