vtex-io-graphql-api — скилл для Claude Code: настройка GraphQL
Помогает описать GraphQL-схему и подключить резолверы в приложении VTEX IO. Пригодится, когда нужно открыть данные через запросы или мутации.
npx skills add vtex/skills --skill vtex-io-graphql-api -a claude-codeЧто делает vtex-io-graphql-api
Скилл помогает работать со схемами в graphql/ и резолверами в node/resolvers/: описывать типы, настраивать @cacheControl и @auth, связывать поля схемы с резолверами в Service. Он также напоминает добавить сборщик graphql в manifest.json, иначе файлы схемы не будут обработаны.
Для публичных запросов скилл рекомендует задавать правила кэширования, а для мутаций и пользовательских данных — проверку авторизации. Имена резолверов должны совпадать с полями схемы; доступ к данным в них выполняется через ctx.clients. Несовпадение имён может привести к тому, что поле вернёт null без ошибки в логах.
Какие задачи решает
- описать типы и поля GraphQL-схемы
- подключить резолверы к полям схемы
- настроить кэширование публичных запросов
- добавить проверку авторизации для мутаций и личных данных
- найти причину, по которой GraphQL-схема не загружается
Примеры запросов агенту
- Проверь схему GraphQL в
graphql/и добавь подходящие директивы к полям. - Свяжи поля из
schema.graphqlс резолверами вServiceи проверь совпадение имён. - Проверь
manifest.json: добавь сборщикgraphql, если он нужен для этой схемы.
Как установить vtex-io-graphql-api
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-graphql-api -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-graphql-api/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-graphql-api/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-graphql-api -a codex2Вручную: положить файлы
.agents/skills/vtex-io-graphql-api/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-graphql-api -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-graphql-api/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-graphql-api2Вручную: положить файлы
.github/skills/vtex-io-graphql-api/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-graphql-api -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-graphql-apiВручную: положить файлы
.devin/skills/vtex-io-graphql-api/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-graphql-api -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-graphql-api
Как установить vtex-io-graphql-api в Claude Code?
Выполни npx skills add vtex/skills --skill vtex-io-graphql-api -a claude-code. Файл скилла находится по пути ~/.claude/skills/vtex-io-graphql-api/SKILL.md.
Что делает vtex-io-graphql-api?
Помогает создавать GraphQL-схемы и резолверы для приложений VTEX IO, включая настройку кэширования и авторизации.
Зачем добавлять сборщик graphql в manifest.json?
Он обрабатывает файлы схемы из graphql/ и регистрирует их в среде VTEX IO. Без него схема не загрузится.
