Skip to main content
skill CX Codex

graphql-schema · chriswiles — Claude Code skill: features and install

The graphql-schema skill sets conventions for GraphQL queries, mutations, and type generation. It fits projects that use Apollo Client.

no license ★ 6,091 updated 2026-01-06

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a claude-code
Open on GitHub

What graphql-schema does

The skill keeps GraphQL operations in separate .gql files and routes type generation through npm run gql:typegen or npm run sync-types. Application code should use the generated hooks rather than hand-written Apollo hooks. Generated output is treated as read-only.

Mutation guidance covers error callbacks, success feedback, loading indicators, and disabling the trigger while a request is active. It also lays out fragments, cache policies, conditional queries, polling, and optimistic updates. The examples connect these rules to React-style UI states.

If npm run gql:typegen is skipped after a .gql change, the generated hooks will remain out of date.

What it helps with

  • move GraphQL operations into .gql files
  • generate typed hooks from the schema
  • handle mutation failures in the UI
  • show loading and success states for submissions
  • choose cache and optimistic-update behavior

Example prompts for the agent

  • Create a GraphQL item-list query in a separate .gql file and wire it through the generated hook.
  • Add a create-record mutation with failure handling, success feedback, and a loading state.
  • Tell me which code generation command to run after changing a .gql file, then update the generated types.

How to install graphql-schema

1Skills CLI (Vercel)

npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a claude-code

2Manually: put the files in place

~/.claude/skills/graphql-schema/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/graphql-schema/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about graphql-schema

How do I install graphql-schema in Claude Code?

Run npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a claude-code, then use the skill file at ~/.claude/skills/graphql-schema/SKILL.md.

What does graphql-schema do?

It sets conventions for GraphQL operations: separate .gql files, generated types, and generated Apollo hooks. It also covers mutation errors, UI states, fragments, caching, and optimistic updates.

Which command should I run after editing a .gql file?

Run npm run gql:typegen to refresh types and hooks. If the schema must be downloaded first, use npm run sync-types.

Similar skills

All skills for Frontend and UI →

graphql-schema by other authors comes first.

graphql-schema apollographql graphql-schema guides GraphQL SDL schema design following Apollo best practices. Useful when creating schema.graphql, adding mutations, or setting up pagination. CX Codex +1 4,500installs react-graphql-apollo-client-cursorrules-prompt-file PatrickJS react-graphql-apollo-client-cursorrules-prompt-file is a Cursor rule guiding React work with GraphQL and Apollo Client. It defines consistent patterns for operations, hooks, and error states. CX Codex +1 ★ 41,178repo stars graphql bobmatnyc Reference skill for GraphQL: guides your coding agent through SDL schema design, Apollo Server resolvers, and Apollo Client queries. CX Codex +1 348installs graphql-operations apollographql graphql-operations — 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,900installs graphql-schema-designer patricio0312rev graphql-schema-designer is a Claude Code skill for shaping GraphQL APIs with types, queries, mutations, subscriptions, and resolvers. It activates for requests about schema design, GraphQL setup, or Apollo Server. CX Codex +1 230installs GraphQL API taste f GraphQL API taste — a prompt that steers an agent to shape a GraphQL schema from client use cases rather than database tables. Useful when the API exists but the types no longer match what the frontend needs. GP ChatGPT ★ 178,201repo stars apollo-graphql Mindrally apollo-graphql — 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 718installs

From the same set11

The whole set →
pr-review pr-review inspects pull requests through the GitHub CLI against project standards and posts tiered review notes. CX Codex +1 ★ 6,091repo stars code-quality code-quality reviews TypeScript files in a chosen directory, runs npm checks, and groups findings by severity. Use it before a code change or review. CX Codex +1 ★ 6,091repo stars docs-sync docs-sync is a Claude Code command that compares documentation with recent code changes and flags inconsistencies. It catches outdated examples, incorrect API signatures, and mismatched parameter types. CX Codex +1 ★ 6,091repo stars github-workflow github-workflow manages Git branches, Conventional Commits, and pull requests according to team conventions. Helpful for keeping repository history structured and tidy. CX Codex ★ 6,091repo stars ticket Handles the full ticket workflow: fetch task details from JIRA or Linear, explore related code, implement changes, and create a linked PR. Reduces manual sync between issue tracker and repository. CX Codex +1 ★ 6,091repo stars code-reviewer code-reviewer — a subagent for Claude Code that checks newly written or modified code against project standards, TypeScript strict mode, and security patterns. CX Codex ★ 6,091repo stars systematic-debugging systematic-debugging enforces a four-phase troubleshooting protocol rooted in root cause analysis. Ideal for tracking down broken test suites or runtime errors without trial-and-error edits. CX Codex +1 ★ 6,091repo stars formik-patterns formik-patterns adds Formik form recipes to Claude: Yup schemas, field handlers, a submit flow and multi-step forms. CX Codex +1 ★ 6,091repo stars

Project sponsors

Companies that keep this analytics open