graphql-api-development — Claude Code skill: build GraphQL APIs
A skill that walks your agent through GraphQL API design on graphql-js: schema, resolvers, queries, mutations, subscriptions, auth. Useful when REST stops fitting.
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a claude-codeWhat graphql-api-development does
The skill guides an agent through building a GraphQL API on graphql-js: the type system and schema, resolvers, queries, mutations, subscriptions, error handling, authentication, authorization and caching. It covers both ways of writing a schema — SDL and the programmatic API — plus patterns for input types on mutations, interfaces for shared fields, unions for polymorphic returns, and offset and Relay-style cursor pagination.
A separate section spells out where GraphQL beats REST and where REST still wins: plain CRUD, file uploads, HTTP caching that matters. That is worth reading before you commit to a rewrite.
The examples target a Node.js server with Express, in JavaScript and TypeScript. The text cuts off at the versioning section, so it makes no claims about schema migration or deployment.
What it helps with
- design a GraphQL schema with types and relationships
- write resolvers for nested fields without extra round trips
- add a mutation with an input type and readable errors
- set up Relay-style cursor pagination
- separate authentication from per-field authorization
Example prompts for the agent
- Design a GraphQL schema for a blog: users, posts, comments
- Write resolvers for the nested fields Post.author and User.posts
- Add a createPost mutation with an input type and union errors
How to install graphql-api-development
1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a claude-code2Manually: put the files in place
~/.claude/skills/graphql-api-development/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/graphql-api-development/
1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a codex2Manually: put the files in place
.agents/skills/graphql-api-development/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a cursor2Manually: put the files in place
.cursor/skills/graphql-api-development/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install manutej/luxor-claude-marketplace graphql-api-development2Manually: put the files in place
.github/skills/graphql-api-development/SKILL.md1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a gemini-cli2Platform CLI
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-backend-toolkit/skills/graphql-api-developmentManually: put the files in place
.devin/skills/graphql-api-development/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about graphql-api-development
How do I install graphql-api-development in Claude?
Run npx skills add manutej/luxor-claude-marketplace --skill graphql-api-development -a claude-code. The skill file lands at ~/.claude/skills/graphql-api-development/SKILL.md.
What does graphql-api-development do?
It guides your agent through GraphQL API work on graphql-js: schema design, resolvers, queries, mutations, subscriptions, error handling, authorization and caching.
What stack do the skill's examples use?
The examples assume a Node.js server with Express, written in JavaScript and TypeScript. Schemas can be defined in SDL or through the programmatic API.