gradle-kotlin-dsl-doctor

Diagnose Kotlin DSL/Gradle build failures and propose minimal compatible fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kotlin/Gradle builds with Kotlin DSL can become unstable when plugin versions, BOMs, or toolchains drift; this Skill diagnoses the failure and prescribes minimal, safe changes to restore compatibility, reducing risk and downtime.

Core Features & Use Cases

  • Diagnose and classify Kotlin DSL and Gradle build failures, including plugin resolution, dependency resolution, and toolchain mismatches.
  • Propose minimal, defensible patches that preserve Spring Boot BOM coherence and existing project conventions.
  • Use case: when a build.gradle.kts or settings.gradle.kts fails due to incompatible plugin versions, this Doctor identifies the root cause and suggests the smallest patch to regain a successful build.

Quick Start

Run the Gradle Kotlin DSL Doctor against a failing Kotlin DSL project to apply a minimal, safe fix.

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 Kotlin DSL Gradle build failures caused by plugin version mismatches?

To fix Kotlin DSL Gradle build failures, diagnose incompatible plugin versions in build.gradle.kts and apply minimal patches that restore compatibility while preserving existing project conventions. This approach identifies the root cause and proposes the smallest safe change to regain a successful build.

Can I repair a settings.gradle.kts file without breaking Spring Boot BOM coherence?

Yes, you can repair settings.gradle.kts while maintaining Spring Boot BOM coherence by prescribing minimal, defensible patches. The process validates BOM compatibility and ensures that bounded changes do not disrupt existing dependency management configurations.

What causes Gradle toolchain and Kotlin plugin compatibility issues during a build?

Gradle toolchain and Kotlin plugin compatibility issues arise when plugin versions, BOMs, or toolchains drift from their expected configurations. Diagnosing these failures involves classifying the resolution errors and validating the Gradle wrapper, Kotlin plugin, and toolchain versions together.

How do I diagnose dependency resolution errors in a Kotlin DSL Gradle project?

Diagnosing dependency resolution errors in a Kotlin DSL Gradle project involves classifying the build failures and identifying version drifts. The process checks toolchain mismatches and proposes minimal patches to restore compatibility without introducing unbounded scope changes.

Does this approach work for both build.gradle.kts and settings.gradle.kts files?

Yes, this approach works for both build.gradle.kts and settings.gradle.kts files. It is applicable to Kotlin DSL projects using Gradle, diagnosing failures across plugin resolution, dependency resolution, and toolchain mismatches to apply safe fixes.

What are the limitations of applying minimal patches to restore Gradle Kotlin DSL compatibility?

The limitation of applying minimal patches is that changes are strictly bounded to the smallest scope possible to reduce risk. While this safely restores Gradle Kotlin DSL compatibility, it focuses on targeted fixes rather than comprehensive build refactoring or upgrading unrelated dependencies.