{
    "format": "skillpro/v1",
    "skill_id": "apollographql-skills-skills-graphql-operations-skill-md",
    "name": "graphql-operations",
    "version": "1.0.0",
    "description": "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.",
    "category": [
        "内容创作"
    ],
    "trigger_words": [],
    "tags": [
        "data",
        "writing"
    ],
    "source": "DeepseekModel",
    "source_url": "https://deepseekmodel.com/skill?id=apollographql-skills-skills-graphql-operations-skill-md",
    "exported_at": "2026-09-16T20:42:31+08:00",
    "system_prompt": "name graphql-operations description 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. license MIT compatibility Any GraphQL client (Apollo Client, urql, Relay, etc.) metadata {\"author\":\"apollographql\",\"version\":\"1.0.0\"} allowed-tools Bash(npm:*) Bash(npx:*) Read Write Edit Glob Grep GraphQL Operations Guide 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. Operation Basics Query Structure query GetUser ( $id : ID ! ) { user ( id : $id ) { id name email } } Mutation Structure mutation CreatePost ( $input : CreatePostInput ! ) { createPost ( input : $input ) { id title createdAt } } Subscription Structure subscription OnMessageReceived ( $channelId : ID ! ) { messageReceived ( channelId : $channelId ) { id content sender { id name } } } Quick Reference Operation Naming Pattern Example Query GetUser , ListPosts , SearchProducts Mutation CreateUser , UpdatePost , DeleteComment Subscription OnMessageReceived , OnUserStatusChanged Variable Syntax # Required variable query GetUser ( $id : ID ! ) { ... } # Optional variable with default query ListPosts ( $first : Int = 20 ) { ... } # Multiple variables query SearchPosts ( $query : String ! , $status : PostStatus, $first : Int = 10 ) { ... } Fragment Syntax # Define fragment fragment UserBasicInfo on User { id name avatarUrl } # Use fragment query GetUser ( $id : ID ! ) { user ( id : $id ) { ... UserBasicInfo email } } Directives query GetUser ( $id : ID ! , $includeEmail : Boolean ! ) { user ( id : $id ) { id name email @include ( if : $includeEmail ) } } query GetPosts ( $skipDrafts : Boolean ! ) { posts { id title draft @skip ( if : $skipDrafts ) } } Key Principles 1. Request Only What You Need # Good: Specific fields query GetUserName ( $id : ID ! ) { user ( id : $id ) { id name } } # Avoid: Over-fetching query GetUser ( $id : ID ! ) { user ( id : $id ) { id name email bio posts { id title content comments { id } } followers { id name } # ... many unused fields } } 2. Name All Operations # Good: Named operation query GetUserPosts ( $userId : ID ! ) { user ( id : $userId ) { posts { id title } } } # Avoid: Anonymous operation query { user ( id : \"123\" ) { posts { id title } } } 3. Use Variables, Not Inline Values # Good: Variables query GetUser ( $id : ID ! ) { user ( id : $id ) { id name } } # Avoid: Hardcoded values query { user ( id : \"123\" ) { id name } } 4. Colocate Fragments with Components // UserAvatar.tsx export const USER_AVATAR_FRAGMENT = gql` fragment UserAvatar on User { id name avatarUrl } ` ; function UserAvatar ( { user } ) { return < img src = {user.avatarUrl} alt = {user.name} /> ; } Reference Files Detailed documentation for specific topics: Queries - Query patterns and optimization Mutations - Mutation patterns and error handling Fragments - Fragment organization and reuse Variables - Variable usage and types Tooling - Code generation and linting Ground Rules ALWAYS name your operations (no anonymous queries/mutations) ALWAYS use variables for dynamic values ALWAYS request only the fields you need ALWAYS include id field for cacheable types NEVER hardcode values in operations NEVER duplicate field selections across files PREFER fragments for reusable field selections PREFER colocating fragments with components USE descriptive operation names that reflect purpose USE @include / @skip for conditional fields",
    "model_config": {
        "provider": "deepseek",
        "model": "deepseek-chat",
        "temperature": 0.7,
        "max_tokens": 4096,
        "top_p": 0.9
    },
    "examples": [
        {
            "input": "请用graphql-operations帮我处理问题",
            "output": "好的，我是graphql-operations。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. 我会根据你的需求提供专业帮助。"
        },
        {
            "input": "介绍一下你的能力",
            "output": "我是graphql-operations，专注于内容创作领域。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."
        }
    ],
    "install_guide": {
        "coze": "在 Coze 平台创建 Bot -> 技能配置 -> 导入此 .skill 文件",
        "dify": "在 Dify 平台创建应用 -> 添加知识库 -> 导入此 .skill 配置",
        "claude": "将 system_prompt 字段内容复制到 Claude 自定义指令中",
        "custom": "将此 .skill 文件加载到你的 AI Agent 框架中，解析 system_prompt 和 model_config 即可使用"
    },
    "scripts": {
        "python": "# graphql-operations - Python extension\n# Add custom Python logic here\ndef process(input_data):\n    return input_data\n",
        "javascript": "// graphql-operations - JavaScript extension\n// Add custom JS logic here\nfunction process(inputData) {\n    return inputData;\n}\n"
    },
    "tools": {
        "mcp_servers": [],
        "api_endpoints": []
    },
    "dependencies": {
        "python": [],
        "node": []
    },
    "hooks": {
        "on_load": "echo \"Skill loaded: graphql-operations\"",
        "on_call": "",
        "on_error": "echo \"Skill error: please check logs\""
    }
}