gradle-kotlin-dsl-doctor

Diagnose failing Kotlin DSL Gradle builds and generate minimal compatible patches.

14|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/Kotlin/kotlin-backend-agent-skills --skill gradle-kotlin-dsl-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gradle-kotlin-dsl-doctor
Source: https://github.com/Kotlin/kotlin-backend-agent-skills/tree/main/.agents/skills/gradle-kotlin-dsl-doctor
Command: npx skills add https://github.com/Kotlin/kotlin-backend-agent-skills --skill gradle-kotlin-dsl-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Gradle Kotlin DSL Doctor helps teams diagnose failing Kotlin DSL Gradle builds and apply minimal, compatible fixes to restore build stability.

Core Features & Use Cases

  • Minimal, safe patches: patch Gradle Kotlin DSL scripts with small, reversible changes that preserve behavior.
  • Diagnostics-driven workflow: prioritize failures from Kotlin DSL syntax, type-safe accessors, plugin resolution, and BOM drift.
  • Use Case: when build.gradle.kts or settings.gradle.kts fails due to incompatible plugins or misaligned toolchains, use this to stabilize the build with incremental changes.

Quick Start

Provide the failing Kotlin Gradle project (build.gradle.kts/settings.gradle.kts) to the Doctor and let it generate a minimal, safe patch.

Frequently Asked Questions about gradle-kotlin-dsl-doctor

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

FAQPage Schema
How do I fix failing Kotlin DSL Gradle builds caused by incompatible plugins?

To fix failing Kotlin DSL Gradle builds, diagnose plugin resolution and toolchain misalignments to apply minimal, reversible patches. This stabilizes build.gradle.kts and settings.gradle.kts by prioritizing failures from incompatible plugins and BOM drift.

Why does my Gradle Kotlin DSL build break after updating dependencies?

Your Gradle Kotlin DSL build breaks after dependency updates due to BOM drift or dependency misconfigurations. Diagnosing these specific failures allows you to generate incremental, compatible patches that safely restore the build without altering behavior.

How do I patch settings.gradle.kts type-safe accessors safely?

To patch settings.gradle.kts type-safe accessors safely, apply minimal changes that preserve behavior. A diagnostics-driven workflow prioritizes failures from Kotlin DSL syntax and type-safe accessors to craft the smallest reversible patches.

Can I use minimal patches to stabilize Gradle Kotlin DSL builds without changing behavior?

Yes, you can stabilize Gradle Kotlin DSL builds with minimal patches that preserve behavior. The process analyzes wrapper versions, Kotlin DSL settings, and plugin resolutions to generate small, reversible changes that restore build stability safely.

What is the best way to diagnose BOM drift in Gradle Kotlin DSL projects?

The best way to diagnose BOM drift in Gradle Kotlin DSL projects is using a diagnostics-driven workflow. It analyzes BOM usage alongside wrapper versions and Kotlin DSL settings to identify dependency misconfigurations and craft safe, smallest patches.

Does diagnosing Gradle wrapper versions help fix Kotlin DSL build failures?

Yes, diagnosing Gradle wrapper versions helps fix Kotlin DSL build failures. Analyzing wrapper versions alongside plugin resolutions and Kotlin DSL settings identifies incompatibilities, enabling the generation of minimal, compatible patches to restore stability.