메뉴
Master GraphQL core concepts - types, queries, mutations, and subscriptions
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/pluginagentmarketplace/custom-plugin-graphql --skill graphql-fundamentals명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
| name | graphql-fundamentals |
| description | Master GraphQL core concepts - types, queries, mutations, and subscriptions |
| sasmp_version | 1.3.0 |
| bonded_agent | 01-graphql-fundamentals |
| bond_type | PRIMARY_BOND |
| version | 2.0.0 |
| complexity | beginner |
| estimated_time | 2-4 hours |
| prerequisites | [] |
Master the building blocks of GraphQL APIs
This skill covers the essential GraphQL concepts every developer needs. From type definitions to query operations, you'll learn the foundation for building GraphQL APIs.
| Concept | Syntax | Example |
|---|---|---|
| Scalar | String, Int, Float, Boolean, ID | name: String! |
| Object | type Name { fields } | type User { id: ID! } |
| Input | input Name { fields } | input CreateUserInput { name: String! } |
| Enum | enum Name { VALUES } | enum Status { ACTIVE INACTIVE } |
| List | [Type] or [Type!]! | tags: [String!]! |
| Non-null | Type! | id: ID! |
# Scalar types (built-in)
type Example {
id: ID! # Unique identifier
name: String! # Text
age: Int # Integer (nullable)
score: Float! # Decimal
active: Boolean
DateTime
JSON
Upload
User
ID
String
Profile
Post
Profile
String
String
UserRole
ADMIN
EDITOR
VIEWER
CreateUserInput
String
String
UserRole VIEWER
Node
ID
User implements Node
ID
String
SearchResult User Post Comment
# Schema definition
type Query {
# Single item
user(id: ID!): User
# List with optional filter
users(filter: UserFilter, limit: Int = 10): [User!]!
# Search
search(query: String!): [SearchResult!]!
}
# Client query examples
query GetUser {
user(id: "123") {
id
name
email
}
}
query GetUsersWithFilter {
users(filter: { role: ADMIN }, limit: 5) {
id
name
}
}
# With variables
query GetUser($userId: ID!) {
user(id: $userId) {
id
name
}
}
# Variables: { "userId": "123" }
# With aliases
query GetTwoUsers {
admin: user(id: "1") { name }
editor: user(id: "2") { name }
}
# With fragments
fragment UserFields on User {
id
name
email
}
query GetUsers {
users {
...UserFields
}
}
# Schema definition
type Mutation {
createUser(input: CreateUserInput!): CreateUserPayload!
updateUser(id: ID!, input: UpdateUserInput!): User!
deleteUser(id: ID!): DeletePayload!
}
type CreateUserPayload {
user: User
errors: [Error!]!
}
# Client mutation
mutation CreateUser($input: CreateUserInput!) {
createUser(input: $input) {
user {
id
name
}
errors {
field
message
}
}
}
# Variables: { "input": { "email": "test@example.com", "name": "Test" } }
# Schema definition
type Subscription {
userCreated: User!
messageReceived(channelId: ID!): Message!
}
# Client subscription
subscription OnUserCreated {
userCreated {
id
name
createdAt
}
}
subscription OnMessage($channelId: ID!) {
messageReceived(channelId: $channelId) {
id
content
sender { name }
}
}
type Example {
# Required field - never null
id: ID!
# Optional field - can be null
nickname: String
# Required list, optional items
tags: [String]! # [], ["a", null, "b"]
# Required list, required items (most common)
categories: [Category!]! # [], [cat1, cat2]
# Optional list (avoid - ambiguous)
# items: [Item] # null vs [] unclear
}
input CreateUserInput {
email: String! # Required
name: String! # Required
age: Int # Optional
role: UserRole = VIEWER # Optional with default
}
| Error | Cause | Solution |
|---|---|---|
Cannot query field "x" | Field not in schema | Check spelling, verify schema |
Variable "$x" not defined | Missing variable declaration | Add to query signature |
Expected non-null, got null | Resolver returned null for ! field | Fix resolver or make nullable |
Unknown type "X" | Type not defined | Add type definition |
# Validate schema
npx graphql-inspector validate schema.graphql
# Introspect remote schema
npx graphql-inspector introspect http://localhost:4000/graphql
# Check for breaking changes
npx graphql-inspector diff old.graphql new.graphql
Skill("graphql-fundamentals")
graphql-schema-design - Advanced schema patternsgraphql-resolvers - Implementing resolversgraphql-codegen - TypeScript type generation01-graphql-fundamentals - For detailed guidanceSOC 직업 분류 기준
