agp-9-upgrade

Migrate Android projects to Android Gradle Plugin 9 with required configuration changes.

8|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drewid74/ai_skills --skill agp-9-upgrade-drewid74
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agp-9-upgrade
Source: https://github.com/drewid74/ai_skills/tree/main/android-agp-upgrade
Command: npx skills add https://github.com/drewid74/ai_skills --skill agp-9-upgrade-drewid74

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill guides you through upgrading an Android project from an older Android Gradle Plugin (AGP) version to AGP 9, covering required migrations and configuration changes while avoiding unsupported project types.

Core Features & Use Cases

  • AGP 9 upgrade checklist: Verifies the current AGP version, then applies the required dependency updates and migration steps to reach AGP 9.
  • Build system migrations: Covers migrating to built-in Kotlin, moving to the new AGP DSL, and updating kapt to KSP or legacy-kapt where needed.
  • Post-migration validation: Ensures Gradle sync and Gradle help/build dry-runs succeed, helping confirm the project is in a consistent state.

Use Case Example: You maintain an Android app that builds on AGP 8.x and want to upgrade to AGP 9 to stay current with tooling changes, while updating KSP/Hilt/kapt usage and cleaning up obsolete gradle.properties flags.

Quick Start

Use this skill to upgrade your project to Android Gradle Plugin 9 by following its steps and then verifying Gradle sync plus a build dry-run.

Frequently Asked Questions about agp-9-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade my Android project to AGP 9?

Upgrading to AGP 9 requires checking your current AGP version, applying dependency updates, migrating to built-in Kotlin, switching to the new AGP DSL, and updating gradle.properties. Validate the migration by running a Gradle sync and a build dry-run.

What changes are required for KSP and Hilt when migrating to AGP 9?

Migrating to AGP 9 enforces minimum KSP and Hilt version requirements. The process involves updating kapt to KSP or legacy-kapt where needed to ensure build compatibility after applying the configuration changes.

Can I use the AGP 9 migration process for a Kotlin Multiplatform project?

No, the AGP 9 migration process is designed for standard Android projects. It explicitly does not support Kotlin Multiplatform (KMP) projects and checks the starting AGP version to ensure compatibility before applying changes.

How do I migrate gradle.properties for AGP 9?

Migrating gradle.properties for AGP 9 involves cleaning up obsolete flags and applying required build configuration updates. This ensures your project maintains compatibility with the new AGP DSL and built-in Kotlin setup.

How do I validate my Android build after upgrading to AGP 9?

Post-migration validation involves running a Gradle sync and executing Gradle help or build dry-runs. These checks confirm the project is in a consistent state and successfully adopted the AGP 9 configuration changes.