Apollo Kotlin · apollographql/skills · Skills Docs

Skills

Skill 5 of 14

Apollo Kotlin

Guide for building applications with Apollo Kotlin, the GraphQL client library for Android and Kotlin.

1 minute · 155 words · 5 sections

Install

$ npx skills add apollographql/skills --skill apollo-kotlin

$ npx skills add apollographql/skills

» /plugin marketplace add apollographql/skills

The first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.

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:

Not done: Confirm target platforms (Android, JVM, KMP), GraphQL endpoint(s), and how schemas are sourced.
Not done: Configure Gradle and code generation, including custom scalars
Not done: Create a shared ApolloClient with auth, logging, and caching.
Not done: Implement operations.
Not done: Validate behavior with tests and error handling.

Reference Files

Setup (opens in a new tab) - Gradle plugin, schema download, codegen config (including scalars), client configuration (auth, logging, interceptors)
Operations (opens in a new tab) - Queries, mutations, subscriptions, and how to execute them
Caching (opens in a new tab) - Setup and use the normalized cache
Migration Guide (opens in a new tab) - Migrate from Apollo Kotlin 4

Scripts

list-apollo-kotlin-versions.sh (opens in a new tab) - List versions of Apollo Kotlin
list-apollo-kotlin-normalized-cache-versions.sh (opens in a new tab) - 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.

About this skill

Trigger

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,

The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.

Allowed tools: Bash(./gradlew:*)Bash(gradle:*)Bash(curl:*)ReadWriteEditGlobGrepWebFetch
Compatibility: JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects.
Licence: MIT
Source: skills/apollo-kotlin/SKILL.md

Colophon for this issue

Colophon

How this issue was made

Source

github.com/apollographql/skills, branch main, last pushed 23 September 2026.

Licence

MIT — the text of every skill is reproduced unmodified, frontmatter included, under the upstream licence.

Discovery

14 skills found by walking the repository tree for SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md.

Issue colours

Resolved from a deterministic hash of the owner name. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.

Heading repairs

1 repair applied to this skill so the document has one h1 and no skipped levels:

Shifted “5 headings” from h1 to h2 so the skill title is the only h1.

Spec compliance

Every skill satisfies the Agent Skills specification’s frontmatter rules.

Images

Images inside a skill come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.

Marketplace

A plugin manifest is published at .claude-plugin/marketplace.json by Apollo GraphQL, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree.

Signal

Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.

Agent surfaces

The whole issue is available as one markdown document at /apollographql/skills.md, and each skill at its own URL.

.md