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.
Install
npx skills add JetBrains/skills --skill kotlin-spring-proxy-compatibilitygit 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-compatibilityPersonal 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.Details
- Skill name
kotlin-spring-proxy-compatibility- Repository
- JetBrains/skills
- 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
398JetBrains/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".
Vercel React Native Skills
398JetBrains/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.
Vitest
398JetBrains/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.
Kotlin Tooling Agp9 Migration
398JetBrains/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.
Kotlin Backend Jpa Entity Mapping
398JetBrains/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.
Kotlin Tooling Cocoapods Spm Migration
398JetBrains/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.
Browse the most popular Claude skills, all mobile development skills, or write your own with the skills generator.