Claude Cursor Skill

writing-java-kotlin

Imported from alexei-led/cc-thingz/dist/pi/skills/writing-java-kotlin.

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download alexei-led-cc-thingz-dist_pi_skills_writing-java-kotlin-0a6445b.zip · 3 KB

Install

skills CLI npx skills add https://github.com/alexei-led/cc-thingz/tree/master/dist/pi/skills/writing-java-kotlin
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alexei-led-cc-thingz@llmmart
Git git clone https://github.com/alexei-led/cc-thingz.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alexei-led/cc-thingz collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Java and Kotlin Development

Build baseline

  • Read the wrapper properties, settings.gradle*/build.gradle*/gradle.properties or pom.xml, and CI before relying on version-specific behavior.
  • Use ./gradlew/./mvnw when the repo has them; scope tests to the changed module (see testing.md).
  • The compile target is the declared Java toolchain and Kotlin jvmToolchain, not the shell's JAVA_HOME; without one, the running JDK compiles.
  • Toolchain, plugin, and dependency versions live in convention plugins, version catalogs, BOMs, or parent POMs, set once there. Raising the Java or Kotlin toolchain is a project-wide decision: ask, and change it in shared build config, not one module.
  • A request to use a preview feature is not approval to enable it: ask first, name a non-preview fallback, and, once approved, add --enable-preview to the build's compile and run/test tasks, not a local flag. Previews can be withdrawn between JDKs: string templates were withdrawn in JDK 23.
  • Wire coverage, mutation, or other heavy analysis as its own task or under check; never make test depend on or be finalized by the report, which would still run it on every plain test. Use a separate command or CI step, even when adding it is the task.

Defaults

  • Kotlin: structured concurrency only — no GlobalScope; pass a coroutineScope or an injected scope through the call chain. Test coroutine code with kotlinx-coroutines-test's runTest, not runBlocking or real delays. Keep blocking calls off event-loop and coroutine dispatcher threads unless the framework allows it.
  • Kotlin: resolve nullable Java platform types at the boundary instead of asserting past them with !!.
  • Java: say outright when virtual threads help (blocking I/O) versus don't (CPU-bound work); size CPU-bound work to a bounded pool near the processor count or a parallel stream. Never swallow InterruptedException — restore the flag or propagate it. No static state for config, clocks, clients, executors, or scopes.
  • Don't leak JPA entities, ORM sessions, or generated API models through domain interfaces; map to a DTO while the transaction is open, loading what it needs (fetch join or entity graph) instead of keeping the session open via spring.jpa.open-in-view.

References

  • testing.md: read when adding or reshaping tests, or when Gradle/Maven test runs are slow.
  • linting.md: read when changing formatters, ktlint, detekt, Spotless, or static analysis.

Done when the relevant build/test/lint checks pass on what you changed, or you name each check that did not run and why.

Files (cc-thingz)
  • references
    • linting.md 886 B
      Loading…
    • testing.md 674 B
      Loading…
  • SKILL.md 3.6 KB
    ---
    {"description":"Idiomatic modern Java and Kotlin JVM development. Use when writing `.java`, `.kt`, or `.kts` code; changing Gradle or Maven builds; or working on Spring, Micronaut, Quarkus, Ktor, Android JVM modules, JUnit, Mockito, Kotest, ktlint, detekt, or JVM CLI/services. Emphasizes JDK toolchains, null-safety, fast focused Gradle/Maven feedback, deterministic formatting, and minimal dependencies. NOT for JavaScript/TypeScript, C#/.NET, Python, shell scripts, or infra-only work.","name":"writing-java-kotlin"}
    ---
    <!-- Pi platform guidance -->
    <!-- Use installed tool names. Discover callable tools before batching independent calls in codemode; model-only UI/orchestration tools must be called directly. -->
    <!-- Read required skill/instruction files through direct read when exposed or through Code Mode. If an optional pruning extension is installed, verify its output protection semantics; do not assume nested-path protection. Code Mode composes calls; subagents or controllers own durable workflows. Async subagents notify natively: yield rather than poll. -->
    
    
    # Java and Kotlin Development
    
    ## Build baseline
    
    - Read the wrapper properties, `settings.gradle*`/`build.gradle*`/`gradle.properties` or `pom.xml`, and CI before relying on version-specific behavior.
    - Use `./gradlew`/`./mvnw` when the repo has them; scope tests to the changed module (see testing.md).
    - The compile target is the declared Java toolchain and Kotlin `jvmToolchain`, not the shell's `JAVA_HOME`; without one, the running JDK compiles.
    - Toolchain, plugin, and dependency versions live in convention plugins, version catalogs, BOMs, or parent POMs, set once there. Raising the Java or Kotlin toolchain is a project-wide decision: ask, and change it in shared build config, not one module.
    - A request to use a preview feature is not approval to enable it: ask first, name a non-preview fallback, and, once approved, add `--enable-preview` to the build's compile and run/test tasks, not a local flag. Previews can be withdrawn between JDKs: string templates were withdrawn in JDK 23.
    - Wire coverage, mutation, or other heavy analysis as its own task or under `check`; never make `test` depend on or be finalized by the report, which would still run it on every plain `test`. Use a separate command or CI step, even when adding it is the task.
    
    ## Defaults
    
    - Kotlin: structured concurrency only — no `GlobalScope`; pass a `coroutineScope` or an injected scope through the call chain. Test coroutine code with `kotlinx-coroutines-test`'s `runTest`, not `runBlocking` or real delays. Keep blocking calls off event-loop and coroutine dispatcher threads unless the framework allows it.
    - Kotlin: resolve nullable Java platform types at the boundary instead of asserting past them with `!!`.
    - Java: say outright when virtual threads help (blocking I/O) versus don't (CPU-bound work); size CPU-bound work to a bounded pool near the processor count or a parallel stream. Never swallow `InterruptedException` — restore the flag or propagate it. No static state for config, clocks, clients, executors, or scopes.
    - Don't leak JPA entities, ORM sessions, or generated API models through domain interfaces; map to a DTO while the transaction is open, loading what it needs (fetch join or entity graph) instead of keeping the session open via `spring.jpa.open-in-view`.
    
    ## References
    
    - [testing.md](references/testing.md): read when adding or reshaping tests, or when Gradle/Maven test runs are slow.
    - [linting.md](references/linting.md): read when changing formatters, ktlint, detekt, Spotless, or static analysis.
    
    Done when the relevant build/test/lint checks pass on what you changed, or you name each check that did not run and why.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.