← 스킬 목록으로 돌아가기

graphql-schema-validator

v1.0.0 approved Development 오늘 업데이트
USK v3 ✅ Verified ⚡ Auto-Convert
⬇ 다운로드
설치 가이드↓
🤖 에이전트용 설치 명령 (curl / MCP / Claude Desktop)
▸ curl 한 줄 다운로드
curl -L -o graphql-schema-validator.skill   "https://aiskillstore.io/v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=ClaudeCode"
▸ MCP 도구 호출 (Skill Store MCP 등록 시)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "d11ce271-cc4d-47e0-b782-91143655716c",
    "platform": "ClaudeCode"
  }
}
▸ Claude Desktop / Cursor MCP 설정 (1회)
{
  "mcpServers": {
    "skill-store": {
      "url": "https://aiskillstore.io/mcp/"
    }
  }
}
📖 에이전트용 전체 API 가이드: /llms.txt  ·  MCP server card

GraphQL SDL schema and query validation offline. GraphQL 스키마 검증, SDL 유효성 확인. Detects type conflicts, undefined fields, deprecated usage, and query depth violations.

# graphql # schema-validation # sdl # api-design # offline # type-system

기본 정보

소유자 👤 aiskillstore-team 카테고리 Development 등록일 2026-06-26 최종 업데이트 2026-06-26 최신 버전 1.0.0 패키지 날짜 2026-06-26 검증 상태 approved 다운로드 수 0회 체크섬 (SHA256) c3a893569e51c4e9bca07fdd3936e82b2af16c23459093070dfb3f6bef627032

⚡ AGENT INFO USK v3

Capabilities
graphql_schema_validation sdl_parsing query_depth_check type_system_validation offline_validation
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: main.py   runtime: python3   call_pattern: stdin_stdout
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=OpenClaw GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=ClaudeCode GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=Cursor GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=GeminiCLI GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=CodexCLI GET /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=CustomAgent

설치 방법

호환 플랫폼: any

1
openclaw_skill_manager.py로 스킬을 설치합니다.
python openclaw_skill_manager.py --install graphql-schema-validator
2
설치 확인
python openclaw_skill_manager.py --list-installed
3
특정 버전 설치 (선택)
python openclaw_skill_manager.py --install graphql-schema-validator --version 1.0.0
1
스킬 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/skills/d11ce271-cc4d-47e0-b782-91143655716c/download
2
Claude Code commands 디렉터리에 배치합니다.
unzip graphql-schema-validator.skill -d ~/.claude/commands/graphql-schema-validator/
3
Claude Code에서 슬래시 커맨드로 사용합니다.
/graphql-schema-validator
1
Agent Skills 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=ClaudeCodeAgentSkill
2
Claude Code skills 디렉터리에 압축을 해제합니다.
unzip graphql-schema-validator-agent-skill-*.skill -d ~/.claude/skills/graphql-schema-validator/
3
Claude Code를 재시작하면 세션 시작 시 자동으로 로드됩니다. 슬래시 커맨드 없이 자연어로 사용 가능합니다.
1
Cursor 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=Cursor
2
압축 해제 후 영구 위치에 저장합니다.
unzip graphql-schema-validator-cursor-*.skill -d ~/.cursor/skills/graphql-schema-validator/
3
.cursor/mcp.json에 MCP 서버 설정을 추가하고 Cursor를 재시작합니다.
cat ~/.cursor/skills/graphql-schema-validator/cursor_mcp_config.json
1
Gemini CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=GeminiCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip graphql-schema-validator-geminicli-*.skill -d ~/.gemini/skills/graphql-schema-validator/
3
~/.gemini/settings.json에 MCP 서버 설정을 추가하고 Gemini CLI를 재시작합니다.
cat ~/.gemini/skills/graphql-schema-validator/gemini_settings_snippet.json
1
Codex CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/download?platform=CodexCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip graphql-schema-validator-codexcli-*.skill -d ~/.codex/skills/graphql-schema-validator/
3
~/.codex/config.toml에 MCP 서버 설정을 추가하고 Codex CLI를 재시작합니다.
cat ~/.codex/skills/graphql-schema-validator/codex_config_snippet.toml
1
REST API로 스킬 패키지를 다운로드합니다.
GET https://aiskillstore.io/v1/skills/d11ce271-cc4d-47e0-b782-91143655716c/download
2
에이전트 플랫폼의 skills 디렉터리에 배치합니다.
cp graphql-schema-validator.skill ./skills/
3
설치 가이드 API로 플랫폼별 상세 정보를 조회합니다.
GET https://aiskillstore.io/v1/skills/d11ce271-cc4d-47e0-b782-91143655716c/install-guide?platform=CustomAgent

보안 검증 보고서

검증 결과 APPROVED

검사 결과: ["메타데이터 경고: 권장 필드 없음: 'requirements' (SKILL.md v2 권장)"]

✅ 보안 위험 항목이 발견되지 않았습니다.

AI 검수 단계

검수 주체 gemini 위험도 🟢 낮음 검수 요약 GraphQL SDL 및 쿼리 유효성 검사를 오프라인으로 수행하는 안전한 스킬입니다.
판단 근거

제공된 스킬 메타데이터, 코드 파일, 정적 분석 결과를 종합적으로 검토한 결과, 다음과 같은 판단을 내렸습니다. 1. **선언된 permissions과 실제 코드 일치 여부:** * 메타데이터에서 `network: false`, `filesystem: false`, `subprocess: false`, `env_vars: []`로 선언되어 있습니다. * `main.py` 및 `lib/validator.py` 코드에서 `requests`, `urllib`, `socket` 등 네트워크 통신을 시도하는 모듈이나 함수 호출이 발견되지 않았습니다. * `open()`, `shutil`, `os.remove` 등 파일 시스템에 접근하거나 변경하는 작업이 발견되지 않았습니다. `sys.path.insert` 및 `os.path.dirname`은 스킬 자체의 모듈 로딩을 위한 표준적인 사용으로, 파일 시스템 접근 권한 위반으로 볼 수 없습니다. * `subprocess` 모듈이나 `os.system`과 같은 외부 프로세스 실행 코드가 발견되지 않았습니다. * `os.getenv` 또는 `os.environ`과 같은 환경 변수 접근 코드도 발견되지 않았습니다. * 선언된 권한과 실제 코드의 동작이 완벽하게 일치합니다. 2. **악의적 목적의 코드 여부:** * 코드의 전체적인 로직은 GraphQL SDL 및 쿼리 파싱, 유효성 검사, 깊이 분석 등 스킬의 설명과 일치하는 기능에 집중되어 있습니다. * 데이터 탈취, 시스템 파괴, 난독화 등의 악의적인 목적을 가진 코드는 발견되지 않았습니다. 정적 분석 결과에서도 'red_flags_found' 및 'obfuscation_warnings'가 비어 있습니다. 3. **선언되지 않은 외부 통신 여부:** * `permissions.network: false`로 명시되어 있으며, 코드 분석 결과 어떠한 형태의 외부 통신도 시도하지 않습니다. 핵심 로직에 사용된 `graphql-core` 라이브러리 또한 오프라인 검증을 위해 설계되었습니다. 4. **사용자 데이터 무단 수집/전송 여부:** * 스킬은 `stdin`을 통해 입력을 받고 `stdout`으로 결과를 출력하는 `stdin_stdout` 패턴을 따릅니다. 입력된 GraphQL 스키마 및 쿼리 데이터는 검증 목적으로만 사용되며, 외부로 전송되거나 무단으로 저장되는 어떠한 메커니즘도 코드에서 발견되지 않았습니다. 5. **코드 품질 및 목적 일치 여부:** * 코드는 명확하고 가독성이 높으며, 스킬의 목적(GraphQL 스키마 및 쿼리 유효성 검사)에 충실하게 작성되었습니다. * 적절한 예외 처리와 입력 유효성 검사가 구현되어 있어 안정적으로 동작할 것으로 예상됩니다. 결론적으로, 이 스킬은 선언된 보안 정책을 준수하며, 악의적인 동작이나 의도치 않은 부작용 없이 안전하게 작동할 것으로 판단됩니다.

버전 히스토리

버전 USK v3 검증 상태 패키지 날짜 다운로드 변경사항
v1.0.0 approved 2026-06-26 ⬇ 0 1.0.0: Initial release. validate_schema/validate_query/analyze_schema/check_deprecated operations. Offline SDL validation via graphql-core v3. Query depth check. Structured error types.

사용 예시 (Examples) 6 개

이 스킬의 대표적인 입출력 예시입니다. 에이전트는 이 예시를 보고 스킬 호출 방법과 결과 형태를 이해할 수 있습니다.

Validate valid SDL schema
# valid# schema# user-type

Parse and validate a GraphQL SDL with Query type and custom types — returns valid=true and schema summary

📥 입력
{
  "operation": "validate_schema",
  "schema_sdl": "type Query {\n  user(id: ID!): User\n  users: [User!]!\n}\n\ntype User {\n  id: ID!\n  name: String!\n  email: String\n}"
}
📤 출력
{
  "errors": [],
  "operation": "validate_schema",
  "schema_summary": {
    "has_deprecated": false,
    "mutation_fields": [],
    "query_fields": [
      "user",
      "users"
    ],
    "subscription_fields": [],
    "type_count": 2
  },
  "valid": true,
  "warnings": []
}
Detect schema type error — missing interface implementation
# error# interface# missing-field

An SDL where a type declares it implements an interface but is missing required fields — returns type errors

📥 입력
{
  "operation": "validate_schema",
  "schema_sdl": "interface Node {\n  id: ID!\n}\n\ntype Product implements Node {\n  name: String!\n}\n\ntype Query {\n  product: Product\n}"
}
📤 출력
{
  "errors": [
    {
      "locations": [],
      "message": "Interface field \u0027Node.id\u0027 expected but \u0027Product\u0027 does not provide it.",
      "type": "TYPE_ERROR"
    }
  ],
  "operation": "validate_schema",
  "valid": false,
  "warnings": []
}
Validate query against schema
# query# unknown-field# error

Check that a query references only existing fields in the schema — returns query errors for unknown fields

📥 입력
{
  "operation": "validate_query",
  "query": "query GetUser {\n  user(id: \"1\") {\n    id\n    name\n    nonExistentField\n  }\n}",
  "schema_sdl": "type Query {\n  user(id: ID!): User\n}\n\ntype User {\n  id: ID!\n  name: String!\n}"
}
📤 출력
{
  "depth_check": {
    "actual_depth": 2,
    "depth_ok": true,
    "max_depth_allowed": 10
  },
  "errors": [
    {
      "locations": [
        {
          "column": 5,
          "line": 4
        }
      ],
      "message": "Cannot query field \u0027nonExistentField\u0027 on type \u0027User\u0027.",
      "type": "QUERY_ERROR"
    }
  ],
  "operation": "validate_query",
  "valid": false,
  "warnings": []
}
Schema analysis — type counts and fields
# analyze# summary# mutation

Analyze a schema to get type counts, query/mutation field names without full validation

📥 입력
{
  "operation": "analyze_schema",
  "schema_sdl": "type Query {\n  products: [Product!]!\n  product(id: ID!): Product\n}\n\ntype Mutation {\n  createProduct(name: String!): Product\n}\n\ntype Product {\n  id: ID!\n  name: String!\n  price: Float!\n}"
}
📤 출력
{
  "errors": [],
  "operation": "analyze_schema",
  "schema_summary": {
    "has_deprecated": false,
    "mutation_fields": [
      "createProduct"
    ],
    "query_fields": [
      "products",
      "product"
    ],
    "subscription_fields": [],
    "type_count": 3
  },
  "valid": true,
  "warnings": []
}
Detect deprecated field usage in query
# deprecated# warning# query

Find query operations that use fields marked as deprecated in the schema

📥 입력
{
  "operation": "check_deprecated",
  "query": "query GetUser {\n  user {\n    id\n    legacyId\n  }\n}",
  "schema_sdl": "type Query {\n  user: User\n}\n\ntype User {\n  id: ID!\n  name: String!\n  legacyId: String @deprecated(reason: \"Use id instead\")\n}"
}
📤 출력
{
  "errors": [],
  "operation": "check_deprecated",
  "valid": true,
  "warnings": [
    "Field \u0027User.legacyId\u0027 is deprecated: Use id instead"
  ]
}
Query depth violation
# depth# security# limit

A deeply nested query that exceeds max_depth=2 returns a depth error

📥 입력
{
  "max_depth": 2,
  "operation": "validate_query",
  "query": "query Deep {\n  post {\n    author {\n      posts {\n        author {\n          name\n        }\n      }\n    }\n  }\n}",
  "schema_sdl": "type Query {\n  post: Post\n}\n\ntype Post {\n  title: String\n  author: Author\n}\n\ntype Author {\n  name: String\n  posts: [Post]\n}"
}
📤 출력
{
  "depth_check": {
    "actual_depth": 4,
    "depth_ok": false,
    "max_depth_allowed": 2
  },
  "errors": [
    {
      "locations": [],
      "message": "Query depth 4 exceeds maximum allowed depth of 2.",
      "type": "DEPTH_ERROR"
    }
  ],
  "operation": "validate_query",
  "valid": false,
  "warnings": []
}

모든 예시는 에이전트 API로도 조회 가능: /v1/agent/skills/d11ce271-cc4d-47e0-b782-91143655716c/schema

리뷰 & 평점

아직 리뷰가 없습니다. 첫 번째 리뷰를 남겨보세요!

✍️ 리뷰 작성