Skip to main content
affpapa.org
RU EN
subagent

graphql-performance-optimizer — Claude Code subagent for GraphQL speed

A subagent that digs into slow GraphQL queries: finds N+1 patterns, wires up DataLoader, sets caching. Useful when a user list page drags for seconds.

Install into Claude Code · claude-code-templates All methods and platforms ↓ 
npx claude-code-templates@latest --agent api-graphql/graphql-performance-optimizer
Open on GitHub

What graphql-performance-optimizer does

The subagent works on existing code. It reads resolver files, spots per-record database calls and rewrites them to batched loading with DataLoader. The schema stays untouched. It can also turn on Automatic Persisted Queries in Apollo Server, point APQ at a Redis store and add field-level cache-control so a CDN serves the short GET responses.

Federated graphs get a different set of moves: query plan caching at the router, DataLoader instances scoped to each request context, and batch loading through __resolveReference for entities. That collapses the cross-subgraph fetches behind high p95 latency.

Its tools are Read, Grep, Glob, Edit, Write, Bash, the model is sonnet, and the permission mode is acceptEdits. It edits files on its own, so keep the project under git before you run it. One caveat: security work — query allowlisting, authorization caching, introspection control — is out of scope, that belongs to graphql-security-specialist.

What it helps with

  • find an N+1 in a resolver and rewrite it with DataLoader
  • cut origin hits on a public API
  • cache the query plan in a federated graph
  • drop the extra SELECT COUNT(*) behind connection fields
  • compare query counts before and after a fix

Example prompts for the agent

  • Find the N+1 in our user list resolvers and rewrite them with DataLoader
  • Set up APQ and CDN caching for our Apollo Server
  • Add router query plan caching and batch entity loading

How to install graphql-performance-optimizer

1claude-code-templates

npx claude-code-templates@latest --agent api-graphql/graphql-performance-optimizer

2Manually: put the files in place

.claude/agents/graphql-performance-optimizer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about graphql-performance-optimizer

How do I install graphql-performance-optimizer in Claude?

Through the templates CLI: npx claude-code-templates@latest --agent api-graphql/graphql-performance-optimizer. The agent file lands at .claude/agents/graphql-performance-optimizer.md.

What does graphql-performance-optimizer do?

It analyzes GraphQL API performance and edits the code: N+1 in resolvers, caching strategies, batched entity loading. It leaves the schema alone.

Does it handle security topics?

No. Query allowlisting, authorization caching and introspection control are left to the graphql-security-specialist agent.

Similar subagents

All subagents for Backend and APIs →
graphql-implementation secondsky A skill for building GraphQL APIs: schema, resolvers, error codes and N+1 protection. Useful when moving off REST or adding real-time subscriptions. CX Codex +1 380installs apollo-graphql Mindrally A skill that gives the agent rules for Apollo Client work: queries, mutations, fragments, caching and optimistic updates in React GraphQL apps. CX Codex +1 677installs graphql-architect VoltAgent Community Designs GraphQL schemas for microservices, federation, and distributed graphs. Use it when an API needs structured evolution or query analysis. 1,038installs neo4j-graphql-skill neo4j-contrib A skill that walks your agent through building a GraphQL API on @neo4j/graphql: type definitions, directives, JWT auth and Apollo Server wiring. CX Codex +1 809installs graphql-schema apollographql Guides GraphQL SDL schema design following Apollo best practices. Useful when creating schema.graphql, adding mutations, or setting up pagination. CX Codex +1 4,000installs graphql-operations apollographql A skill that keeps your agent writing GraphQL queries, mutations and fragments against the real schema. Useful when it starts inventing field names. CX Codex +1 3,600installs

From the same set205

The whole set →
performance-audit Audits codebase performance, locating slow database queries, nested loops, and build bottlenecks. Prioritizes optimizations by system impact and implementation effort. 661installs setup-development-environment A slash command that builds out a dev environment: runtimes, tooling, build setup, linters, configs. Handy when you spin up a project on a fresh machine. 651installs scientific-critical-thinking Checks methodology, statistics and bias in research papers using GRADE and Cochrane ROB. Useful for paper reviews and systematic reviews. 644installs test-coverage A Claude slash command that measures test coverage, finds uncovered branches and suggests which tests to add. 637installs nextjs-bundle-analyzer A Claude slash command that breaks down your Next.js bundle size and points at what to trim. 560installs frontend-dev-guidelines A skill that gives the agent one set of rules for React and TypeScript work: Suspense, lazy loading, features layout, MUI v7 and TanStack. 556installs text-comparison-validator A subagent that checks extracted text against an existing markdown file, line by line. It flags missing words, typos, formatting drift and paragraph structure problems, then reports them with line numbers. 545installs claude-d3js-skill Tells the agent how to build non-standard d3.js visualisations: network graphs, geographic maps, choreographed transitions. Useful when off-the-shelf charting libraries fall short. 531installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor