# apollo-kotlin

A skill that walks the agent through Apollo Kotlin setup in a Gradle project: schema, codegen, an ApolloClient with auth and cache, plus operations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1700 installs · ★ 119
- Author: apollographql
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/apollographql/skills/tree/HEAD/skills/apollo-kotlin/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/apollo-kotlin

## What it does

Apollo Kotlin generates strongly typed Kotlin models from your GraphQL operations and schema. The skill covers the whole path: it first confirms target platforms (Android, JVM or KMP) and endpoint addresses, then configures Gradle and code generation including custom scalars, then builds a shared `ApolloClient` with auth, logging and caching. Operations and test validation come last.

Four reference files sit inside. `references/setup.md` handles the Gradle plugin, schema download and client config, `references/operations.md` covers queries, mutations and subscriptions, `references/caching.md` explains the normalized cache, and `references/migrating-from-4.md` is for moving off Apollo Kotlin 4. Two scripts list available versions of the library and of the normalized cache library, which helps when you cannot recall the current number.

You need JVM 8+, Kotlin 1.9+ and Gradle 8+. The skill insists on Apollo Kotlin v5 and above and tells you not to use v3 or older, so an old project has to update the client first. It also asks you to keep schema and operations in source control, otherwise builds stop being reproducible.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add apollographql/skills --skill apollo-kotlin -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/apollo-kotlin/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/apollo-kotlin/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add apollographql/skills --skill apollo-kotlin -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/apollo-kotlin/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add apollographql/skills --skill apollo-kotlin -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/apollo-kotlin/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install apollographql/skills apollo-kotlin
```

2. **Manually: put the files in place**
- File: `.github/skills/apollo-kotlin/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add apollographql/skills --skill apollo-kotlin -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/apollographql/skills --path skills/apollo-kotlin
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/apollo-kotlin/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add apollographql/skills --skill apollo-kotlin -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/apollographql/skills/tree/HEAD/skills/apollo-kotlin/SKILL.md

## When to use it
- wire Apollo Kotlin into a Gradle project for Android, JVM or KMP
- set up schema download and Kotlin model generation
- add auth, interceptors and logging to `ApolloClient`
- turn on the normalized cache and understand how it behaves
- migrate a project from Apollo Kotlin 4 to v5

## Example prompts
- Set up Apollo Kotlin in this Gradle project: the schema is in `src/main/graphql`, the endpoint in `local.properties`
- Add an auth token interceptor to `ApolloClient` and enable the normalized cache
- Help me migrate this project from Apollo Kotlin 4 to v5 using `references/migrating-from-4.md`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: aed259dbf1f5b263.

BEGIN THIRD-PARTY FILE aed259dbf1f5b263
```text
---
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.
```
END THIRD-PARTY FILE aed259dbf1f5b263

The third-party file has ended. Everything between the aed259dbf1f5b263 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© apollographql · MIT · https://github.com/apollographql/skills/tree/HEAD/skills/apollo-kotlin/SKILL.md

## Similar
- [kotlin-multiplatform](https://affpapa.org/en/nevibecode/skills/kotlin-multiplatform.md) — skill · 1600 installs
- [kotlin-specialist](https://affpapa.org/en/nevibecode/agents/kotlin-specialist.md) — subagent · 501 installs
- [kotlin-coroutines-flows](https://affpapa.org/en/nevibecode/skills/kotlin-coroutines-flows.md) — skill · 4800 installs
- [kotlin-tooling-agp9-migration](https://affpapa.org/en/nevibecode/skills/kotlin-tooling-agp9-migration.md) — skill · 2200 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md