Lang Graphql
Lint and codegen GraphQL schemas and operations.
Skill metadata
| Source | Bundled (installed by default) |
| Path | skills/software-development/lang-graphql |
| Version | 1.0.0 |
| Author | VibeOS |
| License | MIT |
| Platforms | linux, macos, windows |
Reference: full SKILL.md
The following is the complete skill definition that VibeOS loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
GraphQL Language Pack Skill
Drive GraphQL work with the project index and standard CLI recipes.
LSP hint: none (toolchain CLI) (editor-side when applicable). Zero new core tools.
What this language is (beginner)
Способ описать API одним графом типов: клиент просит ровно те поля, которые нужны. Часто вместо/рядом с REST.
Лучше всего для:
- единый API для web+mobile
- schema-first разработка
- Federation / Apollo / Yoga
- codegen клиентов
When to Use
Выбирай этот pack, если:
- есть schema.graphql / .graphqlrc
- нужен гибкий API для SPA/мобилки
- пользователь просит GraphQL
Manifests (автодетект репозитория): .graphqlrc, .graphqlrc.yml, .graphqlrc.yaml, .graphqlrc.json, schema.graphql, graphql.config.yml, graphql.config.js
Обычно рядом: TypeScript клиент; часто Postgres; codegen в CI.
См. также skill choose-language-pack и vibeos language recommend "…".
When NOT to use
- простой CRUD REST → TypeScript/Go/Python HTTP API
- только SQL без API-слоя → sql pack
- tRPC в одном TS-монорепо → TypeScript
Prerequisites
vibeos pack apply lang-graphql --apply
vibeos pack apply project-intelligence --apply
How to Run
vibeos project index build
npx graphql-schema-linter || true
npx graphql-codegen || true
Quick Reference
| Goal | Command |
|---|---|
| Apply pack | vibeos pack apply lang-graphql --apply |
| Doctor | vibeos language doctor graphql |
| Primary test | npx graphql-schema-linter |
| Choose guide | skill choose-language-pack |
| Recommend | vibeos language recommend "…" |
Procedure
- Для нового продукта сначала
choose-language-pack/vibeos language recommend. - Work from the project root that matches pack manifests.
- Prefer project-local toolchain and committed config (sqlfluff/buf/elm.json).
- Explain destructive DB or breaking contract changes; wait for explicit ask.
- Do not invent core tools; stay on
terminal+read_file+ index CLI.
Pitfalls
- Keep schema and resolvers in sync.
- Do not expose internal fields without auth checks.
Verification
vibeos language doctor graphql
vibeos project index status