graphql-schema · chriswiles — скилл для Claude Code: функции и установка
Скилл graphql-schema задаёт правила для GraphQL-запросов, мутаций и генерации типов. Пригодится в проектах с Apollo Client.
лицензия не указана ★ 6 091 обновлён 2026-01-06
npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a claude-codeЧто делает graphql-schema
Скилл предлагает хранить операции GraphQL в отдельных .gql-файлах, а не встраивать их в код. После изменений он направляет к генерации типов командами npm run gql:typegen или npm run sync-types, а в приложении предлагает использовать созданные хуки вместо ручных Apollo-хуков. Сгенерированные файлы менять не следует.
Для мутаций предусмотрены обработчики ошибок, сообщения об успехе и состоянии загрузки. Кнопка запуска должна блокироваться на время операции, чтобы избежать повторной отправки. В правилах также описаны фрагменты, политики кэша, пропуск запросов, опрос сервера и оптимистичные обновления.
Без запуска npm run gql:typegen после изменения .gql сгенерированные хуки не обновятся.
Какие задачи решает
- вынести GraphQL-операции в
.gql-файлы - сгенерировать типы и хуки из схемы
- добавить обработку ошибок в мутации
- показать загрузку и успех при отправке формы
- настроить кэш и оптимистичное обновление
Примеры запросов агенту
- Создай запрос GraphQL для списка товаров в отдельном
.gql-файле и подготовь сгенерированный хук. - Добавь мутацию создания записи с обработчиками ошибки, успеха и состояния загрузки.
- Проверь, какие команды запустить после изменения
.gql, и обнови типы.
Как установить graphql-schema
1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a claude-code2Вручную: положить файлы
~/.claude/skills/graphql-schema/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/graphql-schema/
1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a codex2Вручную: положить файлы
.agents/skills/graphql-schema/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a cursor2Вручную: положить файлы
.cursor/skills/graphql-schema/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ChrisWiles/claude-code-showcase .claude/skills/graphql-schema2Вручную: положить файлы
.github/skills/graphql-schema/SKILL.md1Через Skills CLI (Vercel)
npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a gemini-cli2Командой платформы
gemini skills install https://github.com/ChrisWiles/claude-code-showcase --path .claude/skills/graphql-schemaВручную: положить файлы
.devin/skills/graphql-schema/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о graphql-schema
Как установить graphql-schema в Claude Code?
Выполните npx skills add ChrisWiles/claude-code-showcase --skill graphql-schema -a claude-code, затем используйте файл скилла ~/.claude/skills/graphql-schema/SKILL.md.
Что делает graphql-schema?
Скилл задаёт рабочий порядок для GraphQL-запросов и мутаций: отдельные .gql-файлы, генерация типов и использование созданных хуков. Он также описывает обработку ошибок, состояния интерфейса и кэш.
Что нужно делать после изменения .gql-файла?
Запустить npm run gql:typegen, чтобы обновить типы и хуки. Для загрузки схемы перед генерацией предусмотрена команда npm run sync-types.
Похожие скиллы
Все скиллы по теме «Фронтенд и UI» →Сначала — graphql-schema от других авторов.