사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/xsavikx/okf-skills --skill okf-graphql시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
GraphQL OKF Connector
This skill provides a Go-based CLI tool to document a GraphQL schema (SDL) as an Open Knowledge Format (OKF) bundle: one concept per user-defined type and per root operation, with fields and operations linked to the types they reference. It needs only the SDL file — no live server.
When to Use
Use this skill when you need to:
- Catalog a GraphQL API from its SDL — types under
types/, queries under
queries/, mutations under mutations/ (subscriptions under subscriptions/).
- Turn the type graph into a connected, browsable view — field→type and
operation→type references edges render as typed edges in okf-viz.
- Round-trip enriched descriptions back to a
.okf-metadata.yamlsidecar.
Setup
go install github.com/xSAVIKx/okf-skills/skills/okf-graphql@latest
# …or: cd skills/okf-graphql && go build -o okf-graphql .How to Use
1. Produce an OKF bundle
./okf-graphql produce --schema <schema.graphql> --out <bundle-dir>--schema(required): path to the GraphQL SDL document.--out(required): output OKF bundle directory.
Each object/input/interface type becomes types/<Name>.md with a # Columns field table (Name | Type | Required); enums emit a # Values list; unions emit their members. Each root field becomes an operation concept with its arguments and return type. Fields/operations link to the types they reference under # Relationships. Re-running preserves enriched descriptions.
2. Ingest / sync descriptions
./okf-graphql ingest --schema <schema.graphql> --bundle <bundle-dir> [--sync]- Verifies each concept still exists in the schema (reports drift); the SDL is never
modified.
--sync: writes the bundle's descriptions to.okf-metadata.yamlnext to the SDL.
3. Inspect the schema (self-description)
./okf-graphql schemaPrints the machine-readable JSON description used by okf-mcp to expose the skill.
