[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-apollo-graphql-graphql-schema":3,"mdc-dheo4x-key":37,"related-repo-apollo-graphql-graphql-schema":1010,"related-org-apollo-graphql-graphql-schema":1113},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":24,"repoUrl":25,"updatedAt":26,"license":27,"forks":28,"topics":29,"repo":32,"sourceUrl":35,"mdContent":36},"graphql-schema","design GraphQL schemas","Guide for designing GraphQL schemas following industry best practices. Use this skill when: (1) designing a new GraphQL schema or API, (2) reviewing existing schema for improvements, (3) deciding on type structures or nullability, (4) implementing pagination or error patterns, (5) ensuring security in schema design.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"apollo-graphql","Apollo GraphQL","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fapollo-graphql.png","apollographql",[13,17,20,21],{"name":14,"slug":15,"type":16},"GraphQL","graphql","tag",{"name":18,"slug":19,"type":16},"Architecture","architecture",{"name":9,"slug":8,"type":16},{"name":22,"slug":23,"type":16},"API Development","api-development",97,"https:\u002F\u002Fgithub.com\u002Fapollographql\u002Fskills","2026-04-06T18:01:19.140592","MIT",11,[30,31,15],"agent-skills","apollo",{"repoUrl":25,"stars":24,"forks":28,"topics":33,"description":34},[30,31,15],"Apollo GraphQL Agent Skills","https:\u002F\u002Fgithub.com\u002Fapollographql\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fgraphql-schema","---\nname: graphql-schema\ndescription: >\n  Guide for designing GraphQL schemas following industry best practices. Use this skill when:\n  (1) designing a new GraphQL schema or API,\n  (2) reviewing existing schema for improvements,\n  (3) deciding on type structures or nullability,\n  (4) implementing pagination or error patterns,\n  (5) ensuring security in schema design.\nlicense: MIT\ncompatibility: Any GraphQL implementation (Apollo Server, graphql-js, Yoga, etc.)\nmetadata:\n  author: apollographql\n  version: \"1.0.1\"\nallowed-tools: Bash(npm:*) Bash(npx:*) Read Write Edit Glob Grep\n---\n\n# GraphQL Schema Design Guide\n\nThis guide covers best practices for designing GraphQL schemas that are intuitive, performant, and maintainable. Schema design is primarily a server-side concern that directly impacts API usability.\n\n## Schema Design Principles\n\n### 1. Design for Client Needs\n\n- Think about what queries clients will write\n- Organize types around use cases, not database tables\n- Expose capabilities, not implementation details\n\n### 2. Be Explicit\n\n- Use clear, descriptive names\n- Make nullability intentional\n- Document with descriptions\n\n### 3. Design for Evolution\n\n- Plan for backwards compatibility\n- Use deprecation before removal\n- Avoid breaking changes\n\n## Quick Reference\n\n### Type Definition Syntax\n\n```graphql\n\"\"\"\nA user in the system.\n\"\"\"\ntype User {\n  id: ID!\n  email: String!\n  name: String\n  posts(first: Int = 10, after: String): PostConnection!\n  createdAt: DateTime!\n}\n```\n\n### Nullability Rules\n\n| Pattern | Meaning |\n|---------|---------|\n| String | Nullable - may be null |\n| String! | Non-null - always has value |\n| [String] | Nullable list, nullable items |\n| [String!] | Nullable list, non-null items |\n| [String]! | Non-null list, nullable items |\n| [String!]! | Non-null list, non-null items |\n\n**Best Practice:** Use **[Type!]!** for lists - empty list over null, no null items.\n\n### Input vs Output Types\n\n```graphql\n# Output type - what clients receive\ntype User {\n  id: ID!\n  email: String!\n  createdAt: DateTime!\n}\n\n# Input type - what clients send\ninput CreateUserInput {\n  email: String!\n  name: String\n}\n\n# Mutation using input type\ntype Mutation {\n  createUser(input: CreateUserInput!): User!\n}\n```\n\n### Interface Pattern\n\n```graphql\ninterface Node {\n  id: ID!\n}\n\ntype User implements Node {\n  id: ID!\n  email: String!\n}\n\ntype Post implements Node {\n  id: ID!\n  title: String!\n}\n```\n\n### Union Pattern\n\n```graphql\nunion SearchResult = User | Post | Comment\n\ntype Query {\n  search(query: String!): [SearchResult!]!\n}\n```\n\n## Reference Files\n\nDetailed documentation for specific topics:\n\n- [Types](references\u002Ftypes.md) - Type design patterns, interfaces, unions, and custom scalars\n- [Naming](references\u002Fnaming.md) - Naming conventions for types, fields, and arguments\n- [Pagination](references\u002Fpagination.md) - Connection pattern and cursor-based pagination\n- [Errors](references\u002Ferrors.md) - Error modeling and result types\n- [Security](references\u002Fsecurity.md) - Security best practices for schema design\n\n## Key Rules\n\n### Type Design\n\n- Define types based on domain concepts, not data storage\n- Use interfaces for shared fields across types\n- Use unions for mutually exclusive types\n- Keep types focused (single responsibility)\n- Avoid deep nesting - flatten when possible\n\n### Field Design\n\n- Fields should be named from client's perspective\n- Return the most specific type possible\n- Make expensive fields explicit (consider arguments)\n- Use arguments for filtering, sorting, pagination\n\n### Mutation Design\n\n- Use single input argument pattern: `mutation(input: InputType!)`\n- Return affected objects in mutation responses\n- Model mutations around business operations, not CRUD\n- Consider returning a union of success\u002Ferror types\n\n### ID Strategy\n\n- Use globally unique IDs when possible\n- Implement `Node` interface for refetchability\n- Base64-encode compound IDs if needed\n\n## Ground Rules\n\n- ALWAYS add descriptions to types and fields\n- ALWAYS use non-null (**!**) for fields that cannot be null\n- ALWAYS use **[Type!]!** pattern for lists\n- NEVER expose database internals in schema\n- NEVER break backwards compatibility without deprecation\n- PREFER dedicated input types over many arguments\n- PREFER enums over arbitrary strings for fixed values\n- USE `ID` type for identifiers, not `String` or `Int`\n- USE custom scalars for domain-specific values (DateTime, Email, URL)\n",{"data":38,"body":43},{"name":4,"description":6,"license":27,"compatibility":39,"metadata":40,"allowed-tools":42},"Any GraphQL implementation (Apollo Server, graphql-js, Yoga, etc.)",{"author":11,"version":41},"1.0.1","Bash(npm:*) Bash(npx:*) Read Write Edit Glob Grep",{"type":44,"children":45},"root",[46,55,61,68,75,95,101,119,125,143,149,155,257,263,380,402,408,548,554,656,662,707,713,718,777,783,789,817,823,846,852,881,887,913,919,1004],{"type":47,"tag":48,"props":49,"children":51},"element","h1",{"id":50},"graphql-schema-design-guide",[52],{"type":53,"value":54},"text","GraphQL Schema Design Guide",{"type":47,"tag":56,"props":57,"children":58},"p",{},[59],{"type":53,"value":60},"This guide covers best practices for designing GraphQL schemas that are intuitive, performant, and maintainable. Schema design is primarily a server-side concern that directly impacts API usability.",{"type":47,"tag":62,"props":63,"children":65},"h2",{"id":64},"schema-design-principles",[66],{"type":53,"value":67},"Schema Design Principles",{"type":47,"tag":69,"props":70,"children":72},"h3",{"id":71},"_1-design-for-client-needs",[73],{"type":53,"value":74},"1. Design for Client Needs",{"type":47,"tag":76,"props":77,"children":78},"ul",{},[79,85,90],{"type":47,"tag":80,"props":81,"children":82},"li",{},[83],{"type":53,"value":84},"Think about what queries clients will write",{"type":47,"tag":80,"props":86,"children":87},{},[88],{"type":53,"value":89},"Organize types around use cases, not database tables",{"type":47,"tag":80,"props":91,"children":92},{},[93],{"type":53,"value":94},"Expose capabilities, not implementation details",{"type":47,"tag":69,"props":96,"children":98},{"id":97},"_2-be-explicit",[99],{"type":53,"value":100},"2. Be Explicit",{"type":47,"tag":76,"props":102,"children":103},{},[104,109,114],{"type":47,"tag":80,"props":105,"children":106},{},[107],{"type":53,"value":108},"Use clear, descriptive names",{"type":47,"tag":80,"props":110,"children":111},{},[112],{"type":53,"value":113},"Make nullability intentional",{"type":47,"tag":80,"props":115,"children":116},{},[117],{"type":53,"value":118},"Document with descriptions",{"type":47,"tag":69,"props":120,"children":122},{"id":121},"_3-design-for-evolution",[123],{"type":53,"value":124},"3. Design for Evolution",{"type":47,"tag":76,"props":126,"children":127},{},[128,133,138],{"type":47,"tag":80,"props":129,"children":130},{},[131],{"type":53,"value":132},"Plan for backwards compatibility",{"type":47,"tag":80,"props":134,"children":135},{},[136],{"type":53,"value":137},"Use deprecation before removal",{"type":47,"tag":80,"props":139,"children":140},{},[141],{"type":53,"value":142},"Avoid breaking changes",{"type":47,"tag":62,"props":144,"children":146},{"id":145},"quick-reference",[147],{"type":53,"value":148},"Quick Reference",{"type":47,"tag":69,"props":150,"children":152},{"id":151},"type-definition-syntax",[153],{"type":53,"value":154},"Type Definition Syntax",{"type":47,"tag":156,"props":157,"children":161},"pre",{"className":158,"code":159,"language":15,"meta":160,"style":160},"language-graphql shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\"\"\"\nA user in the system.\n\"\"\"\ntype User {\n  id: ID!\n  email: String!\n  name: String\n  posts(first: Int = 10, after: String): PostConnection!\n  createdAt: DateTime!\n}\n","",[162],{"type":47,"tag":163,"props":164,"children":165},"code",{"__ignoreMap":160},[166,177,186,194,203,212,221,230,239,248],{"type":47,"tag":167,"props":168,"children":171},"span",{"class":169,"line":170},"line",1,[172],{"type":47,"tag":167,"props":173,"children":174},{},[175],{"type":53,"value":176},"\"\"\"\n",{"type":47,"tag":167,"props":178,"children":180},{"class":169,"line":179},2,[181],{"type":47,"tag":167,"props":182,"children":183},{},[184],{"type":53,"value":185},"A user in the system.\n",{"type":47,"tag":167,"props":187,"children":189},{"class":169,"line":188},3,[190],{"type":47,"tag":167,"props":191,"children":192},{},[193],{"type":53,"value":176},{"type":47,"tag":167,"props":195,"children":197},{"class":169,"line":196},4,[198],{"type":47,"tag":167,"props":199,"children":200},{},[201],{"type":53,"value":202},"type User {\n",{"type":47,"tag":167,"props":204,"children":206},{"class":169,"line":205},5,[207],{"type":47,"tag":167,"props":208,"children":209},{},[210],{"type":53,"value":211},"  id: ID!\n",{"type":47,"tag":167,"props":213,"children":215},{"class":169,"line":214},6,[216],{"type":47,"tag":167,"props":217,"children":218},{},[219],{"type":53,"value":220},"  email: String!\n",{"type":47,"tag":167,"props":222,"children":224},{"class":169,"line":223},7,[225],{"type":47,"tag":167,"props":226,"children":227},{},[228],{"type":53,"value":229},"  name: String\n",{"type":47,"tag":167,"props":231,"children":233},{"class":169,"line":232},8,[234],{"type":47,"tag":167,"props":235,"children":236},{},[237],{"type":53,"value":238},"  posts(first: Int = 10, after: String): PostConnection!\n",{"type":47,"tag":167,"props":240,"children":242},{"class":169,"line":241},9,[243],{"type":47,"tag":167,"props":244,"children":245},{},[246],{"type":53,"value":247},"  createdAt: DateTime!\n",{"type":47,"tag":167,"props":249,"children":251},{"class":169,"line":250},10,[252],{"type":47,"tag":167,"props":253,"children":254},{},[255],{"type":53,"value":256},"}\n",{"type":47,"tag":69,"props":258,"children":260},{"id":259},"nullability-rules",[261],{"type":53,"value":262},"Nullability Rules",{"type":47,"tag":264,"props":265,"children":266},"table",{},[267,286],{"type":47,"tag":268,"props":269,"children":270},"thead",{},[271],{"type":47,"tag":272,"props":273,"children":274},"tr",{},[275,281],{"type":47,"tag":276,"props":277,"children":278},"th",{},[279],{"type":53,"value":280},"Pattern",{"type":47,"tag":276,"props":282,"children":283},{},[284],{"type":53,"value":285},"Meaning",{"type":47,"tag":287,"props":288,"children":289},"tbody",{},[290,304,317,332,347,364],{"type":47,"tag":272,"props":291,"children":292},{},[293,299],{"type":47,"tag":294,"props":295,"children":296},"td",{},[297],{"type":53,"value":298},"String",{"type":47,"tag":294,"props":300,"children":301},{},[302],{"type":53,"value":303},"Nullable - may be null",{"type":47,"tag":272,"props":305,"children":306},{},[307,312],{"type":47,"tag":294,"props":308,"children":309},{},[310],{"type":53,"value":311},"String!",{"type":47,"tag":294,"props":313,"children":314},{},[315],{"type":53,"value":316},"Non-null - always has value",{"type":47,"tag":272,"props":318,"children":319},{},[320,327],{"type":47,"tag":294,"props":321,"children":322},{},[323],{"type":47,"tag":167,"props":324,"children":325},{},[326],{"type":53,"value":298},{"type":47,"tag":294,"props":328,"children":329},{},[330],{"type":53,"value":331},"Nullable list, nullable items",{"type":47,"tag":272,"props":333,"children":334},{},[335,342],{"type":47,"tag":294,"props":336,"children":337},{},[338],{"type":47,"tag":167,"props":339,"children":340},{},[341],{"type":53,"value":311},{"type":47,"tag":294,"props":343,"children":344},{},[345],{"type":53,"value":346},"Nullable list, non-null items",{"type":47,"tag":272,"props":348,"children":349},{},[350,359],{"type":47,"tag":294,"props":351,"children":352},{},[353,357],{"type":47,"tag":167,"props":354,"children":355},{},[356],{"type":53,"value":298},{"type":53,"value":358},"!",{"type":47,"tag":294,"props":360,"children":361},{},[362],{"type":53,"value":363},"Non-null list, nullable items",{"type":47,"tag":272,"props":365,"children":366},{},[367,375],{"type":47,"tag":294,"props":368,"children":369},{},[370,374],{"type":47,"tag":167,"props":371,"children":372},{},[373],{"type":53,"value":311},{"type":53,"value":358},{"type":47,"tag":294,"props":376,"children":377},{},[378],{"type":53,"value":379},"Non-null list, non-null items",{"type":47,"tag":56,"props":381,"children":382},{},[383,389,391,400],{"type":47,"tag":384,"props":385,"children":386},"strong",{},[387],{"type":53,"value":388},"Best Practice:",{"type":53,"value":390}," Use ",{"type":47,"tag":384,"props":392,"children":393},{},[394,399],{"type":47,"tag":167,"props":395,"children":396},{},[397],{"type":53,"value":398},"Type!",{"type":53,"value":358},{"type":53,"value":401}," for lists - empty list over null, no null items.",{"type":47,"tag":69,"props":403,"children":405},{"id":404},"input-vs-output-types",[406],{"type":53,"value":407},"Input vs Output Types",{"type":47,"tag":156,"props":409,"children":411},{"className":158,"code":410,"language":15,"meta":160,"style":160},"# Output type - what clients receive\ntype User {\n  id: ID!\n  email: String!\n  createdAt: DateTime!\n}\n\n# Input type - what clients send\ninput CreateUserInput {\n  email: String!\n  name: String\n}\n\n# Mutation using input type\ntype Mutation {\n  createUser(input: CreateUserInput!): User!\n}\n",[412],{"type":47,"tag":163,"props":413,"children":414},{"__ignoreMap":160},[415,423,430,437,444,451,458,467,475,483,490,497,505,513,522,531,540],{"type":47,"tag":167,"props":416,"children":417},{"class":169,"line":170},[418],{"type":47,"tag":167,"props":419,"children":420},{},[421],{"type":53,"value":422},"# Output type - what clients receive\n",{"type":47,"tag":167,"props":424,"children":425},{"class":169,"line":179},[426],{"type":47,"tag":167,"props":427,"children":428},{},[429],{"type":53,"value":202},{"type":47,"tag":167,"props":431,"children":432},{"class":169,"line":188},[433],{"type":47,"tag":167,"props":434,"children":435},{},[436],{"type":53,"value":211},{"type":47,"tag":167,"props":438,"children":439},{"class":169,"line":196},[440],{"type":47,"tag":167,"props":441,"children":442},{},[443],{"type":53,"value":220},{"type":47,"tag":167,"props":445,"children":446},{"class":169,"line":205},[447],{"type":47,"tag":167,"props":448,"children":449},{},[450],{"type":53,"value":247},{"type":47,"tag":167,"props":452,"children":453},{"class":169,"line":214},[454],{"type":47,"tag":167,"props":455,"children":456},{},[457],{"type":53,"value":256},{"type":47,"tag":167,"props":459,"children":460},{"class":169,"line":223},[461],{"type":47,"tag":167,"props":462,"children":464},{"emptyLinePlaceholder":463},true,[465],{"type":53,"value":466},"\n",{"type":47,"tag":167,"props":468,"children":469},{"class":169,"line":232},[470],{"type":47,"tag":167,"props":471,"children":472},{},[473],{"type":53,"value":474},"# Input type - what clients send\n",{"type":47,"tag":167,"props":476,"children":477},{"class":169,"line":241},[478],{"type":47,"tag":167,"props":479,"children":480},{},[481],{"type":53,"value":482},"input CreateUserInput {\n",{"type":47,"tag":167,"props":484,"children":485},{"class":169,"line":250},[486],{"type":47,"tag":167,"props":487,"children":488},{},[489],{"type":53,"value":220},{"type":47,"tag":167,"props":491,"children":492},{"class":169,"line":28},[493],{"type":47,"tag":167,"props":494,"children":495},{},[496],{"type":53,"value":229},{"type":47,"tag":167,"props":498,"children":500},{"class":169,"line":499},12,[501],{"type":47,"tag":167,"props":502,"children":503},{},[504],{"type":53,"value":256},{"type":47,"tag":167,"props":506,"children":508},{"class":169,"line":507},13,[509],{"type":47,"tag":167,"props":510,"children":511},{"emptyLinePlaceholder":463},[512],{"type":53,"value":466},{"type":47,"tag":167,"props":514,"children":516},{"class":169,"line":515},14,[517],{"type":47,"tag":167,"props":518,"children":519},{},[520],{"type":53,"value":521},"# Mutation using input type\n",{"type":47,"tag":167,"props":523,"children":525},{"class":169,"line":524},15,[526],{"type":47,"tag":167,"props":527,"children":528},{},[529],{"type":53,"value":530},"type Mutation {\n",{"type":47,"tag":167,"props":532,"children":534},{"class":169,"line":533},16,[535],{"type":47,"tag":167,"props":536,"children":537},{},[538],{"type":53,"value":539},"  createUser(input: CreateUserInput!): User!\n",{"type":47,"tag":167,"props":541,"children":543},{"class":169,"line":542},17,[544],{"type":47,"tag":167,"props":545,"children":546},{},[547],{"type":53,"value":256},{"type":47,"tag":69,"props":549,"children":551},{"id":550},"interface-pattern",[552],{"type":53,"value":553},"Interface Pattern",{"type":47,"tag":156,"props":555,"children":557},{"className":158,"code":556,"language":15,"meta":160,"style":160},"interface Node {\n  id: ID!\n}\n\ntype User implements Node {\n  id: ID!\n  email: String!\n}\n\ntype Post implements Node {\n  id: ID!\n  title: String!\n}\n",[558],{"type":47,"tag":163,"props":559,"children":560},{"__ignoreMap":160},[561,569,576,583,590,598,605,612,619,626,634,641,649],{"type":47,"tag":167,"props":562,"children":563},{"class":169,"line":170},[564],{"type":47,"tag":167,"props":565,"children":566},{},[567],{"type":53,"value":568},"interface Node {\n",{"type":47,"tag":167,"props":570,"children":571},{"class":169,"line":179},[572],{"type":47,"tag":167,"props":573,"children":574},{},[575],{"type":53,"value":211},{"type":47,"tag":167,"props":577,"children":578},{"class":169,"line":188},[579],{"type":47,"tag":167,"props":580,"children":581},{},[582],{"type":53,"value":256},{"type":47,"tag":167,"props":584,"children":585},{"class":169,"line":196},[586],{"type":47,"tag":167,"props":587,"children":588},{"emptyLinePlaceholder":463},[589],{"type":53,"value":466},{"type":47,"tag":167,"props":591,"children":592},{"class":169,"line":205},[593],{"type":47,"tag":167,"props":594,"children":595},{},[596],{"type":53,"value":597},"type User implements Node {\n",{"type":47,"tag":167,"props":599,"children":600},{"class":169,"line":214},[601],{"type":47,"tag":167,"props":602,"children":603},{},[604],{"type":53,"value":211},{"type":47,"tag":167,"props":606,"children":607},{"class":169,"line":223},[608],{"type":47,"tag":167,"props":609,"children":610},{},[611],{"type":53,"value":220},{"type":47,"tag":167,"props":613,"children":614},{"class":169,"line":232},[615],{"type":47,"tag":167,"props":616,"children":617},{},[618],{"type":53,"value":256},{"type":47,"tag":167,"props":620,"children":621},{"class":169,"line":241},[622],{"type":47,"tag":167,"props":623,"children":624},{"emptyLinePlaceholder":463},[625],{"type":53,"value":466},{"type":47,"tag":167,"props":627,"children":628},{"class":169,"line":250},[629],{"type":47,"tag":167,"props":630,"children":631},{},[632],{"type":53,"value":633},"type Post implements Node {\n",{"type":47,"tag":167,"props":635,"children":636},{"class":169,"line":28},[637],{"type":47,"tag":167,"props":638,"children":639},{},[640],{"type":53,"value":211},{"type":47,"tag":167,"props":642,"children":643},{"class":169,"line":499},[644],{"type":47,"tag":167,"props":645,"children":646},{},[647],{"type":53,"value":648},"  title: String!\n",{"type":47,"tag":167,"props":650,"children":651},{"class":169,"line":507},[652],{"type":47,"tag":167,"props":653,"children":654},{},[655],{"type":53,"value":256},{"type":47,"tag":69,"props":657,"children":659},{"id":658},"union-pattern",[660],{"type":53,"value":661},"Union Pattern",{"type":47,"tag":156,"props":663,"children":665},{"className":158,"code":664,"language":15,"meta":160,"style":160},"union SearchResult = User | Post | Comment\n\ntype Query {\n  search(query: String!): [SearchResult!]!\n}\n",[666],{"type":47,"tag":163,"props":667,"children":668},{"__ignoreMap":160},[669,677,684,692,700],{"type":47,"tag":167,"props":670,"children":671},{"class":169,"line":170},[672],{"type":47,"tag":167,"props":673,"children":674},{},[675],{"type":53,"value":676},"union SearchResult = User | Post | Comment\n",{"type":47,"tag":167,"props":678,"children":679},{"class":169,"line":179},[680],{"type":47,"tag":167,"props":681,"children":682},{"emptyLinePlaceholder":463},[683],{"type":53,"value":466},{"type":47,"tag":167,"props":685,"children":686},{"class":169,"line":188},[687],{"type":47,"tag":167,"props":688,"children":689},{},[690],{"type":53,"value":691},"type Query {\n",{"type":47,"tag":167,"props":693,"children":694},{"class":169,"line":196},[695],{"type":47,"tag":167,"props":696,"children":697},{},[698],{"type":53,"value":699},"  search(query: String!): [SearchResult!]!\n",{"type":47,"tag":167,"props":701,"children":702},{"class":169,"line":205},[703],{"type":47,"tag":167,"props":704,"children":705},{},[706],{"type":53,"value":256},{"type":47,"tag":62,"props":708,"children":710},{"id":709},"reference-files",[711],{"type":53,"value":712},"Reference Files",{"type":47,"tag":56,"props":714,"children":715},{},[716],{"type":53,"value":717},"Detailed documentation for specific topics:",{"type":47,"tag":76,"props":719,"children":720},{},[721,733,744,755,766],{"type":47,"tag":80,"props":722,"children":723},{},[724,731],{"type":47,"tag":725,"props":726,"children":728},"a",{"href":727},"references\u002Ftypes.md",[729],{"type":53,"value":730},"Types",{"type":53,"value":732}," - Type design patterns, interfaces, unions, and custom scalars",{"type":47,"tag":80,"props":734,"children":735},{},[736,742],{"type":47,"tag":725,"props":737,"children":739},{"href":738},"references\u002Fnaming.md",[740],{"type":53,"value":741},"Naming",{"type":53,"value":743}," - Naming conventions for types, fields, and arguments",{"type":47,"tag":80,"props":745,"children":746},{},[747,753],{"type":47,"tag":725,"props":748,"children":750},{"href":749},"references\u002Fpagination.md",[751],{"type":53,"value":752},"Pagination",{"type":53,"value":754}," - Connection pattern and cursor-based pagination",{"type":47,"tag":80,"props":756,"children":757},{},[758,764],{"type":47,"tag":725,"props":759,"children":761},{"href":760},"references\u002Ferrors.md",[762],{"type":53,"value":763},"Errors",{"type":53,"value":765}," - Error modeling and result types",{"type":47,"tag":80,"props":767,"children":768},{},[769,775],{"type":47,"tag":725,"props":770,"children":772},{"href":771},"references\u002Fsecurity.md",[773],{"type":53,"value":774},"Security",{"type":53,"value":776}," - Security best practices for schema design",{"type":47,"tag":62,"props":778,"children":780},{"id":779},"key-rules",[781],{"type":53,"value":782},"Key Rules",{"type":47,"tag":69,"props":784,"children":786},{"id":785},"type-design",[787],{"type":53,"value":788},"Type Design",{"type":47,"tag":76,"props":790,"children":791},{},[792,797,802,807,812],{"type":47,"tag":80,"props":793,"children":794},{},[795],{"type":53,"value":796},"Define types based on domain concepts, not data storage",{"type":47,"tag":80,"props":798,"children":799},{},[800],{"type":53,"value":801},"Use interfaces for shared fields across types",{"type":47,"tag":80,"props":803,"children":804},{},[805],{"type":53,"value":806},"Use unions for mutually exclusive types",{"type":47,"tag":80,"props":808,"children":809},{},[810],{"type":53,"value":811},"Keep types focused (single responsibility)",{"type":47,"tag":80,"props":813,"children":814},{},[815],{"type":53,"value":816},"Avoid deep nesting - flatten when possible",{"type":47,"tag":69,"props":818,"children":820},{"id":819},"field-design",[821],{"type":53,"value":822},"Field Design",{"type":47,"tag":76,"props":824,"children":825},{},[826,831,836,841],{"type":47,"tag":80,"props":827,"children":828},{},[829],{"type":53,"value":830},"Fields should be named from client's perspective",{"type":47,"tag":80,"props":832,"children":833},{},[834],{"type":53,"value":835},"Return the most specific type possible",{"type":47,"tag":80,"props":837,"children":838},{},[839],{"type":53,"value":840},"Make expensive fields explicit (consider arguments)",{"type":47,"tag":80,"props":842,"children":843},{},[844],{"type":53,"value":845},"Use arguments for filtering, sorting, pagination",{"type":47,"tag":69,"props":847,"children":849},{"id":848},"mutation-design",[850],{"type":53,"value":851},"Mutation Design",{"type":47,"tag":76,"props":853,"children":854},{},[855,866,871,876],{"type":47,"tag":80,"props":856,"children":857},{},[858,860],{"type":53,"value":859},"Use single input argument pattern: ",{"type":47,"tag":163,"props":861,"children":863},{"className":862},[],[864],{"type":53,"value":865},"mutation(input: InputType!)",{"type":47,"tag":80,"props":867,"children":868},{},[869],{"type":53,"value":870},"Return affected objects in mutation responses",{"type":47,"tag":80,"props":872,"children":873},{},[874],{"type":53,"value":875},"Model mutations around business operations, not CRUD",{"type":47,"tag":80,"props":877,"children":878},{},[879],{"type":53,"value":880},"Consider returning a union of success\u002Ferror types",{"type":47,"tag":69,"props":882,"children":884},{"id":883},"id-strategy",[885],{"type":53,"value":886},"ID Strategy",{"type":47,"tag":76,"props":888,"children":889},{},[890,895,908],{"type":47,"tag":80,"props":891,"children":892},{},[893],{"type":53,"value":894},"Use globally unique IDs when possible",{"type":47,"tag":80,"props":896,"children":897},{},[898,900,906],{"type":53,"value":899},"Implement ",{"type":47,"tag":163,"props":901,"children":903},{"className":902},[],[904],{"type":53,"value":905},"Node",{"type":53,"value":907}," interface for refetchability",{"type":47,"tag":80,"props":909,"children":910},{},[911],{"type":53,"value":912},"Base64-encode compound IDs if needed",{"type":47,"tag":62,"props":914,"children":916},{"id":915},"ground-rules",[917],{"type":53,"value":918},"Ground Rules",{"type":47,"tag":76,"props":920,"children":921},{},[922,927,938,953,958,963,968,973,999],{"type":47,"tag":80,"props":923,"children":924},{},[925],{"type":53,"value":926},"ALWAYS add descriptions to types and fields",{"type":47,"tag":80,"props":928,"children":929},{},[930,932,936],{"type":53,"value":931},"ALWAYS use non-null (",{"type":47,"tag":384,"props":933,"children":934},{},[935],{"type":53,"value":358},{"type":53,"value":937},") for fields that cannot be null",{"type":47,"tag":80,"props":939,"children":940},{},[941,943,951],{"type":53,"value":942},"ALWAYS use ",{"type":47,"tag":384,"props":944,"children":945},{},[946,950],{"type":47,"tag":167,"props":947,"children":948},{},[949],{"type":53,"value":398},{"type":53,"value":358},{"type":53,"value":952}," pattern for lists",{"type":47,"tag":80,"props":954,"children":955},{},[956],{"type":53,"value":957},"NEVER expose database internals in schema",{"type":47,"tag":80,"props":959,"children":960},{},[961],{"type":53,"value":962},"NEVER break backwards compatibility without deprecation",{"type":47,"tag":80,"props":964,"children":965},{},[966],{"type":53,"value":967},"PREFER dedicated input types over many arguments",{"type":47,"tag":80,"props":969,"children":970},{},[971],{"type":53,"value":972},"PREFER enums over arbitrary strings for fixed values",{"type":47,"tag":80,"props":974,"children":975},{},[976,978,984,986,991,993],{"type":53,"value":977},"USE ",{"type":47,"tag":163,"props":979,"children":981},{"className":980},[],[982],{"type":53,"value":983},"ID",{"type":53,"value":985}," type for identifiers, not ",{"type":47,"tag":163,"props":987,"children":989},{"className":988},[],[990],{"type":53,"value":298},{"type":53,"value":992}," or ",{"type":47,"tag":163,"props":994,"children":996},{"className":995},[],[997],{"type":53,"value":998},"Int",{"type":47,"tag":80,"props":1000,"children":1001},{},[1002],{"type":53,"value":1003},"USE custom scalars for domain-specific values (DateTime, Email, URL)",{"type":47,"tag":1005,"props":1006,"children":1007},"style",{},[1008],{"type":53,"value":1009},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1011,"total":515},[1012,1027,1040,1051,1072,1087,1100],{"slug":1013,"name":1013,"fn":1014,"description":1015,"org":1016,"tags":1017,"stars":24,"repoUrl":25,"updatedAt":1026},"apollo-client","build React apps with Apollo Client","Guide for building React applications with Apollo Client 4.x. Use this skill when: (1) setting up Apollo Client in a React project, (2) writing GraphQL queries or mutations with hooks, (3) configuring caching or cache policies, (4) managing local state with reactive variables, (5) troubleshooting Apollo Client errors or performance issues.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1018,1019,1022,1023],{"name":9,"slug":8,"type":16},{"name":1020,"slug":1021,"type":16},"Frontend","frontend",{"name":14,"slug":15,"type":16},{"name":1024,"slug":1025,"type":16},"React","react","2026-04-06T18:01:12.268638",{"slug":1028,"name":1028,"fn":1029,"description":1030,"org":1031,"tags":1032,"stars":24,"repoUrl":25,"updatedAt":1039},"apollo-connectors","integrate REST APIs with Apollo Connectors","Guide for integrating REST APIs into GraphQL supergraphs using Apollo Connectors with @source and @connect directives. Use this skill when the user: (1) mentions \"connectors\", \"Apollo Connectors\", or \"REST Connector\", (2) wants to integrate a REST API into GraphQL, (3) references @source or @connect directives, (4) works with files containing \"# Note to AI Friends: This is an Apollo Connectors schema\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1033,1034,1035,1036],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1037,"slug":1038,"type":16},"REST API","rest-api","2026-04-06T18:01:23.758345",{"slug":1041,"name":1041,"fn":1042,"description":1043,"org":1044,"tags":1045,"stars":24,"repoUrl":25,"updatedAt":1050},"apollo-federation","author Apollo Federation subgraph schemas","Guide for authoring Apollo Federation subgraph schemas. Use this skill when: (1) creating new subgraph schemas for a federated supergraph, (2) defining or modifying entities with @key, (3) sharing types\u002Ffields across subgraphs with @shareable, (4) working with federation directives (@external, @requires, @provides, @override, @inaccessible), (5) troubleshooting composition errors, (6) any task involving federation schema design patterns.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1046,1047,1048,1049],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":18,"slug":19,"type":16},{"name":14,"slug":15,"type":16},"2026-07-30T05:31:51.648593",{"slug":1052,"name":1052,"fn":1053,"description":1054,"org":1055,"tags":1056,"stars":24,"repoUrl":25,"updatedAt":1071},"apollo-ios","build Apple apps with Apollo iOS","Guide for building Apple-platform applications with Apollo iOS, the strongly-typed GraphQL client for Swift. Use this skill when: (1) adding Apollo iOS to a Swift Package Manager or Xcode project, (2) configuring `apollo-codegen-config.json` and running code generation, (3) configuring an `ApolloClient` with auth, interceptors, and caching, (4) writing queries, mutations, or subscriptions from SwiftUI views, (5) writing tests against generated operation mocks.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1057,1058,1059,1062,1065,1068],{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1060,"slug":1061,"type":16},"iOS","ios",{"name":1063,"slug":1064,"type":16},"Mobile","mobile",{"name":1066,"slug":1067,"type":16},"Swift","swift",{"name":1069,"slug":1070,"type":16},"Xcode","xcode","2026-04-29T05:35:21.329969",{"slug":1073,"name":1073,"fn":1074,"description":1075,"org":1076,"tags":1077,"stars":24,"repoUrl":25,"updatedAt":1086},"apollo-kotlin","build Kotlin apps with Apollo GraphQL","Guide for building applications with Apollo Kotlin, the GraphQL client library for Android and Kotlin. Use this skill when: (1) setting up Apollo Kotlin in a Gradle project for Android, Kotlin\u002FJVM, or KMP, (2) configuring schema download and codegen for GraphQL services, (3) configuring an `ApolloClient` with auth, interceptors, and caching, (4) writing queries, mutations, or subscriptions,\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1078,1081,1082,1083],{"name":1079,"slug":1080,"type":16},"Android","android",{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1084,"slug":1085,"type":16},"Kotlin","kotlin","2026-04-06T18:01:15.005978",{"slug":1088,"name":1088,"fn":1089,"description":1090,"org":1091,"tags":1092,"stars":24,"repoUrl":25,"updatedAt":1099},"apollo-mcp-server","connect MCP agents to GraphQL APIs","Guide for using Apollo MCP Server to connect AI agents with GraphQL APIs. Use this skill when: (1) setting up or configuring Apollo MCP Server, (2) defining MCP tools from GraphQL operations, (3) using introspection tools (introspect, search, validate, execute), (4) troubleshooting MCP server connectivity or tool execution issues.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1093,1094,1095,1096],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1097,"slug":1098,"type":16},"MCP","mcp","2026-04-06T18:01:20.578589",{"slug":1101,"name":1101,"fn":1102,"description":1103,"org":1104,"tags":1105,"stars":24,"repoUrl":25,"updatedAt":1112},"apollo-router","configure Apollo Router for GraphQL federation","Version-aware guide for configuring and running Apollo Router for federated GraphQL supergraphs. Generates correct YAML for both Router v1.x and v2.x. Use this skill when: (1) setting up Apollo Router to run a supergraph, (2) configuring routing, headers, or CORS, (3) implementing custom plugins (Rhai scripts or coprocessors), (4) configuring telemetry (tracing, metrics, logging), (5) troubleshooting Router performance or connectivity issues, (6) securing the graph with JWT, declarative field-level authorization directives, or persisted-query safelisting, (7) managing router.yaml as version-controlled config with CI\u002FCD validation.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1106,1107,1108,1111],{"name":9,"slug":8,"type":16},{"name":18,"slug":19,"type":16},{"name":1109,"slug":1110,"type":16},"Deployment","deployment",{"name":14,"slug":15,"type":16},"2026-07-30T05:31:54.665938",{"items":1114,"total":524},[1115,1122,1129,1136,1145,1152,1159,1166,1181,1197,1207,1214],{"slug":1013,"name":1013,"fn":1014,"description":1015,"org":1116,"tags":1117,"stars":24,"repoUrl":25,"updatedAt":1026},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1118,1119,1120,1121],{"name":9,"slug":8,"type":16},{"name":1020,"slug":1021,"type":16},{"name":14,"slug":15,"type":16},{"name":1024,"slug":1025,"type":16},{"slug":1028,"name":1028,"fn":1029,"description":1030,"org":1123,"tags":1124,"stars":24,"repoUrl":25,"updatedAt":1039},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1125,1126,1127,1128],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1037,"slug":1038,"type":16},{"slug":1041,"name":1041,"fn":1042,"description":1043,"org":1130,"tags":1131,"stars":24,"repoUrl":25,"updatedAt":1050},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1132,1133,1134,1135],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":18,"slug":19,"type":16},{"name":14,"slug":15,"type":16},{"slug":1052,"name":1052,"fn":1053,"description":1054,"org":1137,"tags":1138,"stars":24,"repoUrl":25,"updatedAt":1071},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1139,1140,1141,1142,1143,1144],{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1060,"slug":1061,"type":16},{"name":1063,"slug":1064,"type":16},{"name":1066,"slug":1067,"type":16},{"name":1069,"slug":1070,"type":16},{"slug":1073,"name":1073,"fn":1074,"description":1075,"org":1146,"tags":1147,"stars":24,"repoUrl":25,"updatedAt":1086},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1148,1149,1150,1151],{"name":1079,"slug":1080,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1084,"slug":1085,"type":16},{"slug":1088,"name":1088,"fn":1089,"description":1090,"org":1153,"tags":1154,"stars":24,"repoUrl":25,"updatedAt":1099},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1155,1156,1157,1158],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1097,"slug":1098,"type":16},{"slug":1101,"name":1101,"fn":1102,"description":1103,"org":1160,"tags":1161,"stars":24,"repoUrl":25,"updatedAt":1112},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1162,1163,1164,1165],{"name":9,"slug":8,"type":16},{"name":18,"slug":19,"type":16},{"name":1109,"slug":1110,"type":16},{"name":14,"slug":15,"type":16},{"slug":1167,"name":1167,"fn":1168,"description":1169,"org":1170,"tags":1171,"stars":24,"repoUrl":25,"updatedAt":1180},"apollo-router-plugin-creator","write Apollo Router Rust plugins","Guide for writing Apollo Router native Rust plugins. Use this skill when: (1) users want to create a new router plugin, (2) users want to add service hooks (router_service, supergraph_service, execution_service, subgraph_service), (3) users want to modify an existing router plugin, (4) users need to understand router plugin patterns or the request lifecycle. (5) triggers on requests like \"create a new plugin\", \"add a router plugin\", \"modify the X plugin\", or \"add subgraph_service hook\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1172,1173,1174,1177],{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1175,"slug":1176,"type":16},"Plugin Development","plugin-development",{"name":1178,"slug":1179,"type":16},"Rust","rust","2026-04-06T18:01:27.176974",{"slug":1182,"name":1182,"fn":1183,"description":1184,"org":1185,"tags":1186,"stars":24,"repoUrl":25,"updatedAt":1196},"apollo-server","build GraphQL servers with Apollo Server","Guide for building GraphQL servers with Apollo Server 5.x. Use this skill when: (1) setting up a new Apollo Server project, (2) writing resolvers or defining GraphQL schemas, (3) implementing authentication or authorization, (4) creating plugins or custom data sources, (5) troubleshooting Apollo Server errors or performance issues.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1187,1188,1189,1190,1193],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1191,"slug":1192,"type":16},"Node.js","nodejs",{"name":1194,"slug":1195,"type":16},"TypeScript","typescript","2026-04-06T18:01:13.653038",{"slug":1198,"name":1198,"fn":1199,"description":1200,"org":1201,"tags":1202,"stars":24,"repoUrl":25,"updatedAt":1206},"graphql-operations","write GraphQL queries and mutations","Guide for writing GraphQL operations (queries, mutations, fragments) following best practices. Use this skill when: (1) writing GraphQL queries or mutations, (2) organizing operations with fragments, (3) optimizing data fetching patterns, (4) setting up type generation or linting, (5) reviewing operations for efficiency.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1203,1204,1205],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},"2026-04-06T18:01:25.530906",{"slug":4,"name":4,"fn":5,"description":6,"org":1208,"tags":1209,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1210,1211,1212,1213],{"name":22,"slug":23,"type":16},{"name":9,"slug":8,"type":16},{"name":18,"slug":19,"type":16},{"name":14,"slug":15,"type":16},{"slug":1215,"name":1215,"fn":1216,"description":1217,"org":1218,"tags":1219,"stars":24,"repoUrl":25,"updatedAt":1225},"rover","manage GraphQL schemas with Apollo Rover","Guide for using Apollo Rover CLI to manage GraphQL schemas and federation. Use this skill when: (1) publishing or fetching subgraph\u002Fgraph schemas, (2) composing supergraph schemas locally or via GraphOS, (3) running local supergraph development with rover dev, (4) validating schemas with check and lint commands, (5) configuring Rover authentication and environment, (6) exploring or searching a graph's schema for agent-driven discovery (rover schema describe \u002F rover schema search).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1220,1221,1224],{"name":9,"slug":8,"type":16},{"name":1222,"slug":1223,"type":16},"CLI","cli",{"name":14,"slug":15,"type":16},"2026-07-30T05:31:52.675547"]