Kotlin Spring Proxy Compatibility

Diagnose and prevent Kotlin plus Spring proxy failures around `@Transactional`, `@Cacheable`, `@Async`, method security, retry, configuration proxies, and JPA entity requirements. Use when AOP annotations appear to do nothing, transactional or cache behavior is inconsistent, compiler plugins may be missing, self-invocation is suspected, or Kotlin final-by-default semantics may break Spring behavior.

398 stars 35 forksMobile Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add JetBrains/skills --skill kotlin-spring-proxy-compatibility
Manual install
git clone --depth 1 https://github.com/JetBrains/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/kotlin-spring-proxy-compatibility ~/.claude/skills/kotlin-spring-proxy-compatibility

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Kotlin Spring Proxy Compatibility

Source mapping: Tier 1 critical skill derived from `Kotlin_Spring_Developer_Pipeline.md` (`SK-03`).

## Mission

Explain exactly why Spring interception does or does not happen for Kotlin code, then propose the safest fix.
Focus on runtime behavior, not on code that merely looks annotated.

## Read These Inputs

- The class and method carrying `@Transactional`, `@Cacheable`, `@Async`, `@Retryable`, security annotations, or other proxy-triggering annotations.
- The call site. Determine whether the method is called through another bean or through `this`.
- Build files. Verify `kotlin("plugin.spring")`, `kotlin("plugin.jpa")`, or any custom `allOpen` and `noArg` configuration.
- Whether the bean is proxied through an interface or through CGLIB class proxies.
- For persistence problems, read the entity class shape and JPA plugin setup.

## Diagnose In This Order

1. Verify whether a proxy should exist at all.
2. Verify whether the call crosses the proxy boundary.
3. Verify whether the class or method is proxyable.
4. Verify whether the annotation is placed on the method Spring actually intercepts.
5. Verify whether build-time plugins opened the relevant classes.
6. Verify whether the bug is actually transactional semantics, not proxy creation.

## Core Checks

- Check for self-invocation. A method calling another annotated method in the same class bypasses the proxy.
Read the full skill on GitHub

Details

Skill name
kotlin-spring-proxy-compatibility
Path
kotlin-spring-proxy-compatibility/SKILL.md
Repo updated
21 October 2026

FAQ

What does the Kotlin Spring Proxy Compatibility skill do?

Diagnose and prevent Kotlin plus Spring proxy failures around `@Transactional`, `@Cacheable`, `@Async`, method security, retry, configuration proxies, and JPA entity requirements. Use when AOP annotations appear to do nothing, transactional or cache behavior is inconsistent, compiler plugins may be missing, self-invocation is suspected, or Kotlin final-by-default semantics may break Spring behavior.

How do I install the Kotlin Spring Proxy Compatibility skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add JetBrains/skills --skill kotlin-spring-proxy-compatibility. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Kotlin Spring Proxy Compatibility popular?

It lives in JetBrains/skills, which has 398 GitHub stars and 35 forks.

Related skills

Deploy to Vercel

398

JetBrains/skills

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

DevOps & CloudIn 2 lists35

Vercel React Native Skills

398

JetBrains/skills

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

Mobile DevelopmentIn 2 lists35

Vitest

398

JetBrains/skills

Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.

Testing & QA35

Kotlin Tooling Agp9 Migration

398

JetBrains/skills

Migrates Kotlin Multiplatform (KMP) projects to Android Gradle Plugin 9.0+. Handles plugin replacement (com.android.kotlin.multiplatform.library), module splitting, DSL migration, and the new default project structure. Use when upgrading AGP, when build fails due to KMP+AGP incompatibility, or when the user mentions AGP 9.0, android multiplatform plugin, KMP migration, or com.android.kotlin.multiplatform.library.

Mobile Development35

Kotlin Backend Jpa Entity Mapping

398

JetBrains/skills

Model Kotlin persistence code correctly for Spring Data JPA and Hibernate. Covers entity design, identity and equality, uniqueness constraints, relationships, fetch plans, and common ORM (Object-Relational Mapping) traps specific to Kotlin. Use when creating or reviewing JPA (Java Persistence API) entities, diagnosing N+1 or LazyInitializationException, placing indexes and uniqueness rules, or preventing Kotlin-specific bugs such as data class entities and broken equals/hashCode.

Mobile Development35

Kotlin Tooling Cocoapods Spm Migration

398

JetBrains/skills

Migrate KMP projects from CocoaPods (kotlin("native.cocoapods")) to Swift Package Manager (swiftPMDependencies DSL) — replaces pod() with swiftPackage(), transforms cocoapods.* imports to swiftPMImport.*, and reconfigures the Xcode project.

Mobile Development35

Browse the most popular Claude skills, all mobile development skills, or write your own with the skills generator.