graphql-schema agent skill by apollographql

At a glance

Before you install

Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

• Bundled scripts: none.
• Tool permissions requested: Bash(npm:*) Bash(npx:*) Read Write Edit Glob Grep (the allowed-tools field of SKILL.md).
• License: MIT, an open-source or open-content license.

Install graphql-schema

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

npx skills add https://github.com/apollographql/skills/tree/main/skills/graphql-schema

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/apollographql/skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/graphql-schema .claude/skills/
rm -rf "$tmp"

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
    --repo apollographql/skills \
    --path skills/graphql-schema

apollographql/skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Guide for designing and changing GraphQL schemas following industry best practices. Use this skill whenever you create or edit GraphQL SDL, such as a `schema.graphql` file or `typeDefs`, including when: (1) designing a new GraphQL schema or API, (2) adding or changing types, fields, arguments, mutations, or descriptions in an existing schema, (3) reviewing existing schema for improvements, (4) deciding on type structures or nullability, (5) implementing pagination or error patterns, (6) ensuring security in schema design.

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Compatibility, from SKILL.md

Sections in SKILL.md

• Schema Design Principles
• 1. Design for Client Needs
• 2. Be Explicit
• 3. Design for Evolution
• Quick Reference
• Type Definition Syntax
• Nullability Rules
• Input vs Output Types
• Interface Pattern
• Union Pattern
• Reference Files
• Key Rules
• Type Design
• Field Design
• Mutation Design
• ID Strategy

Files in the skill folder

• SKILL.md
• references/errors.md
• references/naming.md
• references/pagination.md
• references/security.md
• references/types.md

Suede Skill Check: 84/100 · B

graphql-schema passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

Where this skill is cited

apollographql/skills is listed from its publisher's official collection or a listing request.

More developer tools skills

All developer tools and frameworks skills

More from apollographql/skills

All 15 skills in apollographql/skills