apollo-kotlin — скилл для Claude Code: GraphQL-клиент в Kotlin
Скилл ведёт агента по настройке Apollo Kotlin в Gradle-проекте: схема, кодогенерация, ApolloClient с авторизацией и кэшем, запросы и подписки.
npx skills add apollographql/skills --skill apollo-kotlin -a claude-codeЧто делает apollo-kotlin
Apollo Kotlin генерирует типизированные Kotlin-модели из ваших GraphQL-операций и схемы. Скилл проводит через весь путь: сначала уточняет целевые платформы (Android, JVM или KMP) и адреса эндпоинтов, потом настраивает Gradle и кодогенерацию вместе с кастомными скалярами, затем собирает общий ApolloClient с авторизацией, логированием и кэшем. Дальше — операции и проверка поведения тестами.
Внутри четыре справочных файла: references/setup.md про плагин Gradle, скачивание схемы и конфигурацию клиента, references/operations.md про запросы, мутации и подписки, references/caching.md про нормализованный кэш и references/migrating-from-4.md для перехода с Apollo Kotlin 4. Ещё два скрипта перечисляют доступные версии библиотеки и нормализованного кэша — удобно, когда не помнишь актуальный номер.
Нужны JVM 8+, Kotlin 1.9+ и Gradle 8+. Скилл настаивает на Apollo Kotlin v5 и выше: v3 и старше использовать не советует, так что на старом проекте сначала придётся обновить клиент. Схему и операции он просит держать в системе контроля версий, иначе сборки перестанут воспроизводиться.
Какие задачи решает
- подключить Apollo Kotlin к Gradle-проекту на Android, JVM или KMP
- настроить скачивание схемы и генерацию Kotlin-моделей
- добавить авторизацию, интерцепторы и логирование в
ApolloClient - включить нормализованный кэш и разобраться с его поведением
- перейти с Apollo Kotlin 4 на пятую версию
Примеры запросов агенту
- Настрой Apollo Kotlin в этом Gradle-проекте: схема лежит в
src/main/graphql, эндпоинт вlocal.properties - Добавь в
ApolloClientинтерцептор для токена авторизации и включи нормализованный кэш - Помоги мигрировать проект с Apollo Kotlin 4 на v5 по файлу
references/migrating-from-4.md
Как установить apollo-kotlin
1Через Skills CLI (Vercel)
npx skills add apollographql/skills --skill apollo-kotlin -a claude-code2Вручную: положить файлы
~/.claude/skills/apollo-kotlin/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/apollo-kotlin/
1Через Skills CLI (Vercel)
npx skills add apollographql/skills --skill apollo-kotlin -a codex2Вручную: положить файлы
.agents/skills/apollo-kotlin/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add apollographql/skills --skill apollo-kotlin -a cursor2Вручную: положить файлы
.cursor/skills/apollo-kotlin/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install apollographql/skills apollo-kotlin2Вручную: положить файлы
.github/skills/apollo-kotlin/SKILL.md1Через Skills CLI (Vercel)
npx skills add apollographql/skills --skill apollo-kotlin -a gemini-cli2Командой платформы
gemini skills install https://github.com/apollographql/skills --path skills/apollo-kotlinВручную: положить файлы
.devin/skills/apollo-kotlin/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add apollographql/skills --skill apollo-kotlin -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о apollo-kotlin
Как установить apollo-kotlin в Claude?
Выполните npx skills add apollographql/skills --skill apollo-kotlin -a claude-code. Скилл появится в ~/.claude/skills/apollo-kotlin/SKILL.md.
Что делает скилл apollo-kotlin?
Проводит агента по настройке Apollo Kotlin: Gradle и кодогенерация, конфигурация ApolloClient, операции, кэш и миграция с четвёртой версии.
Какие версии Apollo Kotlin поддерживаются?
Скилл советует v5 и выше, v3 и старше использовать не стоит. Скрипт list-apollo-kotlin-versions.sh покажет доступные версии библиотеки.
Исходный текст
SKILL.md · MIT
--- name: apollo-kotlin description: > Guide for building applications with Apollo Kotlin, the GraphQL client library for Android and Kotlin. Use this skill when: (1) setting up Apollo Kotlin in a Gradle project for Android, Kotlin/JVM, or KMP, (2) configuring schema download and codegen for GraphQL services, (3) configuring an `ApolloClient` with auth, interceptors, and caching, (4) writing queries, mutations, or subscriptions, license: MIT compatibility: JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects. metadata: author: apollographql version: "1.0.3" allowed-tools: Bash(./gradlew:*) Bash(gradle:*) Bash(curl:*) Read Write Edit Glob Grep WebFetch --- # Apollo Kotlin Guide Apollo Kotlin is a strongly typed GraphQL client that generates Kotlin models from your GraphQL operations and schema, that can be used in Android, JVM, and Kotlin Multiplatform projects. ## Process Follow this process when adding or working with Apollo Kotlin: - [ ] Confirm target platforms (Android, JVM, KMP), GraphQL endpoint(s), and how schemas are sourced. - [ ] Configure Gradle and code generation, including custom scalars - [ ] Create a shared `ApolloClient` with auth, logging, and caching. - [ ] Implement operations. - [ ] Validate behavior with tests and error handling. ## Reference Files - [Setup](references/setup.md) - Gradle plugin, schema download, codegen config (including scalars), client configuration (auth, logging, interceptors) - [Operations](references/operations.md) - Queries, mutations, subscriptions, and how to execute them - [Caching](references/caching.md) - Setup and use the normalized cache - [Migration Guide](references/migrating-from-4.md) - Migrate from Apollo Kotlin 4 ## Scripts - [list-apollo-kotlin-versions.sh](scripts/list-apollo-kotlin-versions.sh) - List versions of Apollo Kotlin - [list-apollo-kotlin-normalized-cache-versions.sh](scripts/list-apollo-kotlin-normalized-cache-versions.sh) - List versions of the Apollo Kotlin Normalized Cache library ## Key Rules - Prefer Apollo Kotlin v5+. Do not use v3 or older versions. - Keep schema and operations in source control to make builds reproducible.
© apollographql · MIT · apollographql/skills
