kotlin-tooling-agp9-migration
Migrates Kotlin Multiplatform (KMP) projects to Android Gradle Plugin 9.0+. Handles 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.
94
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that hits all the marks. It provides specific concrete actions, includes a comprehensive set of natural trigger terms that developers would actually use, explicitly states both what the skill does and when to use it, and occupies a very distinct niche that minimizes conflict risk with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: plugin replacement (with exact plugin ID), module splitting, DSL migration, and new default project structure handling. Very detailed and actionable. | 3 / 3 |
Completeness | Clearly answers both 'what' (migrates KMP projects to AGP 9.0+, handles plugin replacement, module splitting, DSL migration) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios including upgrade, build failure, and keyword mentions). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'AGP 9.0', 'android multiplatform plugin', 'KMP migration', 'com.android.kotlin.multiplatform.library', 'upgrading AGP', 'KMP+AGP incompatibility', 'build fails'. These are exactly the terms a developer would use when encountering this issue. | 3 / 3 |
Distinctiveness Conflict Risk | Extremely narrow and well-defined niche: KMP + AGP 9.0 migration specifically. The combination of Kotlin Multiplatform, Android Gradle Plugin 9.0, and the specific plugin ID makes it virtually impossible to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality, comprehensive migration skill that handles a genuinely complex multi-path workflow with excellent actionability and progressive disclosure. The workflow is well-structured with clear classification, sequenced steps, and verification. The main area for improvement is token efficiency — some inline content (like the full Gradle Properties table and the extensive Built-in Kotlin Migration section) could potentially be moved to reference files to keep the main skill leaner.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long but most content earns its place given the complexity of AGP 9.0 migration. However, some sections include explanatory context that Claude could infer (e.g., 'Android Gradle Plugin 9.0 makes the Android application and library plugins incompatible with the Kotlin Multiplatform plugin in the same module'), and the Gradle Properties table could be offloaded to a reference file rather than inline. | 2 / 3 |
Actionability | The skill provides fully executable code snippets throughout — plugin declarations, DSL migration examples, gradle.properties changes, version catalog entries, and specific commands. Every migration path has concrete before/after code that is copy-paste ready with clear adaptation points. | 3 / 3 |
Workflow Clarity | The skill has an excellent multi-step workflow: Step 0 analyzes the project, classifies modules into migration paths, each path has numbered steps with clear sequencing, and there's an explicit verification section with a checklist. The 'determine scope → ask user → execute path → verify' flow includes validation checkpoints and error recovery guidance (Common Issues section). | 3 / 3 |
Progressive Disclosure | The skill masterfully uses progressive disclosure — the main file provides summaries and key code for each migration path while pointing to dedicated reference files (MIGRATION-LIBRARY.md, MIGRATION-APP-SPLIT.md, MIGRATION-FULL-RESTRUCTURE.md, DSL-REFERENCE.md, VERSION-MATRIX.md, PLUGIN-COMPATIBILITY.md, KNOWN-ISSUES.md, checklist.md). All references are one level deep and clearly signaled with descriptive labels. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- Kotlin/kotlin-agent-skills
- Commit
9e05c37
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.