gradle-kotlin-dsl-doctor

Diagnose and patch failing Kotlin Gradle DSL builds with minimal changes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stabilizes Kotlin DSL Gradle builds by enabling quick diagnosis and applying minimal, compatible patches to restore stability when common Kotlin DSL issues arise.

Core Features & Use Cases

  • Diagnose Gradle Kotlin DSL failures including plugin resolution, syntax issues, dependency resolution, BOM drift, and toolchain mismatches.
  • Propose minimal, safe patches that preserve project conventions and Spring Boot compatibility.
  • Validate fixes with targeted Gradle checks and guardrails to reduce regressions.

Quick Start

Run the Gradle Kotlin DSL Doctor on the failing project and apply the smallest 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 a failing Kotlin DSL Gradle build without breaking Spring Boot compatibility?

Fix a failing Kotlin DSL Gradle build by diagnosing plugin resolution, syntax issues, or BOM drift, then applying minimal patches to build.gradle.kts or settings.gradle.kts that preserve Spring Boot compatibility and validate with targeted Gradle checks.

What causes BOM drift and toolchain mismatches in Kotlin DSL projects?

BOM drift and toolchain mismatches in Kotlin DSL projects happen when plugin versions or dependency BOMs fall out of sync, causing runtime or test failures. Diagnosing these Gradle issues identifies incompatible components to target with minimal, safe patches.

Can I repair a Gradle build failure by patching only the smallest scope file changes?

Yes, you can repair Gradle build failures by patching the smallest scope file changes. This approach targets the specific failure type in your Kotlin DSL files and applies minimal compatible patches to reduce regressions and restore build stability.

Does the Gradle Kotlin DSL Doctor work for both build.gradle.kts and settings.gradle.kts files?

Yes, diagnosing and repairing applies to Kotlin DSL projects using both build.gradle.kts and settings.gradle.kts files. It identifies failure types across these files and proposes safe patches to stabilize the build.

What is the best way to stabilize a Kotlin Gradle build when plugins are incompatible?

The best way to stabilize a Kotlin Gradle build with incompatible plugins is to identify the specific plugin resolution failure, apply minimal compatible patches to the Kotlin DSL files, and validate the fix with targeted Gradle checks to prevent regressions.

Why does my Gradle Kotlin DSL build keep failing after dependency updates?

Your Gradle Kotlin DSL build may keep failing due to BOM drift affecting dependencies, tests, or runtimes after updates. Diagnosing the failure type helps generate minimal, safe patches that restore stability and validate the fix with targeted Gradle checks.