[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-apollo-graphql-graphql-operations":3,"mdc--h49alh-key":34,"related-repo-apollo-graphql-graphql-operations":1682,"related-org-apollo-graphql-graphql-operations":1787},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":21,"repoUrl":22,"updatedAt":23,"license":24,"forks":25,"topics":26,"repo":29,"sourceUrl":32,"mdContent":33},"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},"apollo-graphql","Apollo GraphQL","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fapollo-graphql.png","apollographql",[13,17,18],{"name":14,"slug":15,"type":16},"GraphQL","graphql","tag",{"name":9,"slug":8,"type":16},{"name":19,"slug":20,"type":16},"API Development","api-development",97,"https:\u002F\u002Fgithub.com\u002Fapollographql\u002Fskills","2026-04-06T18:01:25.530906","MIT",11,[27,28,15],"agent-skills","apollo",{"repoUrl":22,"stars":21,"forks":25,"topics":30,"description":31},[27,28,15],"Apollo GraphQL Agent Skills","https:\u002F\u002Fgithub.com\u002Fapollographql\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fgraphql-operations","---\nname: graphql-operations\ndescription: >\n  Guide for writing GraphQL operations (queries, mutations, fragments) following best practices. Use this skill when:\n  (1) writing GraphQL queries or mutations,\n  (2) organizing operations with fragments,\n  (3) optimizing data fetching patterns,\n  (4) setting up type generation or linting,\n  (5) reviewing operations for efficiency.\nlicense: MIT\ncompatibility: Any GraphQL client (Apollo Client, urql, Relay, etc.)\nmetadata:\n  author: apollographql\n  version: \"1.0.0\"\nallowed-tools: Bash(npm:*) Bash(npx:*) Read Write Edit Glob Grep\n---\n\n# GraphQL Operations Guide\n\nThis guide covers best practices for writing GraphQL operations (queries, mutations, subscriptions) as a client developer. Well-written operations are efficient, type-safe, and maintainable.\n\n## Operation Basics\n\n### Query Structure\n\n```graphql\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    id\n    name\n    email\n  }\n}\n```\n\n### Mutation Structure\n\n```graphql\nmutation CreatePost($input: CreatePostInput!) {\n  createPost(input: $input) {\n    id\n    title\n    createdAt\n  }\n}\n```\n\n### Subscription Structure\n\n```graphql\nsubscription OnMessageReceived($channelId: ID!) {\n  messageReceived(channelId: $channelId) {\n    id\n    content\n    sender {\n      id\n      name\n    }\n  }\n}\n```\n\n## Quick Reference\n\n### Operation Naming\n\n| Pattern      | Example                                     |\n| ------------ | ------------------------------------------- |\n| Query        | `GetUser`, `ListPosts`, `SearchProducts`    |\n| Mutation     | `CreateUser`, `UpdatePost`, `DeleteComment` |\n| Subscription | `OnMessageReceived`, `OnUserStatusChanged`  |\n\n### Variable Syntax\n\n```graphql\n# Required variable\nquery GetUser($id: ID!) { ... }\n\n# Optional variable with default\nquery ListPosts($first: Int = 20) { ... }\n\n# Multiple variables\nquery SearchPosts($query: String!, $status: PostStatus, $first: Int = 10) { ... }\n```\n\n### Fragment Syntax\n\n```graphql\n# Define fragment\nfragment UserBasicInfo on User {\n  id\n  name\n  avatarUrl\n}\n\n# Use fragment\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    ...UserBasicInfo\n    email\n  }\n}\n```\n\n### Directives\n\n```graphql\nquery GetUser($id: ID!, $includeEmail: Boolean!) {\n  user(id: $id) {\n    id\n    name\n    email @include(if: $includeEmail)\n  }\n}\n\nquery GetPosts($skipDrafts: Boolean!) {\n  posts {\n    id\n    title\n    draft @skip(if: $skipDrafts)\n  }\n}\n```\n\n## Key Principles\n\n### 1. Request Only What You Need\n\n```graphql\n# Good: Specific fields\nquery GetUserName($id: ID!) {\n  user(id: $id) {\n    id\n    name\n  }\n}\n\n# Avoid: Over-fetching\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    id\n    name\n    email\n    bio\n    posts {\n      id\n      title\n      content\n      comments {\n        id\n      }\n    }\n    followers {\n      id\n      name\n    }\n    # ... many unused fields\n  }\n}\n```\n\n### 2. Name All Operations\n\n```graphql\n# Good: Named operation\nquery GetUserPosts($userId: ID!) {\n  user(id: $userId) {\n    posts {\n      id\n      title\n    }\n  }\n}\n\n# Avoid: Anonymous operation\nquery {\n  user(id: \"123\") {\n    posts {\n      id\n      title\n    }\n  }\n}\n```\n\n### 3. Use Variables, Not Inline Values\n\n```graphql\n# Good: Variables\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    id\n    name\n  }\n}\n\n# Avoid: Hardcoded values\nquery {\n  user(id: \"123\") {\n    id\n    name\n  }\n}\n```\n\n### 4. Colocate Fragments with Components\n\n```tsx\n\u002F\u002F UserAvatar.tsx\nexport const USER_AVATAR_FRAGMENT = gql`\n  fragment UserAvatar on User {\n    id\n    name\n    avatarUrl\n  }\n`;\n\nfunction UserAvatar({ user }) {\n  return \u003Cimg src={user.avatarUrl} alt={user.name} \u002F>;\n}\n```\n\n## Reference Files\n\nDetailed documentation for specific topics:\n\n- [Queries](references\u002Fqueries.md) - Query patterns and optimization\n- [Mutations](references\u002Fmutations.md) - Mutation patterns and error handling\n- [Fragments](references\u002Ffragments.md) - Fragment organization and reuse\n- [Variables](references\u002Fvariables.md) - Variable usage and types\n- [Tooling](references\u002Ftooling.md) - Code generation and linting\n\n## Ground Rules\n\n- ALWAYS name your operations (no anonymous queries\u002Fmutations)\n- ALWAYS use variables for dynamic values\n- ALWAYS request only the fields you need\n- ALWAYS include `id` field for cacheable types\n- NEVER hardcode values in operations\n- NEVER duplicate field selections across files\n- PREFER fragments for reusable field selections\n- PREFER colocating fragments with components\n- USE descriptive operation names that reflect purpose\n- USE `@include`\u002F`@skip` for conditional fields\n",{"data":35,"body":40},{"name":4,"description":6,"license":24,"compatibility":36,"metadata":37,"allowed-tools":39},"Any GraphQL client (Apollo Client, urql, Relay, etc.)",{"author":11,"version":38},"1.0.0","Bash(npm:*) Bash(npx:*) Read Write Edit Glob Grep",{"type":41,"children":42},"root",[43,52,58,65,72,148,154,214,220,307,313,319,434,440,511,517,632,638,756,762,768,1012,1018,1164,1170,1284,1290,1521,1527,1532,1593,1599,1676],{"type":44,"tag":45,"props":46,"children":48},"element","h1",{"id":47},"graphql-operations-guide",[49],{"type":50,"value":51},"text","GraphQL Operations Guide",{"type":44,"tag":53,"props":54,"children":55},"p",{},[56],{"type":50,"value":57},"This guide covers best practices for writing GraphQL operations (queries, mutations, subscriptions) as a client developer. Well-written operations are efficient, type-safe, and maintainable.",{"type":44,"tag":59,"props":60,"children":62},"h2",{"id":61},"operation-basics",[63],{"type":50,"value":64},"Operation Basics",{"type":44,"tag":66,"props":67,"children":69},"h3",{"id":68},"query-structure",[70],{"type":50,"value":71},"Query Structure",{"type":44,"tag":73,"props":74,"children":78},"pre",{"className":75,"code":76,"language":15,"meta":77,"style":77},"language-graphql shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","query GetUser($id: ID!) {\n  user(id: $id) {\n    id\n    name\n    email\n  }\n}\n","",[79],{"type":44,"tag":80,"props":81,"children":82},"code",{"__ignoreMap":77},[83,94,103,112,121,130,139],{"type":44,"tag":84,"props":85,"children":88},"span",{"class":86,"line":87},"line",1,[89],{"type":44,"tag":84,"props":90,"children":91},{},[92],{"type":50,"value":93},"query GetUser($id: ID!) {\n",{"type":44,"tag":84,"props":95,"children":97},{"class":86,"line":96},2,[98],{"type":44,"tag":84,"props":99,"children":100},{},[101],{"type":50,"value":102},"  user(id: $id) {\n",{"type":44,"tag":84,"props":104,"children":106},{"class":86,"line":105},3,[107],{"type":44,"tag":84,"props":108,"children":109},{},[110],{"type":50,"value":111},"    id\n",{"type":44,"tag":84,"props":113,"children":115},{"class":86,"line":114},4,[116],{"type":44,"tag":84,"props":117,"children":118},{},[119],{"type":50,"value":120},"    name\n",{"type":44,"tag":84,"props":122,"children":124},{"class":86,"line":123},5,[125],{"type":44,"tag":84,"props":126,"children":127},{},[128],{"type":50,"value":129},"    email\n",{"type":44,"tag":84,"props":131,"children":133},{"class":86,"line":132},6,[134],{"type":44,"tag":84,"props":135,"children":136},{},[137],{"type":50,"value":138},"  }\n",{"type":44,"tag":84,"props":140,"children":142},{"class":86,"line":141},7,[143],{"type":44,"tag":84,"props":144,"children":145},{},[146],{"type":50,"value":147},"}\n",{"type":44,"tag":66,"props":149,"children":151},{"id":150},"mutation-structure",[152],{"type":50,"value":153},"Mutation Structure",{"type":44,"tag":73,"props":155,"children":157},{"className":75,"code":156,"language":15,"meta":77,"style":77},"mutation CreatePost($input: CreatePostInput!) {\n  createPost(input: $input) {\n    id\n    title\n    createdAt\n  }\n}\n",[158],{"type":44,"tag":80,"props":159,"children":160},{"__ignoreMap":77},[161,169,177,184,192,200,207],{"type":44,"tag":84,"props":162,"children":163},{"class":86,"line":87},[164],{"type":44,"tag":84,"props":165,"children":166},{},[167],{"type":50,"value":168},"mutation CreatePost($input: CreatePostInput!) {\n",{"type":44,"tag":84,"props":170,"children":171},{"class":86,"line":96},[172],{"type":44,"tag":84,"props":173,"children":174},{},[175],{"type":50,"value":176},"  createPost(input: $input) {\n",{"type":44,"tag":84,"props":178,"children":179},{"class":86,"line":105},[180],{"type":44,"tag":84,"props":181,"children":182},{},[183],{"type":50,"value":111},{"type":44,"tag":84,"props":185,"children":186},{"class":86,"line":114},[187],{"type":44,"tag":84,"props":188,"children":189},{},[190],{"type":50,"value":191},"    title\n",{"type":44,"tag":84,"props":193,"children":194},{"class":86,"line":123},[195],{"type":44,"tag":84,"props":196,"children":197},{},[198],{"type":50,"value":199},"    createdAt\n",{"type":44,"tag":84,"props":201,"children":202},{"class":86,"line":132},[203],{"type":44,"tag":84,"props":204,"children":205},{},[206],{"type":50,"value":138},{"type":44,"tag":84,"props":208,"children":209},{"class":86,"line":141},[210],{"type":44,"tag":84,"props":211,"children":212},{},[213],{"type":50,"value":147},{"type":44,"tag":66,"props":215,"children":217},{"id":216},"subscription-structure",[218],{"type":50,"value":219},"Subscription Structure",{"type":44,"tag":73,"props":221,"children":223},{"className":75,"code":222,"language":15,"meta":77,"style":77},"subscription OnMessageReceived($channelId: ID!) {\n  messageReceived(channelId: $channelId) {\n    id\n    content\n    sender {\n      id\n      name\n    }\n  }\n}\n",[224],{"type":44,"tag":80,"props":225,"children":226},{"__ignoreMap":77},[227,235,243,250,258,266,274,282,291,299],{"type":44,"tag":84,"props":228,"children":229},{"class":86,"line":87},[230],{"type":44,"tag":84,"props":231,"children":232},{},[233],{"type":50,"value":234},"subscription OnMessageReceived($channelId: ID!) {\n",{"type":44,"tag":84,"props":236,"children":237},{"class":86,"line":96},[238],{"type":44,"tag":84,"props":239,"children":240},{},[241],{"type":50,"value":242},"  messageReceived(channelId: $channelId) {\n",{"type":44,"tag":84,"props":244,"children":245},{"class":86,"line":105},[246],{"type":44,"tag":84,"props":247,"children":248},{},[249],{"type":50,"value":111},{"type":44,"tag":84,"props":251,"children":252},{"class":86,"line":114},[253],{"type":44,"tag":84,"props":254,"children":255},{},[256],{"type":50,"value":257},"    content\n",{"type":44,"tag":84,"props":259,"children":260},{"class":86,"line":123},[261],{"type":44,"tag":84,"props":262,"children":263},{},[264],{"type":50,"value":265},"    sender {\n",{"type":44,"tag":84,"props":267,"children":268},{"class":86,"line":132},[269],{"type":44,"tag":84,"props":270,"children":271},{},[272],{"type":50,"value":273},"      id\n",{"type":44,"tag":84,"props":275,"children":276},{"class":86,"line":141},[277],{"type":44,"tag":84,"props":278,"children":279},{},[280],{"type":50,"value":281},"      name\n",{"type":44,"tag":84,"props":283,"children":285},{"class":86,"line":284},8,[286],{"type":44,"tag":84,"props":287,"children":288},{},[289],{"type":50,"value":290},"    }\n",{"type":44,"tag":84,"props":292,"children":294},{"class":86,"line":293},9,[295],{"type":44,"tag":84,"props":296,"children":297},{},[298],{"type":50,"value":138},{"type":44,"tag":84,"props":300,"children":302},{"class":86,"line":301},10,[303],{"type":44,"tag":84,"props":304,"children":305},{},[306],{"type":50,"value":147},{"type":44,"tag":59,"props":308,"children":310},{"id":309},"quick-reference",[311],{"type":50,"value":312},"Quick Reference",{"type":44,"tag":66,"props":314,"children":316},{"id":315},"operation-naming",[317],{"type":50,"value":318},"Operation Naming",{"type":44,"tag":320,"props":321,"children":322},"table",{},[323,342],{"type":44,"tag":324,"props":325,"children":326},"thead",{},[327],{"type":44,"tag":328,"props":329,"children":330},"tr",{},[331,337],{"type":44,"tag":332,"props":333,"children":334},"th",{},[335],{"type":50,"value":336},"Pattern",{"type":44,"tag":332,"props":338,"children":339},{},[340],{"type":50,"value":341},"Example",{"type":44,"tag":343,"props":344,"children":345},"tbody",{},[346,379,410],{"type":44,"tag":328,"props":347,"children":348},{},[349,355],{"type":44,"tag":350,"props":351,"children":352},"td",{},[353],{"type":50,"value":354},"Query",{"type":44,"tag":350,"props":356,"children":357},{},[358,364,366,372,373],{"type":44,"tag":80,"props":359,"children":361},{"className":360},[],[362],{"type":50,"value":363},"GetUser",{"type":50,"value":365},", ",{"type":44,"tag":80,"props":367,"children":369},{"className":368},[],[370],{"type":50,"value":371},"ListPosts",{"type":50,"value":365},{"type":44,"tag":80,"props":374,"children":376},{"className":375},[],[377],{"type":50,"value":378},"SearchProducts",{"type":44,"tag":328,"props":380,"children":381},{},[382,387],{"type":44,"tag":350,"props":383,"children":384},{},[385],{"type":50,"value":386},"Mutation",{"type":44,"tag":350,"props":388,"children":389},{},[390,396,397,403,404],{"type":44,"tag":80,"props":391,"children":393},{"className":392},[],[394],{"type":50,"value":395},"CreateUser",{"type":50,"value":365},{"type":44,"tag":80,"props":398,"children":400},{"className":399},[],[401],{"type":50,"value":402},"UpdatePost",{"type":50,"value":365},{"type":44,"tag":80,"props":405,"children":407},{"className":406},[],[408],{"type":50,"value":409},"DeleteComment",{"type":44,"tag":328,"props":411,"children":412},{},[413,418],{"type":44,"tag":350,"props":414,"children":415},{},[416],{"type":50,"value":417},"Subscription",{"type":44,"tag":350,"props":419,"children":420},{},[421,427,428],{"type":44,"tag":80,"props":422,"children":424},{"className":423},[],[425],{"type":50,"value":426},"OnMessageReceived",{"type":50,"value":365},{"type":44,"tag":80,"props":429,"children":431},{"className":430},[],[432],{"type":50,"value":433},"OnUserStatusChanged",{"type":44,"tag":66,"props":435,"children":437},{"id":436},"variable-syntax",[438],{"type":50,"value":439},"Variable Syntax",{"type":44,"tag":73,"props":441,"children":443},{"className":75,"code":442,"language":15,"meta":77,"style":77},"# Required variable\nquery GetUser($id: ID!) { ... }\n\n# Optional variable with default\nquery ListPosts($first: Int = 20) { ... }\n\n# Multiple variables\nquery SearchPosts($query: String!, $status: PostStatus, $first: Int = 10) { ... }\n",[444],{"type":44,"tag":80,"props":445,"children":446},{"__ignoreMap":77},[447,455,463,472,480,488,495,503],{"type":44,"tag":84,"props":448,"children":449},{"class":86,"line":87},[450],{"type":44,"tag":84,"props":451,"children":452},{},[453],{"type":50,"value":454},"# Required variable\n",{"type":44,"tag":84,"props":456,"children":457},{"class":86,"line":96},[458],{"type":44,"tag":84,"props":459,"children":460},{},[461],{"type":50,"value":462},"query GetUser($id: ID!) { ... }\n",{"type":44,"tag":84,"props":464,"children":465},{"class":86,"line":105},[466],{"type":44,"tag":84,"props":467,"children":469},{"emptyLinePlaceholder":468},true,[470],{"type":50,"value":471},"\n",{"type":44,"tag":84,"props":473,"children":474},{"class":86,"line":114},[475],{"type":44,"tag":84,"props":476,"children":477},{},[478],{"type":50,"value":479},"# Optional variable with default\n",{"type":44,"tag":84,"props":481,"children":482},{"class":86,"line":123},[483],{"type":44,"tag":84,"props":484,"children":485},{},[486],{"type":50,"value":487},"query ListPosts($first: Int = 20) { ... }\n",{"type":44,"tag":84,"props":489,"children":490},{"class":86,"line":132},[491],{"type":44,"tag":84,"props":492,"children":493},{"emptyLinePlaceholder":468},[494],{"type":50,"value":471},{"type":44,"tag":84,"props":496,"children":497},{"class":86,"line":141},[498],{"type":44,"tag":84,"props":499,"children":500},{},[501],{"type":50,"value":502},"# Multiple variables\n",{"type":44,"tag":84,"props":504,"children":505},{"class":86,"line":284},[506],{"type":44,"tag":84,"props":507,"children":508},{},[509],{"type":50,"value":510},"query SearchPosts($query: String!, $status: PostStatus, $first: Int = 10) { ... }\n",{"type":44,"tag":66,"props":512,"children":514},{"id":513},"fragment-syntax",[515],{"type":50,"value":516},"Fragment Syntax",{"type":44,"tag":73,"props":518,"children":520},{"className":75,"code":519,"language":15,"meta":77,"style":77},"# Define fragment\nfragment UserBasicInfo on User {\n  id\n  name\n  avatarUrl\n}\n\n# Use fragment\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    ...UserBasicInfo\n    email\n  }\n}\n",[521],{"type":44,"tag":80,"props":522,"children":523},{"__ignoreMap":77},[524,532,540,548,556,564,571,578,586,593,600,608,616,624],{"type":44,"tag":84,"props":525,"children":526},{"class":86,"line":87},[527],{"type":44,"tag":84,"props":528,"children":529},{},[530],{"type":50,"value":531},"# Define fragment\n",{"type":44,"tag":84,"props":533,"children":534},{"class":86,"line":96},[535],{"type":44,"tag":84,"props":536,"children":537},{},[538],{"type":50,"value":539},"fragment UserBasicInfo on User {\n",{"type":44,"tag":84,"props":541,"children":542},{"class":86,"line":105},[543],{"type":44,"tag":84,"props":544,"children":545},{},[546],{"type":50,"value":547},"  id\n",{"type":44,"tag":84,"props":549,"children":550},{"class":86,"line":114},[551],{"type":44,"tag":84,"props":552,"children":553},{},[554],{"type":50,"value":555},"  name\n",{"type":44,"tag":84,"props":557,"children":558},{"class":86,"line":123},[559],{"type":44,"tag":84,"props":560,"children":561},{},[562],{"type":50,"value":563},"  avatarUrl\n",{"type":44,"tag":84,"props":565,"children":566},{"class":86,"line":132},[567],{"type":44,"tag":84,"props":568,"children":569},{},[570],{"type":50,"value":147},{"type":44,"tag":84,"props":572,"children":573},{"class":86,"line":141},[574],{"type":44,"tag":84,"props":575,"children":576},{"emptyLinePlaceholder":468},[577],{"type":50,"value":471},{"type":44,"tag":84,"props":579,"children":580},{"class":86,"line":284},[581],{"type":44,"tag":84,"props":582,"children":583},{},[584],{"type":50,"value":585},"# Use fragment\n",{"type":44,"tag":84,"props":587,"children":588},{"class":86,"line":293},[589],{"type":44,"tag":84,"props":590,"children":591},{},[592],{"type":50,"value":93},{"type":44,"tag":84,"props":594,"children":595},{"class":86,"line":301},[596],{"type":44,"tag":84,"props":597,"children":598},{},[599],{"type":50,"value":102},{"type":44,"tag":84,"props":601,"children":602},{"class":86,"line":25},[603],{"type":44,"tag":84,"props":604,"children":605},{},[606],{"type":50,"value":607},"    ...UserBasicInfo\n",{"type":44,"tag":84,"props":609,"children":611},{"class":86,"line":610},12,[612],{"type":44,"tag":84,"props":613,"children":614},{},[615],{"type":50,"value":129},{"type":44,"tag":84,"props":617,"children":619},{"class":86,"line":618},13,[620],{"type":44,"tag":84,"props":621,"children":622},{},[623],{"type":50,"value":138},{"type":44,"tag":84,"props":625,"children":627},{"class":86,"line":626},14,[628],{"type":44,"tag":84,"props":629,"children":630},{},[631],{"type":50,"value":147},{"type":44,"tag":66,"props":633,"children":635},{"id":634},"directives",[636],{"type":50,"value":637},"Directives",{"type":44,"tag":73,"props":639,"children":641},{"className":75,"code":640,"language":15,"meta":77,"style":77},"query GetUser($id: ID!, $includeEmail: Boolean!) {\n  user(id: $id) {\n    id\n    name\n    email @include(if: $includeEmail)\n  }\n}\n\nquery GetPosts($skipDrafts: Boolean!) {\n  posts {\n    id\n    title\n    draft @skip(if: $skipDrafts)\n  }\n}\n",[642],{"type":44,"tag":80,"props":643,"children":644},{"__ignoreMap":77},[645,653,660,667,674,682,689,696,703,711,719,726,733,741,748],{"type":44,"tag":84,"props":646,"children":647},{"class":86,"line":87},[648],{"type":44,"tag":84,"props":649,"children":650},{},[651],{"type":50,"value":652},"query GetUser($id: ID!, $includeEmail: Boolean!) {\n",{"type":44,"tag":84,"props":654,"children":655},{"class":86,"line":96},[656],{"type":44,"tag":84,"props":657,"children":658},{},[659],{"type":50,"value":102},{"type":44,"tag":84,"props":661,"children":662},{"class":86,"line":105},[663],{"type":44,"tag":84,"props":664,"children":665},{},[666],{"type":50,"value":111},{"type":44,"tag":84,"props":668,"children":669},{"class":86,"line":114},[670],{"type":44,"tag":84,"props":671,"children":672},{},[673],{"type":50,"value":120},{"type":44,"tag":84,"props":675,"children":676},{"class":86,"line":123},[677],{"type":44,"tag":84,"props":678,"children":679},{},[680],{"type":50,"value":681},"    email @include(if: $includeEmail)\n",{"type":44,"tag":84,"props":683,"children":684},{"class":86,"line":132},[685],{"type":44,"tag":84,"props":686,"children":687},{},[688],{"type":50,"value":138},{"type":44,"tag":84,"props":690,"children":691},{"class":86,"line":141},[692],{"type":44,"tag":84,"props":693,"children":694},{},[695],{"type":50,"value":147},{"type":44,"tag":84,"props":697,"children":698},{"class":86,"line":284},[699],{"type":44,"tag":84,"props":700,"children":701},{"emptyLinePlaceholder":468},[702],{"type":50,"value":471},{"type":44,"tag":84,"props":704,"children":705},{"class":86,"line":293},[706],{"type":44,"tag":84,"props":707,"children":708},{},[709],{"type":50,"value":710},"query GetPosts($skipDrafts: Boolean!) {\n",{"type":44,"tag":84,"props":712,"children":713},{"class":86,"line":301},[714],{"type":44,"tag":84,"props":715,"children":716},{},[717],{"type":50,"value":718},"  posts {\n",{"type":44,"tag":84,"props":720,"children":721},{"class":86,"line":25},[722],{"type":44,"tag":84,"props":723,"children":724},{},[725],{"type":50,"value":111},{"type":44,"tag":84,"props":727,"children":728},{"class":86,"line":610},[729],{"type":44,"tag":84,"props":730,"children":731},{},[732],{"type":50,"value":191},{"type":44,"tag":84,"props":734,"children":735},{"class":86,"line":618},[736],{"type":44,"tag":84,"props":737,"children":738},{},[739],{"type":50,"value":740},"    draft @skip(if: $skipDrafts)\n",{"type":44,"tag":84,"props":742,"children":743},{"class":86,"line":626},[744],{"type":44,"tag":84,"props":745,"children":746},{},[747],{"type":50,"value":138},{"type":44,"tag":84,"props":749,"children":751},{"class":86,"line":750},15,[752],{"type":44,"tag":84,"props":753,"children":754},{},[755],{"type":50,"value":147},{"type":44,"tag":59,"props":757,"children":759},{"id":758},"key-principles",[760],{"type":50,"value":761},"Key Principles",{"type":44,"tag":66,"props":763,"children":765},{"id":764},"_1-request-only-what-you-need",[766],{"type":50,"value":767},"1. Request Only What You Need",{"type":44,"tag":73,"props":769,"children":771},{"className":75,"code":770,"language":15,"meta":77,"style":77},"# Good: Specific fields\nquery GetUserName($id: ID!) {\n  user(id: $id) {\n    id\n    name\n  }\n}\n\n# Avoid: Over-fetching\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    id\n    name\n    email\n    bio\n    posts {\n      id\n      title\n      content\n      comments {\n        id\n      }\n    }\n    followers {\n      id\n      name\n    }\n    # ... many unused fields\n  }\n}\n",[772],{"type":44,"tag":80,"props":773,"children":774},{"__ignoreMap":77},[775,783,791,798,805,812,819,826,833,841,848,855,862,869,876,884,893,901,910,919,928,937,946,954,963,971,979,987,996,1004],{"type":44,"tag":84,"props":776,"children":777},{"class":86,"line":87},[778],{"type":44,"tag":84,"props":779,"children":780},{},[781],{"type":50,"value":782},"# Good: Specific fields\n",{"type":44,"tag":84,"props":784,"children":785},{"class":86,"line":96},[786],{"type":44,"tag":84,"props":787,"children":788},{},[789],{"type":50,"value":790},"query GetUserName($id: ID!) {\n",{"type":44,"tag":84,"props":792,"children":793},{"class":86,"line":105},[794],{"type":44,"tag":84,"props":795,"children":796},{},[797],{"type":50,"value":102},{"type":44,"tag":84,"props":799,"children":800},{"class":86,"line":114},[801],{"type":44,"tag":84,"props":802,"children":803},{},[804],{"type":50,"value":111},{"type":44,"tag":84,"props":806,"children":807},{"class":86,"line":123},[808],{"type":44,"tag":84,"props":809,"children":810},{},[811],{"type":50,"value":120},{"type":44,"tag":84,"props":813,"children":814},{"class":86,"line":132},[815],{"type":44,"tag":84,"props":816,"children":817},{},[818],{"type":50,"value":138},{"type":44,"tag":84,"props":820,"children":821},{"class":86,"line":141},[822],{"type":44,"tag":84,"props":823,"children":824},{},[825],{"type":50,"value":147},{"type":44,"tag":84,"props":827,"children":828},{"class":86,"line":284},[829],{"type":44,"tag":84,"props":830,"children":831},{"emptyLinePlaceholder":468},[832],{"type":50,"value":471},{"type":44,"tag":84,"props":834,"children":835},{"class":86,"line":293},[836],{"type":44,"tag":84,"props":837,"children":838},{},[839],{"type":50,"value":840},"# Avoid: Over-fetching\n",{"type":44,"tag":84,"props":842,"children":843},{"class":86,"line":301},[844],{"type":44,"tag":84,"props":845,"children":846},{},[847],{"type":50,"value":93},{"type":44,"tag":84,"props":849,"children":850},{"class":86,"line":25},[851],{"type":44,"tag":84,"props":852,"children":853},{},[854],{"type":50,"value":102},{"type":44,"tag":84,"props":856,"children":857},{"class":86,"line":610},[858],{"type":44,"tag":84,"props":859,"children":860},{},[861],{"type":50,"value":111},{"type":44,"tag":84,"props":863,"children":864},{"class":86,"line":618},[865],{"type":44,"tag":84,"props":866,"children":867},{},[868],{"type":50,"value":120},{"type":44,"tag":84,"props":870,"children":871},{"class":86,"line":626},[872],{"type":44,"tag":84,"props":873,"children":874},{},[875],{"type":50,"value":129},{"type":44,"tag":84,"props":877,"children":878},{"class":86,"line":750},[879],{"type":44,"tag":84,"props":880,"children":881},{},[882],{"type":50,"value":883},"    bio\n",{"type":44,"tag":84,"props":885,"children":887},{"class":86,"line":886},16,[888],{"type":44,"tag":84,"props":889,"children":890},{},[891],{"type":50,"value":892},"    posts {\n",{"type":44,"tag":84,"props":894,"children":896},{"class":86,"line":895},17,[897],{"type":44,"tag":84,"props":898,"children":899},{},[900],{"type":50,"value":273},{"type":44,"tag":84,"props":902,"children":904},{"class":86,"line":903},18,[905],{"type":44,"tag":84,"props":906,"children":907},{},[908],{"type":50,"value":909},"      title\n",{"type":44,"tag":84,"props":911,"children":913},{"class":86,"line":912},19,[914],{"type":44,"tag":84,"props":915,"children":916},{},[917],{"type":50,"value":918},"      content\n",{"type":44,"tag":84,"props":920,"children":922},{"class":86,"line":921},20,[923],{"type":44,"tag":84,"props":924,"children":925},{},[926],{"type":50,"value":927},"      comments {\n",{"type":44,"tag":84,"props":929,"children":931},{"class":86,"line":930},21,[932],{"type":44,"tag":84,"props":933,"children":934},{},[935],{"type":50,"value":936},"        id\n",{"type":44,"tag":84,"props":938,"children":940},{"class":86,"line":939},22,[941],{"type":44,"tag":84,"props":942,"children":943},{},[944],{"type":50,"value":945},"      }\n",{"type":44,"tag":84,"props":947,"children":949},{"class":86,"line":948},23,[950],{"type":44,"tag":84,"props":951,"children":952},{},[953],{"type":50,"value":290},{"type":44,"tag":84,"props":955,"children":957},{"class":86,"line":956},24,[958],{"type":44,"tag":84,"props":959,"children":960},{},[961],{"type":50,"value":962},"    followers {\n",{"type":44,"tag":84,"props":964,"children":966},{"class":86,"line":965},25,[967],{"type":44,"tag":84,"props":968,"children":969},{},[970],{"type":50,"value":273},{"type":44,"tag":84,"props":972,"children":974},{"class":86,"line":973},26,[975],{"type":44,"tag":84,"props":976,"children":977},{},[978],{"type":50,"value":281},{"type":44,"tag":84,"props":980,"children":982},{"class":86,"line":981},27,[983],{"type":44,"tag":84,"props":984,"children":985},{},[986],{"type":50,"value":290},{"type":44,"tag":84,"props":988,"children":990},{"class":86,"line":989},28,[991],{"type":44,"tag":84,"props":992,"children":993},{},[994],{"type":50,"value":995},"    # ... many unused fields\n",{"type":44,"tag":84,"props":997,"children":999},{"class":86,"line":998},29,[1000],{"type":44,"tag":84,"props":1001,"children":1002},{},[1003],{"type":50,"value":138},{"type":44,"tag":84,"props":1005,"children":1007},{"class":86,"line":1006},30,[1008],{"type":44,"tag":84,"props":1009,"children":1010},{},[1011],{"type":50,"value":147},{"type":44,"tag":66,"props":1013,"children":1015},{"id":1014},"_2-name-all-operations",[1016],{"type":50,"value":1017},"2. Name All Operations",{"type":44,"tag":73,"props":1019,"children":1021},{"className":75,"code":1020,"language":15,"meta":77,"style":77},"# Good: Named operation\nquery GetUserPosts($userId: ID!) {\n  user(id: $userId) {\n    posts {\n      id\n      title\n    }\n  }\n}\n\n# Avoid: Anonymous operation\nquery {\n  user(id: \"123\") {\n    posts {\n      id\n      title\n    }\n  }\n}\n",[1022],{"type":44,"tag":80,"props":1023,"children":1024},{"__ignoreMap":77},[1025,1033,1041,1049,1056,1063,1070,1077,1084,1091,1098,1106,1114,1122,1129,1136,1143,1150,1157],{"type":44,"tag":84,"props":1026,"children":1027},{"class":86,"line":87},[1028],{"type":44,"tag":84,"props":1029,"children":1030},{},[1031],{"type":50,"value":1032},"# Good: Named operation\n",{"type":44,"tag":84,"props":1034,"children":1035},{"class":86,"line":96},[1036],{"type":44,"tag":84,"props":1037,"children":1038},{},[1039],{"type":50,"value":1040},"query GetUserPosts($userId: ID!) {\n",{"type":44,"tag":84,"props":1042,"children":1043},{"class":86,"line":105},[1044],{"type":44,"tag":84,"props":1045,"children":1046},{},[1047],{"type":50,"value":1048},"  user(id: $userId) {\n",{"type":44,"tag":84,"props":1050,"children":1051},{"class":86,"line":114},[1052],{"type":44,"tag":84,"props":1053,"children":1054},{},[1055],{"type":50,"value":892},{"type":44,"tag":84,"props":1057,"children":1058},{"class":86,"line":123},[1059],{"type":44,"tag":84,"props":1060,"children":1061},{},[1062],{"type":50,"value":273},{"type":44,"tag":84,"props":1064,"children":1065},{"class":86,"line":132},[1066],{"type":44,"tag":84,"props":1067,"children":1068},{},[1069],{"type":50,"value":909},{"type":44,"tag":84,"props":1071,"children":1072},{"class":86,"line":141},[1073],{"type":44,"tag":84,"props":1074,"children":1075},{},[1076],{"type":50,"value":290},{"type":44,"tag":84,"props":1078,"children":1079},{"class":86,"line":284},[1080],{"type":44,"tag":84,"props":1081,"children":1082},{},[1083],{"type":50,"value":138},{"type":44,"tag":84,"props":1085,"children":1086},{"class":86,"line":293},[1087],{"type":44,"tag":84,"props":1088,"children":1089},{},[1090],{"type":50,"value":147},{"type":44,"tag":84,"props":1092,"children":1093},{"class":86,"line":301},[1094],{"type":44,"tag":84,"props":1095,"children":1096},{"emptyLinePlaceholder":468},[1097],{"type":50,"value":471},{"type":44,"tag":84,"props":1099,"children":1100},{"class":86,"line":25},[1101],{"type":44,"tag":84,"props":1102,"children":1103},{},[1104],{"type":50,"value":1105},"# Avoid: Anonymous operation\n",{"type":44,"tag":84,"props":1107,"children":1108},{"class":86,"line":610},[1109],{"type":44,"tag":84,"props":1110,"children":1111},{},[1112],{"type":50,"value":1113},"query {\n",{"type":44,"tag":84,"props":1115,"children":1116},{"class":86,"line":618},[1117],{"type":44,"tag":84,"props":1118,"children":1119},{},[1120],{"type":50,"value":1121},"  user(id: \"123\") {\n",{"type":44,"tag":84,"props":1123,"children":1124},{"class":86,"line":626},[1125],{"type":44,"tag":84,"props":1126,"children":1127},{},[1128],{"type":50,"value":892},{"type":44,"tag":84,"props":1130,"children":1131},{"class":86,"line":750},[1132],{"type":44,"tag":84,"props":1133,"children":1134},{},[1135],{"type":50,"value":273},{"type":44,"tag":84,"props":1137,"children":1138},{"class":86,"line":886},[1139],{"type":44,"tag":84,"props":1140,"children":1141},{},[1142],{"type":50,"value":909},{"type":44,"tag":84,"props":1144,"children":1145},{"class":86,"line":895},[1146],{"type":44,"tag":84,"props":1147,"children":1148},{},[1149],{"type":50,"value":290},{"type":44,"tag":84,"props":1151,"children":1152},{"class":86,"line":903},[1153],{"type":44,"tag":84,"props":1154,"children":1155},{},[1156],{"type":50,"value":138},{"type":44,"tag":84,"props":1158,"children":1159},{"class":86,"line":912},[1160],{"type":44,"tag":84,"props":1161,"children":1162},{},[1163],{"type":50,"value":147},{"type":44,"tag":66,"props":1165,"children":1167},{"id":1166},"_3-use-variables-not-inline-values",[1168],{"type":50,"value":1169},"3. Use Variables, Not Inline Values",{"type":44,"tag":73,"props":1171,"children":1173},{"className":75,"code":1172,"language":15,"meta":77,"style":77},"# Good: Variables\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    id\n    name\n  }\n}\n\n# Avoid: Hardcoded values\nquery {\n  user(id: \"123\") {\n    id\n    name\n  }\n}\n",[1174],{"type":44,"tag":80,"props":1175,"children":1176},{"__ignoreMap":77},[1177,1185,1192,1199,1206,1213,1220,1227,1234,1242,1249,1256,1263,1270,1277],{"type":44,"tag":84,"props":1178,"children":1179},{"class":86,"line":87},[1180],{"type":44,"tag":84,"props":1181,"children":1182},{},[1183],{"type":50,"value":1184},"# Good: Variables\n",{"type":44,"tag":84,"props":1186,"children":1187},{"class":86,"line":96},[1188],{"type":44,"tag":84,"props":1189,"children":1190},{},[1191],{"type":50,"value":93},{"type":44,"tag":84,"props":1193,"children":1194},{"class":86,"line":105},[1195],{"type":44,"tag":84,"props":1196,"children":1197},{},[1198],{"type":50,"value":102},{"type":44,"tag":84,"props":1200,"children":1201},{"class":86,"line":114},[1202],{"type":44,"tag":84,"props":1203,"children":1204},{},[1205],{"type":50,"value":111},{"type":44,"tag":84,"props":1207,"children":1208},{"class":86,"line":123},[1209],{"type":44,"tag":84,"props":1210,"children":1211},{},[1212],{"type":50,"value":120},{"type":44,"tag":84,"props":1214,"children":1215},{"class":86,"line":132},[1216],{"type":44,"tag":84,"props":1217,"children":1218},{},[1219],{"type":50,"value":138},{"type":44,"tag":84,"props":1221,"children":1222},{"class":86,"line":141},[1223],{"type":44,"tag":84,"props":1224,"children":1225},{},[1226],{"type":50,"value":147},{"type":44,"tag":84,"props":1228,"children":1229},{"class":86,"line":284},[1230],{"type":44,"tag":84,"props":1231,"children":1232},{"emptyLinePlaceholder":468},[1233],{"type":50,"value":471},{"type":44,"tag":84,"props":1235,"children":1236},{"class":86,"line":293},[1237],{"type":44,"tag":84,"props":1238,"children":1239},{},[1240],{"type":50,"value":1241},"# Avoid: Hardcoded values\n",{"type":44,"tag":84,"props":1243,"children":1244},{"class":86,"line":301},[1245],{"type":44,"tag":84,"props":1246,"children":1247},{},[1248],{"type":50,"value":1113},{"type":44,"tag":84,"props":1250,"children":1251},{"class":86,"line":25},[1252],{"type":44,"tag":84,"props":1253,"children":1254},{},[1255],{"type":50,"value":1121},{"type":44,"tag":84,"props":1257,"children":1258},{"class":86,"line":610},[1259],{"type":44,"tag":84,"props":1260,"children":1261},{},[1262],{"type":50,"value":111},{"type":44,"tag":84,"props":1264,"children":1265},{"class":86,"line":618},[1266],{"type":44,"tag":84,"props":1267,"children":1268},{},[1269],{"type":50,"value":120},{"type":44,"tag":84,"props":1271,"children":1272},{"class":86,"line":626},[1273],{"type":44,"tag":84,"props":1274,"children":1275},{},[1276],{"type":50,"value":138},{"type":44,"tag":84,"props":1278,"children":1279},{"class":86,"line":750},[1280],{"type":44,"tag":84,"props":1281,"children":1282},{},[1283],{"type":50,"value":147},{"type":44,"tag":66,"props":1285,"children":1287},{"id":1286},"_4-colocate-fragments-with-components",[1288],{"type":50,"value":1289},"4. Colocate Fragments with Components",{"type":44,"tag":73,"props":1291,"children":1295},{"className":1292,"code":1293,"language":1294,"meta":77,"style":77},"language-tsx shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F UserAvatar.tsx\nexport const USER_AVATAR_FRAGMENT = gql`\n  fragment UserAvatar on User {\n    id\n    name\n    avatarUrl\n  }\n`;\n\nfunction UserAvatar({ user }) {\n  return \u003Cimg src={user.avatarUrl} alt={user.name} \u002F>;\n}\n","tsx",[1296],{"type":44,"tag":80,"props":1297,"children":1298},{"__ignoreMap":77},[1299,1308,1346,1355,1362,1369,1377,1384,1397,1404,1438,1514],{"type":44,"tag":84,"props":1300,"children":1301},{"class":86,"line":87},[1302],{"type":44,"tag":84,"props":1303,"children":1305},{"style":1304},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[1306],{"type":50,"value":1307},"\u002F\u002F UserAvatar.tsx\n",{"type":44,"tag":84,"props":1309,"children":1310},{"class":86,"line":96},[1311,1317,1323,1329,1335,1341],{"type":44,"tag":84,"props":1312,"children":1314},{"style":1313},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[1315],{"type":50,"value":1316},"export",{"type":44,"tag":84,"props":1318,"children":1320},{"style":1319},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1321],{"type":50,"value":1322}," const",{"type":44,"tag":84,"props":1324,"children":1326},{"style":1325},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1327],{"type":50,"value":1328}," USER_AVATAR_FRAGMENT ",{"type":44,"tag":84,"props":1330,"children":1332},{"style":1331},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1333],{"type":50,"value":1334},"=",{"type":44,"tag":84,"props":1336,"children":1338},{"style":1337},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[1339],{"type":50,"value":1340}," gql",{"type":44,"tag":84,"props":1342,"children":1343},{"style":1331},[1344],{"type":50,"value":1345},"`\n",{"type":44,"tag":84,"props":1347,"children":1348},{"class":86,"line":105},[1349],{"type":44,"tag":84,"props":1350,"children":1352},{"style":1351},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[1353],{"type":50,"value":1354},"  fragment UserAvatar on User {\n",{"type":44,"tag":84,"props":1356,"children":1357},{"class":86,"line":114},[1358],{"type":44,"tag":84,"props":1359,"children":1360},{"style":1351},[1361],{"type":50,"value":111},{"type":44,"tag":84,"props":1363,"children":1364},{"class":86,"line":123},[1365],{"type":44,"tag":84,"props":1366,"children":1367},{"style":1351},[1368],{"type":50,"value":120},{"type":44,"tag":84,"props":1370,"children":1371},{"class":86,"line":132},[1372],{"type":44,"tag":84,"props":1373,"children":1374},{"style":1351},[1375],{"type":50,"value":1376},"    avatarUrl\n",{"type":44,"tag":84,"props":1378,"children":1379},{"class":86,"line":141},[1380],{"type":44,"tag":84,"props":1381,"children":1382},{"style":1351},[1383],{"type":50,"value":138},{"type":44,"tag":84,"props":1385,"children":1386},{"class":86,"line":284},[1387,1392],{"type":44,"tag":84,"props":1388,"children":1389},{"style":1331},[1390],{"type":50,"value":1391},"`",{"type":44,"tag":84,"props":1393,"children":1394},{"style":1331},[1395],{"type":50,"value":1396},";\n",{"type":44,"tag":84,"props":1398,"children":1399},{"class":86,"line":293},[1400],{"type":44,"tag":84,"props":1401,"children":1402},{"emptyLinePlaceholder":468},[1403],{"type":50,"value":471},{"type":44,"tag":84,"props":1405,"children":1406},{"class":86,"line":301},[1407,1412,1417,1422,1428,1433],{"type":44,"tag":84,"props":1408,"children":1409},{"style":1319},[1410],{"type":50,"value":1411},"function",{"type":44,"tag":84,"props":1413,"children":1414},{"style":1337},[1415],{"type":50,"value":1416}," UserAvatar",{"type":44,"tag":84,"props":1418,"children":1419},{"style":1331},[1420],{"type":50,"value":1421},"({",{"type":44,"tag":84,"props":1423,"children":1425},{"style":1424},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic",[1426],{"type":50,"value":1427}," user",{"type":44,"tag":84,"props":1429,"children":1430},{"style":1331},[1431],{"type":50,"value":1432}," })",{"type":44,"tag":84,"props":1434,"children":1435},{"style":1331},[1436],{"type":50,"value":1437}," {\n",{"type":44,"tag":84,"props":1439,"children":1440},{"class":86,"line":25},[1441,1446,1451,1457,1462,1467,1472,1477,1482,1487,1492,1496,1500,1504,1509],{"type":44,"tag":84,"props":1442,"children":1443},{"style":1313},[1444],{"type":50,"value":1445},"  return",{"type":44,"tag":84,"props":1447,"children":1448},{"style":1331},[1449],{"type":50,"value":1450}," \u003C",{"type":44,"tag":84,"props":1452,"children":1454},{"style":1453},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1455],{"type":50,"value":1456},"img",{"type":44,"tag":84,"props":1458,"children":1459},{"style":1319},[1460],{"type":50,"value":1461}," src",{"type":44,"tag":84,"props":1463,"children":1464},{"style":1331},[1465],{"type":50,"value":1466},"={",{"type":44,"tag":84,"props":1468,"children":1469},{"style":1325},[1470],{"type":50,"value":1471},"user",{"type":44,"tag":84,"props":1473,"children":1474},{"style":1331},[1475],{"type":50,"value":1476},".",{"type":44,"tag":84,"props":1478,"children":1479},{"style":1325},[1480],{"type":50,"value":1481},"avatarUrl",{"type":44,"tag":84,"props":1483,"children":1484},{"style":1331},[1485],{"type":50,"value":1486},"} ",{"type":44,"tag":84,"props":1488,"children":1489},{"style":1319},[1490],{"type":50,"value":1491},"alt",{"type":44,"tag":84,"props":1493,"children":1494},{"style":1331},[1495],{"type":50,"value":1466},{"type":44,"tag":84,"props":1497,"children":1498},{"style":1325},[1499],{"type":50,"value":1471},{"type":44,"tag":84,"props":1501,"children":1502},{"style":1331},[1503],{"type":50,"value":1476},{"type":44,"tag":84,"props":1505,"children":1506},{"style":1325},[1507],{"type":50,"value":1508},"name",{"type":44,"tag":84,"props":1510,"children":1511},{"style":1331},[1512],{"type":50,"value":1513},"} \u002F>;\n",{"type":44,"tag":84,"props":1515,"children":1516},{"class":86,"line":610},[1517],{"type":44,"tag":84,"props":1518,"children":1519},{"style":1331},[1520],{"type":50,"value":147},{"type":44,"tag":59,"props":1522,"children":1524},{"id":1523},"reference-files",[1525],{"type":50,"value":1526},"Reference Files",{"type":44,"tag":53,"props":1528,"children":1529},{},[1530],{"type":50,"value":1531},"Detailed documentation for specific topics:",{"type":44,"tag":1533,"props":1534,"children":1535},"ul",{},[1536,1549,1560,1571,1582],{"type":44,"tag":1537,"props":1538,"children":1539},"li",{},[1540,1547],{"type":44,"tag":1541,"props":1542,"children":1544},"a",{"href":1543},"references\u002Fqueries.md",[1545],{"type":50,"value":1546},"Queries",{"type":50,"value":1548}," - Query patterns and optimization",{"type":44,"tag":1537,"props":1550,"children":1551},{},[1552,1558],{"type":44,"tag":1541,"props":1553,"children":1555},{"href":1554},"references\u002Fmutations.md",[1556],{"type":50,"value":1557},"Mutations",{"type":50,"value":1559}," - Mutation patterns and error handling",{"type":44,"tag":1537,"props":1561,"children":1562},{},[1563,1569],{"type":44,"tag":1541,"props":1564,"children":1566},{"href":1565},"references\u002Ffragments.md",[1567],{"type":50,"value":1568},"Fragments",{"type":50,"value":1570}," - Fragment organization and reuse",{"type":44,"tag":1537,"props":1572,"children":1573},{},[1574,1580],{"type":44,"tag":1541,"props":1575,"children":1577},{"href":1576},"references\u002Fvariables.md",[1578],{"type":50,"value":1579},"Variables",{"type":50,"value":1581}," - Variable usage and types",{"type":44,"tag":1537,"props":1583,"children":1584},{},[1585,1591],{"type":44,"tag":1541,"props":1586,"children":1588},{"href":1587},"references\u002Ftooling.md",[1589],{"type":50,"value":1590},"Tooling",{"type":50,"value":1592}," - Code generation and linting",{"type":44,"tag":59,"props":1594,"children":1596},{"id":1595},"ground-rules",[1597],{"type":50,"value":1598},"Ground Rules",{"type":44,"tag":1533,"props":1600,"children":1601},{},[1602,1607,1612,1617,1630,1635,1640,1645,1650,1655],{"type":44,"tag":1537,"props":1603,"children":1604},{},[1605],{"type":50,"value":1606},"ALWAYS name your operations (no anonymous queries\u002Fmutations)",{"type":44,"tag":1537,"props":1608,"children":1609},{},[1610],{"type":50,"value":1611},"ALWAYS use variables for dynamic values",{"type":44,"tag":1537,"props":1613,"children":1614},{},[1615],{"type":50,"value":1616},"ALWAYS request only the fields you need",{"type":44,"tag":1537,"props":1618,"children":1619},{},[1620,1622,1628],{"type":50,"value":1621},"ALWAYS include ",{"type":44,"tag":80,"props":1623,"children":1625},{"className":1624},[],[1626],{"type":50,"value":1627},"id",{"type":50,"value":1629}," field for cacheable types",{"type":44,"tag":1537,"props":1631,"children":1632},{},[1633],{"type":50,"value":1634},"NEVER hardcode values in operations",{"type":44,"tag":1537,"props":1636,"children":1637},{},[1638],{"type":50,"value":1639},"NEVER duplicate field selections across files",{"type":44,"tag":1537,"props":1641,"children":1642},{},[1643],{"type":50,"value":1644},"PREFER fragments for reusable field selections",{"type":44,"tag":1537,"props":1646,"children":1647},{},[1648],{"type":50,"value":1649},"PREFER colocating fragments with components",{"type":44,"tag":1537,"props":1651,"children":1652},{},[1653],{"type":50,"value":1654},"USE descriptive operation names that reflect purpose",{"type":44,"tag":1537,"props":1656,"children":1657},{},[1658,1660,1666,1668,1674],{"type":50,"value":1659},"USE ",{"type":44,"tag":80,"props":1661,"children":1663},{"className":1662},[],[1664],{"type":50,"value":1665},"@include",{"type":50,"value":1667},"\u002F",{"type":44,"tag":80,"props":1669,"children":1671},{"className":1670},[],[1672],{"type":50,"value":1673},"@skip",{"type":50,"value":1675}," for conditional fields",{"type":44,"tag":1677,"props":1678,"children":1679},"style",{},[1680],{"type":50,"value":1681},"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":1683,"total":626},[1684,1699,1712,1725,1746,1761,1774],{"slug":1685,"name":1685,"fn":1686,"description":1687,"org":1688,"tags":1689,"stars":21,"repoUrl":22,"updatedAt":1698},"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},[1690,1691,1694,1695],{"name":9,"slug":8,"type":16},{"name":1692,"slug":1693,"type":16},"Frontend","frontend",{"name":14,"slug":15,"type":16},{"name":1696,"slug":1697,"type":16},"React","react","2026-04-06T18:01:12.268638",{"slug":1700,"name":1700,"fn":1701,"description":1702,"org":1703,"tags":1704,"stars":21,"repoUrl":22,"updatedAt":1711},"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},[1705,1706,1707,1708],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1709,"slug":1710,"type":16},"REST API","rest-api","2026-04-06T18:01:23.758345",{"slug":1713,"name":1713,"fn":1714,"description":1715,"org":1716,"tags":1717,"stars":21,"repoUrl":22,"updatedAt":1724},"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},[1718,1719,1720,1723],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":1721,"slug":1722,"type":16},"Architecture","architecture",{"name":14,"slug":15,"type":16},"2026-07-30T05:31:51.648593",{"slug":1726,"name":1726,"fn":1727,"description":1728,"org":1729,"tags":1730,"stars":21,"repoUrl":22,"updatedAt":1745},"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},[1731,1732,1733,1736,1739,1742],{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1734,"slug":1735,"type":16},"iOS","ios",{"name":1737,"slug":1738,"type":16},"Mobile","mobile",{"name":1740,"slug":1741,"type":16},"Swift","swift",{"name":1743,"slug":1744,"type":16},"Xcode","xcode","2026-04-29T05:35:21.329969",{"slug":1747,"name":1747,"fn":1748,"description":1749,"org":1750,"tags":1751,"stars":21,"repoUrl":22,"updatedAt":1760},"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},[1752,1755,1756,1757],{"name":1753,"slug":1754,"type":16},"Android","android",{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1758,"slug":1759,"type":16},"Kotlin","kotlin","2026-04-06T18:01:15.005978",{"slug":1762,"name":1762,"fn":1763,"description":1764,"org":1765,"tags":1766,"stars":21,"repoUrl":22,"updatedAt":1773},"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},[1767,1768,1769,1770],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1771,"slug":1772,"type":16},"MCP","mcp","2026-04-06T18:01:20.578589",{"slug":1775,"name":1775,"fn":1776,"description":1777,"org":1778,"tags":1779,"stars":21,"repoUrl":22,"updatedAt":1786},"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},[1780,1781,1782,1785],{"name":9,"slug":8,"type":16},{"name":1721,"slug":1722,"type":16},{"name":1783,"slug":1784,"type":16},"Deployment","deployment",{"name":14,"slug":15,"type":16},"2026-07-30T05:31:54.665938",{"items":1788,"total":750},[1789,1796,1803,1810,1819,1826,1833,1840,1855,1871,1877,1888],{"slug":1685,"name":1685,"fn":1686,"description":1687,"org":1790,"tags":1791,"stars":21,"repoUrl":22,"updatedAt":1698},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1792,1793,1794,1795],{"name":9,"slug":8,"type":16},{"name":1692,"slug":1693,"type":16},{"name":14,"slug":15,"type":16},{"name":1696,"slug":1697,"type":16},{"slug":1700,"name":1700,"fn":1701,"description":1702,"org":1797,"tags":1798,"stars":21,"repoUrl":22,"updatedAt":1711},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1799,1800,1801,1802],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1709,"slug":1710,"type":16},{"slug":1713,"name":1713,"fn":1714,"description":1715,"org":1804,"tags":1805,"stars":21,"repoUrl":22,"updatedAt":1724},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1806,1807,1808,1809],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":1721,"slug":1722,"type":16},{"name":14,"slug":15,"type":16},{"slug":1726,"name":1726,"fn":1727,"description":1728,"org":1811,"tags":1812,"stars":21,"repoUrl":22,"updatedAt":1745},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1813,1814,1815,1816,1817,1818],{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1734,"slug":1735,"type":16},{"name":1737,"slug":1738,"type":16},{"name":1740,"slug":1741,"type":16},{"name":1743,"slug":1744,"type":16},{"slug":1747,"name":1747,"fn":1748,"description":1749,"org":1820,"tags":1821,"stars":21,"repoUrl":22,"updatedAt":1760},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1822,1823,1824,1825],{"name":1753,"slug":1754,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1758,"slug":1759,"type":16},{"slug":1762,"name":1762,"fn":1763,"description":1764,"org":1827,"tags":1828,"stars":21,"repoUrl":22,"updatedAt":1773},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1829,1830,1831,1832],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1771,"slug":1772,"type":16},{"slug":1775,"name":1775,"fn":1776,"description":1777,"org":1834,"tags":1835,"stars":21,"repoUrl":22,"updatedAt":1786},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1836,1837,1838,1839],{"name":9,"slug":8,"type":16},{"name":1721,"slug":1722,"type":16},{"name":1783,"slug":1784,"type":16},{"name":14,"slug":15,"type":16},{"slug":1841,"name":1841,"fn":1842,"description":1843,"org":1844,"tags":1845,"stars":21,"repoUrl":22,"updatedAt":1854},"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},[1846,1847,1848,1851],{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1849,"slug":1850,"type":16},"Plugin Development","plugin-development",{"name":1852,"slug":1853,"type":16},"Rust","rust","2026-04-06T18:01:27.176974",{"slug":1856,"name":1856,"fn":1857,"description":1858,"org":1859,"tags":1860,"stars":21,"repoUrl":22,"updatedAt":1870},"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},[1861,1862,1863,1864,1867],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"name":1865,"slug":1866,"type":16},"Node.js","nodejs",{"name":1868,"slug":1869,"type":16},"TypeScript","typescript","2026-04-06T18:01:13.653038",{"slug":4,"name":4,"fn":5,"description":6,"org":1872,"tags":1873,"stars":21,"repoUrl":22,"updatedAt":23},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1874,1875,1876],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":14,"slug":15,"type":16},{"slug":1878,"name":1878,"fn":1879,"description":1880,"org":1881,"tags":1882,"stars":21,"repoUrl":22,"updatedAt":1887},"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},[1883,1884,1885,1886],{"name":19,"slug":20,"type":16},{"name":9,"slug":8,"type":16},{"name":1721,"slug":1722,"type":16},{"name":14,"slug":15,"type":16},"2026-04-06T18:01:19.140592",{"slug":1889,"name":1889,"fn":1890,"description":1891,"org":1892,"tags":1893,"stars":21,"repoUrl":22,"updatedAt":1899},"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},[1894,1895,1898],{"name":9,"slug":8,"type":16},{"name":1896,"slug":1897,"type":16},"CLI","cli",{"name":14,"slug":15,"type":16},"2026-07-30T05:31:52.675547"]