Skip to content
Get packs

AGP 9 Upgrade Assistant

Guides an AI agent through migrating an Android project to Android Gradle Plugin 9

Source Download skill
Repository
android/skills
Stars
10,278
Licence
Apache-2.0
Files
7 files

What it does

Android Gradle Plugin (AGP) is the build tool that compiles Android apps. When this skill is installed, the agent follows a step-by-step playbook for upgrading an Android project to AGP 9, a major release with many breaking changes. It checks the current AGP version, updates related tools such as KSP and Hilt, moves code to built-in Kotlin and the new build DSL, replaces kapt, updates BuildConfig and gradle.properties settings, and then runs verification commands.

Great for

  • Android developers who need to move an existing app project to AGP 9
  • Teams preparing a build upgrade who want a checklist of breaking changes and fixes
  • Developers who already use an AI agent in their Android project and want guided migration steps

Skip it if

  • Kotlin Multiplatform (KMP) projects, which the skill explicitly says it must not be used for because they are unsupported
  • Projects still on an older AGP that have not first been upgraded with Android Studio's Upgrade Assistant, since the skill asks the agent to stop and check first
  • Non-Android projects, where the instructions about AGP and Android DSL changes do not apply

Try asking

  • “Upgrade my Android project to AGP 9 and walk me through the breaking changes”
  • “Check whether my build uses KSP or kapt and migrate it for AGP 9”
  • “Migrate my Gradle files to the new AGP DSL and built-in Kotlin”
  • “Verify my AGP 9 migration by running the Gradle help and dry-run checks”
Step-by-step guide: how to use AGP 9 Upgrade AssistantInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 7 original files, the Apache-2.0 licence and an attribution note.

    agp-9-upgrade.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip agp-9-upgrade.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip agp-9-upgrade.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run the AGP Upgrade Assistant in Android Studio to reach the latest AGP 8 release before asking the agent to move to AGP 9
  • Commit or back up your project first, since the skill edits many Gradle files and deletes temporary files
  • Check the verification steps (IDE sync, ./gradlew help, build --dry-run) yourself after the agent finishes

What's inside

  • references/android/build/migrate-to-built-in-kotlin.md
  • references/android/build/releases/agp-9-0-0-release-notes.md
  • references/buildconfig.md
  • references/ksp-kapt.md
  • references/paparazzi-gradle-9.md
  • references/recipes.md
  • SKILL.md

Redistributed unmodified from android/skills under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.