Graphql schema design
Curated, auditable, benchmark-ready Agent Skills library for Claude Code, Codex, OpenCode, Cursor, and more.
npx -y skills add shinzoxD/knackbox --skill graphql-schema-designAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 27 days oldThe repository was created 27 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Design and review GraphQL schemas for authz, pagination, N+1 risk, nullability, and evolution. Use whenever the user works on GraphQL types, resolvers, connections, deprecations, query cost, or schema reviews — even when they only paste an SDL snippet.
The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
1.9 KB, as published. Nobody here has run it
GraphQL Schema Design
Schema is the product contract. Optimize for client clarity, server efficiency, and safe evolution.
Workflow
- Clarify clients, auth model, and write vs read paths.
- Model types and relationships; avoid leaking DB tables blindly.
- Specify nullability deliberately (every
!is a promise). - Pagination: connections/cursors for lists that can grow.
- Authz: field and object level; never rely on "hidden" fields alone.
- Evolution: deprecations, additive changes, versioning policy.
- Performance: N+1, dataloader, query depth/cost limits.
Output format
## GraphQL design: <api>
### Type overview
…
### Queries / mutations
…
### Authz notes
…
### Pagination & errors
…
### Risks (N+1, breaking changes)
…
### Example operations
Rules
- Prefer additive evolution; mark breaking changes explicitly.
- Mutations should return clear payloads (errors, viewer, mutated entity).
- Do not put secrets in GraphQL types that any authorized client can query casually without field authz.
- Lists without bounds need pagination or hard limits.
- Document error handling conventions (union vs exceptions).
- If SDL is incomplete, state assumptions about resolvers.
Edge cases
- Subscriptions: auth, fan-out cost, filtering.
- Federation: ownership boundaries and shared types.
- File uploads: not always native; call out alternatives.