name: kotlin-dsl description: Kotlin DSL - type-safe builders, Gradle DSL, @DslMarker version: "1.0.0" sasmp_version: "1.3.0" bonded_agent: 07-kotlin-dsl bond_type: PRIMARY_BOND execution: timeout_ms: 30000 retry: max_attempts: 3 backoff: exponential initial_delay_ms: 1000 parameters: required: - name: type type: string validation: "^(gradle|custom|html|config)$" optional: - name: immutable type: boolean default: true logging: level: info events: [skill_invoked, type_loaded, error_occurred]

Kotlin DSL Skill

Build type-safe DSLs with Kotlin's language features.

Topics Covered

@DslMarker for Scope Control

kotlin

@DslMarker
annotation class HtmlDsl

@HtmlDsl
class HTML { fun body(block: Body.() -> Unit) { } }

@HtmlDsl
class Body { fun p(text: String) { } }

// Usage - scoped correctly
html { body { p("Text") } }

Gradle Convention Plugin

kotlin

// kotlin-library.gradle.kts
plugins { kotlin("jvm"); `java-library` }

kotlin { jvmToolchain(17) }

dependencies {
    testImplementation(kotlin("test"))
    testImplementation("io.mockk:mockk:1.13.9")
}

tasks.test { useJUnitPlatform() }

Type-Safe Config Builder

kotlin

@ConfigDsl
class ServerConfig private constructor(val host: String, val port: Int) {
    class Builder {
        var host = "localhost"
        var port = 8080
        fun build() = ServerConfig(host, port)
    }
}

fun serverConfig(block: ServerConfig.Builder.() -> Unit) =
    ServerConfig.Builder().apply(block).build()

// Usage
val config = serverConfig { host = "api.example.com"; port = 443 }

Troubleshooting

Issue	Resolution
Scope pollution	Add @DslMarker annotation
Gradle cache stale	Run ./gradlew --stop

Usage

code

Skill("kotlin-dsl")