Agent skill

Apollo Kotlin

by apollographql in apollographql/skills

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

MITAuto-check passedBackend & APIs

Install Apollo Kotlin

skills CLI
$ npx skills add apollographql/skills --skill apollo-kotlin -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install apollographql/skills apollo-kotlin --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/apollographql/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/apollo-kotlin .claude/skills/apollo-kotlin && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apollo-kotlin
GitHub stars
117
Token cost
~547 tokens
SKILL.md length
162 words
Files
7 (incl. scripts, references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

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

  • Setting up Apollo Kotlin in a Gradle project for Android
  • SKILL.md covers Process, Reference Files, Scripts and Key Rules
  • Runs Shell scripts from its folder
  • Configuring schema download and codegen for GraphQL services

What it does

Apollo Kotlin is an agent skill from apollographql/skills. 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,

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/caching.md`, `references/migrating-from-4.md` and `references/operations.md`). Compatibility notes: JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects.

It sits in Backend & APIs, covering GraphQL and Android development. It works with Kotlin, GraphQL, Android and Gradle. The repository describes itself as: Apollo GraphQL Agent Skills. The licence is MIT.

When your agent uses it

  • Setting up Apollo Kotlin in a Gradle project for Android
  • Configuring schema download and codegen for GraphQL services
  • Configuring an ApolloClient with auth
  • Writing queries

Example prompts

  • “/apollo-kotlin”

Requirements

  • A Bash shell
  • Compatibility (from SKILL.md): JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects.
  • Pre-approved tools (allowed-tools): Bash(./gradlew:*), Bash(gradle:*), Bash(curl:*), Read, Write, Edit, Glob, Grep, WebFetch

What it can do on your machine

Read from SKILL.md and the folder at commit 5f02fcf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(./gradlew:*)
    • Bash(gradle:*)
    • Bash(curl:*)
    • Read
    • Write
    • Edit
    • Glob
    • Grep
    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects.

    From compatibility in the SKILL.md frontmatter.

Context cost

Apollo Kotlin loads about 547 tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 102 tokens; SKILL.md has 162 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
When it runs · the whole SKILL.md, loaded when a task matches
~547
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from apollographql/skills at commit 5f02fcf, republished under its MIT licence (© apollographql). 162 words, ~547 tokens.

Download SKILL.mdSave it as .claude/skills/apollo-kotlin/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
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,
allowed-tools
Bash(./gradlew:*), Bash(gradle:*), Bash(curl:*), Read, Write, Edit, Glob, Grep, WebFetch
compatibility
JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects.
license
MIT
metadata.author
apollographql
metadata.version
1.0.3

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 - Gradle plugin, schema download, codegen config (including scalars), client configuration (auth, logging, interceptors)
  • Operations - Queries, mutations, subscriptions, and how to execute them
  • Caching - Setup and use the normalized cache
  • Migration Guide - Migrate from Apollo Kotlin 4

Scripts

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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in skills/apollo-kotlin of apollographql/skills.

  • SKILL.md
  • references/caching.md
  • references/migrating-from-4.md
  • references/operations.md
  • references/setup.md
  • scripts/list-apollo-kotlin-normalized-cache-versions.sh
  • scripts/list-apollo-kotlin-versions.sh

Open the folder on GitHubat commit 5f02fcf

Compare with similar skills

Apollo Kotlin next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apollo Kotlin compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apollo Kotlin this skillapollographql/skills117—~547Automated safety check: PassMIT
Add Property Typeyontrack/yontrack102—~990Automated safety check: PassMIT
Monstermq Device Integratorvogler75/monster-mq143—~1.4kAutomated safety check: PassGPL-3.0
Inspect Network TrafficHedvigInsurance/android154—~756Automated safety check: PassAGPL-3.0
Retrofit Graphql Build DependenciesAniTrend/retrofit-graphql111—~463Automated safety check: PassApache-2.0
Android Developmentdpconde/claude-android-skill336—~1.7kAutomated safety check: PassMIT

Similar skills

  • Add Property Type

    yontrack/yontrack

    Add a complete Yontrack property type — Kotlin PropertyType class, GraphQL mutation provider, and all required frontend UI components (Icon, Display, Form, FormPrepare).

    102 GitHub stars~990 tokensUpdated today
    Backend & APIsAuto-check passed
  • Monstermq Device Integrator

    vogler75/monster-mq

    Guide for integrating new device types into the MonsterMQ broker.

    143 GitHub stars~1.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Inspect Network Traffic

    HedvigInsurance/android

    Read the HTTP and GraphQL calls a debug build of the Android app made, with request and response bodies, status codes, timings and errors, over adb.

    154 GitHub stars~756 tokensUpdated today
    MobileAuto-check passed
  • Retrofit Graphql Build Dependencies

    AniTrend/retrofit-graphql

    Understand and change retrofit-graphql build logic, module dependencies, version catalog entries, Dokka setup, and shared Gradle conventions.

    111 GitHub stars~463 tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Android Development

    dpconde/claude-android-skill

    Create production-quality Android applications following Google's official architecture guidance and NowInAndroid best practices.

    336 GitHub stars~1.7k tokensUpdated 10 mo ago
    MobileAuto-check passed
  • Claude Android Ninja

    Drjacky/claude-android-ninja

    Build and migrate Android apps with Kotlin, Jetpack Compose, MVVM, Hilt, Room 3 (KSP, SQLiteDriver, Flow/suspend DAOs), Navigation3, and multi-module Gradle.

    124 GitHub stars~5.2k tokensUpdated 10 days ago
    MobileAuto-check passed

More from apollographql/skills

All 12 skills in this repo
  • Graphos Factory

    apollographql/skills

    Build and iterate on an Apollo Connectors subgraph for a GraphOS supergraph from a REST API, with or without an OpenAPI or Swagger spec, in a dedicated git workspace that records what the API…

    117 GitHub stars~15k tokensUpdated 2 days ago
    Auto-check passed
  • Apollo Client

    apollographql/skills

    Guide for building React applications with Apollo Client 4.x.

    117 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed
  • Apollo Connectors

    apollographql/skills

    DEPRECATED: superseded by the graphos-factory skill (npx skills add apollographql/skills@graphos-factory), which builds and maintains a Connectors subgraph from a REST API with recorded decisions…

    117 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Apollo Federation

    apollographql/skills

    Guide for authoring Apollo Federation subgraph schemas. An agent skill from apollographql/skills.

    117 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Apollo iOS

    apollographql/skills

    Guide for building Apple-platform applications with Apollo iOS, the strongly-typed GraphQL client for Swift.

    117 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Apollo Router Plugin Creator

    apollographql/skills

    Guide for writing Apollo Router native Rust plugins. An agent skill from apollographql/skills.

    117 GitHub stars~4.1k tokensUpdated 2 days ago
    Auto-check passed

Questions about Apollo Kotlin

What does Apollo Kotlin do?

Guide for building applications with Apollo Kotlin, the GraphQL client library for Android and Kotlin. Apollo Kotlin is an agent skill from apollographql/skills. Guide for building applications with Apollo Kotlin, the GraphQL client library for Android and Kotlin.

When should I use Apollo Kotlin?

Apollo Kotlin fits situations like: setting up Apollo Kotlin in a Gradle project for Android; configuring schema download and codegen for GraphQL services; configuring an ApolloClient with auth; writing queries.

How do I install Apollo Kotlin in Claude Code?

Run `npx skills add apollographql/skills --skill apollo-kotlin -a claude-code`. Or copy the skill folder (skills/apollo-kotlin in apollographql/skills) into .claude/skills/apollo-kotlin in your project. Claude Code loads it when a task matches its description.

How do I install Apollo Kotlin in Codex?

Run `npx skills add apollographql/skills --skill apollo-kotlin -a codex`. Or copy the skill folder (skills/apollo-kotlin in apollographql/skills) into .agents/skills/apollo-kotlin in your project. Codex loads it when a task matches its description.

Can I use Apollo Kotlin in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add apollographql/skills --skill apollo-kotlin -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apollo-kotlin, .gemini/skills/apollo-kotlin, .github/skills/apollo-kotlin and .opencode/skills/apollo-kotlin in your project.

What does Apollo Kotlin need to run?

Going by SKILL.md and its folder, Apollo Kotlin needs a shell for the scripts in its folder. Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Bash(./gradlew:*), Bash(gradle:*), Bash(curl:*), Read, Write, Edit, Glob, Grep, WebFetch. Compatibility (from SKILL.md): JVM 8+, Kotlin 1.9+, Gradle 8+, Android/JVM/Kotlin Multiplatform projects..

Does Apollo Kotlin access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Apollo Kotlin safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Apollo Kotlin use?

Apollo Kotlin is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apollo Kotlin use?

About 547 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.4k tokens, read only when the agent opens those files.

What are the alternatives to Apollo Kotlin?

Skills that share tags, products or a category with Apollo Kotlin: Add Property Type (yontrack/yontrack, 102 stars), Monstermq Device Integrator (vogler75/monster-mq, 143 stars), Inspect Network Traffic (HedvigInsurance/android, 154 stars) and Retrofit Graphql Build Dependencies (AniTrend/retrofit-graphql, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apollo Kotlin?

apollographql (a GitHub organization) maintains it in apollographql/skills, which has 117 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

Source: apollographql/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.