agp-9-upgrade

Migrates Android projects to Android Gradle Plugin 9 with built-in Kotlin and new DSL.

1|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/citytexi/team-yg-pesonal-agent --skill agp-9-upgrade-citytexi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agp-9-upgrade
Source: https://github.com/citytexi/team-yg-pesonal-agent/tree/main/.claude/skills/agp-9-upgrade
Command: npx skills add https://github.com/citytexi/team-yg-pesonal-agent --skill agp-9-upgrade-citytexi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an Android project to Android Gradle Plugin (AGP) 9 involves many breaking changes, including the new AGP DSL, built-in Kotlin support, and kapt removal. This Skill guides the migration step by step so nothing is missed. ## Core Features & Use Cases - Guided AGP 9 Migration: Walks through dependency updates (KSP 2.3.6+, Hilt 2.59.2+), built-in Kotlin migration, and the new AGP DSL. - kapt to KSP Migration: Checks each kapt dependency for KSP compatibility and applies the legacy-kapt plugin where migration is not possible. - BuildConfig and Cleanup: Handles custom BuildConfig fields with the new API and removes obsolete gradle.properties flags. - Use Case: An Android developer needs to move a production app from AGP 8 to AGP 9. The Skill verifies the current AGP version, migrates the build scripts to the new DSL, converts kapt usages to KSP, and verifies the result with Gradle sync and a dry-run build. ## Quick Start Migrate this Android project to AGP 9 and verify the build still works.

Frequently Asked Questions about agp-9-upgrade

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

FAQPage Schema
How do I migrate an Android project to AGP 9?▼

First confirm the project is on the latest stable AGP 8 version, then update KSP to 2.3.6+ and Hilt to 2.59.2+, migrate to built-in Kotlin and the new AGP DSL, convert kapt to KSP, and clean up obsolete gradle.properties flags. Verify with Gradle sync and ./gradlew build --dry-run.

How to migrate kapt to KSP in Android Gradle builds?▼

Remove the org.jetbrains.kotlin.kapt plugin, then check each kapt dependency's jar for a KSP SymbolProcessorProvider service file to confirm compatibility. Migrate compatible processors to KSP and apply the com.android.legacy-kapt plugin for any that remain incompatible.

Does AGP 9 support Kotlin Multiplatform projects?▼

No, this migration path does not support Kotlin Multiplatform (KMP) projects. The skill explicitly excludes KMP projects, so KMP-based Android modules need a different upgrade approach.

Why does Paparazzi break with AGP 9?▼

Paparazzi 2.0.0-alpha04 and lower use internal Gradle classes that break with Gradle 9, which AGP 9 requires. The workaround is to disable HTML test reports in every module applying the app.cash.paparazzi plugin.

What gradle.properties flags should be removed after AGP 9 migration?▼

Remove android.builtInKotlin, android.newDsl, android.uniquePackageNames, and android.enableAppCompileTimeRClass from gradle.properties after the migration. These flags are obsolete once the new DSL and built-in Kotlin are in place.