skills.rest
Kotlin
KotlinOFFICIAL
Explore all skills by this author →
Website𝕏@kotlinGitHub

kotlin-tooling-agp9-migration

Migrate Kotlin Multiplatform projects to AGP 9.0 with module classification and step-by-step guidance.

992|38|Updated Mar 13, 2026
Search Tags:#migration#kotlin#gradle#kmp#agp9
One-click install
npx skills add https://github.com/Kotlin/kotlin-agent-skills --skill kotlin-tooling-agp9-migration-kotlin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kotlin-tooling-agp9-migration
Source: https://github.com/Kotlin/kotlin-agent-skills/tree/main/skills/kotlin-tooling-agp9-migration
Command: npx skills add https://github.com/Kotlin/kotlin-agent-skills --skill kotlin-tooling-agp9-migration-kotlin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates Kotlin Multiplatform (KMP) projects to Android Gradle Plugin 9.0+, handling plugin replacement (com.android.kotlin.multiplatform.library), module splitting, DSL migration, and the new default project structure. Use when upgrading AGP, when build fails due to KMP+AGP incompatibility, or when the user mentions AGP 9.0, android multiplatform plugin, KMP migration, or com.android.kotlin.multiplatform.library.

Core Features & Use Cases

  • Analyze project setup to identify modules and plugins, read build files, and detect AGP KMP conflicts.
  • Classify modules into migration paths (Path A, Path B, Path C) and propose the required restructuring (library, app split, or full restructure).
  • Provide step-by-step guidance, including how to move code, update settings, and adapt dependencies and DSL for AGP 9.0 compatibility.

Quick Start

Provide the Gradle project layout and AGP/KMP versions to begin the guided migration.

Frequently Asked Questions about kotlin-tooling-agp9-migration

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

FAQPage Schema
How do I migrate a Kotlin Multiplatform project to AGP 9.0?▼

Migrate KMP projects to AGP 9.0 by analyzing the project setup, classifying modules into Path A, B, or C, and applying step-by-step guidance for plugin replacement, module splitting, and DSL updates.

Why does my Kotlin Multiplatform build fail after upgrading the Android Gradle Plugin?▼

KMP builds fail after upgrading AGP due to KMP and AGP incompatibilities. Analyzing the project detects these conflicts and classifies modules to guide required restructuring for version 9.0 compatibility.

What is the com.android.kotlin.multiplatform.library plugin used for?▼

The com.android.kotlin.multiplatform.library plugin replaces existing KMP plugins during AGP 9.0 migration. It is applied when updating build files and adapting dependencies for the new default project structure.

How do I split an Android app module during a KMP migration?▼

Split an Android app module during KMP migration by classifying it into the correct migration path. The process proposes required restructuring, including how to move code, update settings, and adapt the DSL.

Do I need to restructure all my modules when upgrading to Android Gradle Plugin 9.0?▼

Restructuring all modules is not always required. Modules are classified into Path A, B, or C to determine the exact restructuring needed, which may range from library updates to a full app split.

Related Skills

Explore More Software Engineering Skills→
new-silvermoonnew-silvermoon
915

android-gradle-logic

Centralize Android Gradle build logic with Kotlin DSL convention plugins.

Community
Advanced
klxiaoniuklxiaoniu
174

kotlin-tooling-agp9-migration

Migrate Kotlin Multiplatform projects to Android Gradle Plugin 9.0+.

Community
Advanced
shaharKeisarAppsshaharKeisarApps

gradle-expert

Configure Gradle Kotlin DSL for Kotlin Multiplatform projects with version catalogs.

Community
Advanced
cedric-champeixcedric-champeix
1

kotlin-build-kmp-gradle-governance

Review and design Gradle build structure for Kotlin Multiplatform projects.

Community
Advanced