[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-jetbrains-java-kotlin-migration-assistant":3,"mdc--w3ik9b-key":36,"related-org-jetbrains-java-kotlin-migration-assistant":652,"related-repo-jetbrains-java-kotlin-migration-assistant":783},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"java-kotlin-migration-assistant","migrate Java code to Kotlin","Migrate Java code to Kotlin in Spring-based codebases without changing behavior, public contracts, framework compatibility, or binary assumptions unless explicitly intended. Use when converting classes incrementally, replacing Lombok patterns, managing platform types and nullability, preserving JPA and proxy behavior, or planning the safe migration order of a mixed Java and Kotlin codebase.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"jetbrains","JetBrains","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fjetbrains.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Kotlin","kotlin","tag",{"name":17,"slug":18,"type":15},"Java","java",{"name":20,"slug":21,"type":15},"Spring","spring",{"name":23,"slug":24,"type":15},"Migration","migration",252,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002Fskills","2026-07-17T06:06:16.815289",null,17,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"Curated agent skills collection verified by JetBrains","https:\u002F\u002Fgithub.com\u002FJetBrains\u002Fskills\u002Ftree\u002FHEAD\u002Fjava-kotlin-migration-assistant","---\nname: java-kotlin-migration-assistant\ndescription: Migrate Java code to Kotlin in Spring-based codebases without changing behavior, public contracts, framework compatibility, or binary assumptions unless explicitly intended. Use when converting classes incrementally, replacing Lombok patterns, managing platform types and nullability, preserving JPA and proxy behavior, or planning the safe migration order of a mixed Java and Kotlin codebase.\nmetadata:\n  short-description: \"Migrate safely without semantic drift\"\n  author: Kotlin\n  source: https:\u002F\u002Fgithub.com\u002FKotlin\u002Fkotlin-backend-agent-skills\u002Ftree\u002Fmain\u002F.agents\u002Fskills\u002Fjava-kotlin-migration-assistant\n---\n\n# Java Kotlin Migration Assistant\n\nSource mapping: Tier 3 specialized skill derived from `Kotlin_Spring_Developer_Pipeline.md` (`SK-19`).\n\n## Mission\n\nTranslate Java into Kotlin in a way that improves long-term maintainability without introducing semantic drift.\nPrioritize behavioral equivalence first, idiomatic cleanup second, and broad redesign only when explicitly requested.\n\n## Read First\n\n- The Java class and its callers.\n- Existing tests and any contract documentation.\n- Spring annotations, JPA annotations, Jackson annotations, validation annotations, and logging patterns.\n- Build plugins and Kotlin compiler configuration already present in the repository.\n- Whether the module is internal-only or has external consumers that care about binary compatibility.\n\n## Migration Order\n\nUse this default order unless the repository strongly suggests otherwise:\n\n1. Tests and support utilities.\n2. Stateless helpers and internal-only classes.\n3. Services and controllers.\n4. Domain models and DTOs.\n5. Entities and framework-sensitive classes last.\n\nThe most fragile classes are usually entities, heavily proxied services, reflection-heavy config classes, and public library APIs.\n\n## Translation Rules\n\n- Preserve public behavior before pursuing idiomatic compression.\n- Convert fields plus getters plus setters into properties only when that does not change framework expectations.\n- Replace Lombok consciously:\n  - `@Data` is not a universal reason to create a Kotlin `data class`\n  - `@Builder` may map to named\u002Fdefault parameters or may need an explicit builder for Java callers\n  - `@Slf4j` usually becomes an explicit logger field or companion object\n- Replace checked-exception-heavy flows carefully. Kotlin does not enforce checked exceptions, but Java callers may still depend on them semantically.\n- Keep annotations on the correct target after translation. Kotlin use-site targets matter.\n\n## Nullability And Platform-Type Rules\n\n- Treat every Java type crossing into Kotlin as suspect until nullability is proven.\n- Add explicit Kotlin nullability based on contracts, not on optimistic guesses.\n- If upstream Java code lacks annotations, prefer defensive boundary checks over sprinkling `!!`.\n- Distinguish internal invariants from external compatibility. Sometimes a Kotlin non-null model is correct internally even when the Java boundary remains nullable.\n- Re-check collections, optionals, and maps separately. Java usage patterns often hide null values inside otherwise non-null containers.\n\n## Spring And JPA Nuances\n\n- Verify proxy-sensitive classes still work after translation:\n  - `@Transactional`\n  - `@Cacheable`\n  - `@Async`\n  - method security\n- Do not convert JPA entities into `data class`.\n- Preserve JPA constructor, field access, and equality semantics deliberately.\n- Re-check `@ConfigurationProperties`, Jackson creator behavior, and validation annotations after constructor translation.\n- If the project relies on interface-based proxies, do not accidentally move critical behavior into non-interface methods that callers bypass.\n\n## Advanced Migration Traps\n\n- Default parameters can change Java call sites, overload generation, and reflective constructor expectations.\n- Kotlin properties may alter method signatures, bean-introspection shape, and serialization behavior compared with explicit Java accessors.\n- Inline classes, sealed hierarchies, and scope-function-heavy refactors are not first-pass migration tools. Use them after compatibility is proven.\n- Replacing mutable Java collections with read-only Kotlin interfaces does not magically make the backing data immutable.\n- `equals`, `hashCode`, and `toString` generation can silently change semantics for entities, cache keys, and logging.\n- Library modules may need `@JvmStatic`, `@JvmOverloads`, `@JvmField`, or explicit overload preservation for Java consumers.\n- Mixed Java\u002FKotlin modules can expose incremental compilation and annotation-processing surprises. Keep build verification tight during migration.\n\n## Bytecode And Interop Nuances\n\n- `internal` visibility is a module-level bytecode concept, not a source-level privacy guarantee. Do not use it casually in previously public or Java-consumed APIs.\n- Interface default methods, companion objects, and top-level functions alter Java call ergonomics and sometimes reflective lookup paths.\n- SAM conversion, raw types, and wildcard variance can change overload resolution at Java call sites even when Kotlin looks cleaner.\n- `Optional\u003CT>`, primitive wrappers, arrays, and checked exceptions each deserve explicit migration treatment; do not lump them under generic nullability cleanup.\n- Parameter-name retention, generated constructors, and method overloading affect frameworks that use reflection or bytecode-generated proxies.\n- Annotation processors, generated metamodels, and kapt or KSP transitions can change what \"successful migration\" means for the build beyond source compilation.\n\n## Expert Heuristics\n\n- If a class is consumed by Java, optimize for interop predictability before Kotlin elegance.\n- Migrate behaviorally boring classes first to establish project conventions for logging, nullability, builders, and testing.\n- Delay introduction of coroutines, sealed redesigns, and stronger domain modeling until the mixed Java\u002FKotlin seam is stable.\n- When uncertain, preserve explicit methods over collapsing everything into properties or generated helpers. Debuggability and binary stability matter during migration.\n\n## Output Contract\n\nReturn these sections:\n\n- `Migration scope`: what is being converted now and what stays in Java for the moment.\n- `Behavioral invariants`: what must remain unchanged.\n- `Kotlin translation plan`: the exact language-level changes to make.\n- `Framework constraints`: Spring, Jackson, JPA, validation, and binary-compatibility concerns.\n- `Verification`: tests and runtime checks that prove no semantic drift.\n\n## Guardrails\n\n- Do not change public API shape casually.\n- Do not hide uncertain nullability behind `!!`.\n- Do not mix migration with broad architectural redesign unless explicitly asked.\n- Do not make entity, proxy, or serialization classes \"more idiomatic\" at the cost of framework correctness.\n\n## Quality Bar\n\nA good run of this skill yields Kotlin that is safer and cleaner while still behaving like the original Java where it matters.\nA bad run produces \"Java with Kotlin syntax\" or, worse, a pretty rewrite that silently breaks callers, proxies, or persistence.\n",{"data":37,"body":41},{"name":4,"description":6,"metadata":38},{"short-description":39,"author":13,"source":40},"Migrate safely without semantic drift","https:\u002F\u002Fgithub.com\u002FKotlin\u002Fkotlin-backend-agent-skills\u002Ftree\u002Fmain\u002F.agents\u002Fskills\u002Fjava-kotlin-migration-assistant",{"type":42,"children":43},"root",[44,52,75,82,87,93,123,129,134,163,168,174,244,250,286,292,369,375,457,463,508,514,537,543,548,606,612,641,647],{"type":45,"tag":46,"props":47,"children":48},"element","h1",{"id":4},[49],{"type":50,"value":51},"text","Java Kotlin Migration Assistant",{"type":45,"tag":53,"props":54,"children":55},"p",{},[56,58,65,67,73],{"type":50,"value":57},"Source mapping: Tier 3 specialized skill derived from ",{"type":45,"tag":59,"props":60,"children":62},"code",{"className":61},[],[63],{"type":50,"value":64},"Kotlin_Spring_Developer_Pipeline.md",{"type":50,"value":66}," (",{"type":45,"tag":59,"props":68,"children":70},{"className":69},[],[71],{"type":50,"value":72},"SK-19",{"type":50,"value":74},").",{"type":45,"tag":76,"props":77,"children":79},"h2",{"id":78},"mission",[80],{"type":50,"value":81},"Mission",{"type":45,"tag":53,"props":83,"children":84},{},[85],{"type":50,"value":86},"Translate Java into Kotlin in a way that improves long-term maintainability without introducing semantic drift.\nPrioritize behavioral equivalence first, idiomatic cleanup second, and broad redesign only when explicitly requested.",{"type":45,"tag":76,"props":88,"children":90},{"id":89},"read-first",[91],{"type":50,"value":92},"Read First",{"type":45,"tag":94,"props":95,"children":96},"ul",{},[97,103,108,113,118],{"type":45,"tag":98,"props":99,"children":100},"li",{},[101],{"type":50,"value":102},"The Java class and its callers.",{"type":45,"tag":98,"props":104,"children":105},{},[106],{"type":50,"value":107},"Existing tests and any contract documentation.",{"type":45,"tag":98,"props":109,"children":110},{},[111],{"type":50,"value":112},"Spring annotations, JPA annotations, Jackson annotations, validation annotations, and logging patterns.",{"type":45,"tag":98,"props":114,"children":115},{},[116],{"type":50,"value":117},"Build plugins and Kotlin compiler configuration already present in the repository.",{"type":45,"tag":98,"props":119,"children":120},{},[121],{"type":50,"value":122},"Whether the module is internal-only or has external consumers that care about binary compatibility.",{"type":45,"tag":76,"props":124,"children":126},{"id":125},"migration-order",[127],{"type":50,"value":128},"Migration Order",{"type":45,"tag":53,"props":130,"children":131},{},[132],{"type":50,"value":133},"Use this default order unless the repository strongly suggests otherwise:",{"type":45,"tag":135,"props":136,"children":137},"ol",{},[138,143,148,153,158],{"type":45,"tag":98,"props":139,"children":140},{},[141],{"type":50,"value":142},"Tests and support utilities.",{"type":45,"tag":98,"props":144,"children":145},{},[146],{"type":50,"value":147},"Stateless helpers and internal-only classes.",{"type":45,"tag":98,"props":149,"children":150},{},[151],{"type":50,"value":152},"Services and controllers.",{"type":45,"tag":98,"props":154,"children":155},{},[156],{"type":50,"value":157},"Domain models and DTOs.",{"type":45,"tag":98,"props":159,"children":160},{},[161],{"type":50,"value":162},"Entities and framework-sensitive classes last.",{"type":45,"tag":53,"props":164,"children":165},{},[166],{"type":50,"value":167},"The most fragile classes are usually entities, heavily proxied services, reflection-heavy config classes, and public library APIs.",{"type":45,"tag":76,"props":169,"children":171},{"id":170},"translation-rules",[172],{"type":50,"value":173},"Translation Rules",{"type":45,"tag":94,"props":175,"children":176},{},[177,182,187,234,239],{"type":45,"tag":98,"props":178,"children":179},{},[180],{"type":50,"value":181},"Preserve public behavior before pursuing idiomatic compression.",{"type":45,"tag":98,"props":183,"children":184},{},[185],{"type":50,"value":186},"Convert fields plus getters plus setters into properties only when that does not change framework expectations.",{"type":45,"tag":98,"props":188,"children":189},{},[190,192],{"type":50,"value":191},"Replace Lombok consciously:\n",{"type":45,"tag":94,"props":193,"children":194},{},[195,212,223],{"type":45,"tag":98,"props":196,"children":197},{},[198,204,206],{"type":45,"tag":59,"props":199,"children":201},{"className":200},[],[202],{"type":50,"value":203},"@Data",{"type":50,"value":205}," is not a universal reason to create a Kotlin ",{"type":45,"tag":59,"props":207,"children":209},{"className":208},[],[210],{"type":50,"value":211},"data class",{"type":45,"tag":98,"props":213,"children":214},{},[215,221],{"type":45,"tag":59,"props":216,"children":218},{"className":217},[],[219],{"type":50,"value":220},"@Builder",{"type":50,"value":222}," may map to named\u002Fdefault parameters or may need an explicit builder for Java callers",{"type":45,"tag":98,"props":224,"children":225},{},[226,232],{"type":45,"tag":59,"props":227,"children":229},{"className":228},[],[230],{"type":50,"value":231},"@Slf4j",{"type":50,"value":233}," usually becomes an explicit logger field or companion object",{"type":45,"tag":98,"props":235,"children":236},{},[237],{"type":50,"value":238},"Replace checked-exception-heavy flows carefully. Kotlin does not enforce checked exceptions, but Java callers may still depend on them semantically.",{"type":45,"tag":98,"props":240,"children":241},{},[242],{"type":50,"value":243},"Keep annotations on the correct target after translation. Kotlin use-site targets matter.",{"type":45,"tag":76,"props":245,"children":247},{"id":246},"nullability-and-platform-type-rules",[248],{"type":50,"value":249},"Nullability And Platform-Type Rules",{"type":45,"tag":94,"props":251,"children":252},{},[253,258,263,276,281],{"type":45,"tag":98,"props":254,"children":255},{},[256],{"type":50,"value":257},"Treat every Java type crossing into Kotlin as suspect until nullability is proven.",{"type":45,"tag":98,"props":259,"children":260},{},[261],{"type":50,"value":262},"Add explicit Kotlin nullability based on contracts, not on optimistic guesses.",{"type":45,"tag":98,"props":264,"children":265},{},[266,268,274],{"type":50,"value":267},"If upstream Java code lacks annotations, prefer defensive boundary checks over sprinkling ",{"type":45,"tag":59,"props":269,"children":271},{"className":270},[],[272],{"type":50,"value":273},"!!",{"type":50,"value":275},".",{"type":45,"tag":98,"props":277,"children":278},{},[279],{"type":50,"value":280},"Distinguish internal invariants from external compatibility. Sometimes a Kotlin non-null model is correct internally even when the Java boundary remains nullable.",{"type":45,"tag":98,"props":282,"children":283},{},[284],{"type":50,"value":285},"Re-check collections, optionals, and maps separately. Java usage patterns often hide null values inside otherwise non-null containers.",{"type":45,"tag":76,"props":287,"children":289},{"id":288},"spring-and-jpa-nuances",[290],{"type":50,"value":291},"Spring And JPA Nuances",{"type":45,"tag":94,"props":293,"children":294},{},[295,335,346,351,364],{"type":45,"tag":98,"props":296,"children":297},{},[298,300],{"type":50,"value":299},"Verify proxy-sensitive classes still work after translation:\n",{"type":45,"tag":94,"props":301,"children":302},{},[303,312,321,330],{"type":45,"tag":98,"props":304,"children":305},{},[306],{"type":45,"tag":59,"props":307,"children":309},{"className":308},[],[310],{"type":50,"value":311},"@Transactional",{"type":45,"tag":98,"props":313,"children":314},{},[315],{"type":45,"tag":59,"props":316,"children":318},{"className":317},[],[319],{"type":50,"value":320},"@Cacheable",{"type":45,"tag":98,"props":322,"children":323},{},[324],{"type":45,"tag":59,"props":325,"children":327},{"className":326},[],[328],{"type":50,"value":329},"@Async",{"type":45,"tag":98,"props":331,"children":332},{},[333],{"type":50,"value":334},"method security",{"type":45,"tag":98,"props":336,"children":337},{},[338,340,345],{"type":50,"value":339},"Do not convert JPA entities into ",{"type":45,"tag":59,"props":341,"children":343},{"className":342},[],[344],{"type":50,"value":211},{"type":50,"value":275},{"type":45,"tag":98,"props":347,"children":348},{},[349],{"type":50,"value":350},"Preserve JPA constructor, field access, and equality semantics deliberately.",{"type":45,"tag":98,"props":352,"children":353},{},[354,356,362],{"type":50,"value":355},"Re-check ",{"type":45,"tag":59,"props":357,"children":359},{"className":358},[],[360],{"type":50,"value":361},"@ConfigurationProperties",{"type":50,"value":363},", Jackson creator behavior, and validation annotations after constructor translation.",{"type":45,"tag":98,"props":365,"children":366},{},[367],{"type":50,"value":368},"If the project relies on interface-based proxies, do not accidentally move critical behavior into non-interface methods that callers bypass.",{"type":45,"tag":76,"props":370,"children":372},{"id":371},"advanced-migration-traps",[373],{"type":50,"value":374},"Advanced Migration Traps",{"type":45,"tag":94,"props":376,"children":377},{},[378,383,388,393,398,425,452],{"type":45,"tag":98,"props":379,"children":380},{},[381],{"type":50,"value":382},"Default parameters can change Java call sites, overload generation, and reflective constructor expectations.",{"type":45,"tag":98,"props":384,"children":385},{},[386],{"type":50,"value":387},"Kotlin properties may alter method signatures, bean-introspection shape, and serialization behavior compared with explicit Java accessors.",{"type":45,"tag":98,"props":389,"children":390},{},[391],{"type":50,"value":392},"Inline classes, sealed hierarchies, and scope-function-heavy refactors are not first-pass migration tools. Use them after compatibility is proven.",{"type":45,"tag":98,"props":394,"children":395},{},[396],{"type":50,"value":397},"Replacing mutable Java collections with read-only Kotlin interfaces does not magically make the backing data immutable.",{"type":45,"tag":98,"props":399,"children":400},{},[401,407,409,415,417,423],{"type":45,"tag":59,"props":402,"children":404},{"className":403},[],[405],{"type":50,"value":406},"equals",{"type":50,"value":408},", ",{"type":45,"tag":59,"props":410,"children":412},{"className":411},[],[413],{"type":50,"value":414},"hashCode",{"type":50,"value":416},", and ",{"type":45,"tag":59,"props":418,"children":420},{"className":419},[],[421],{"type":50,"value":422},"toString",{"type":50,"value":424}," generation can silently change semantics for entities, cache keys, and logging.",{"type":45,"tag":98,"props":426,"children":427},{},[428,430,436,437,443,444,450],{"type":50,"value":429},"Library modules may need ",{"type":45,"tag":59,"props":431,"children":433},{"className":432},[],[434],{"type":50,"value":435},"@JvmStatic",{"type":50,"value":408},{"type":45,"tag":59,"props":438,"children":440},{"className":439},[],[441],{"type":50,"value":442},"@JvmOverloads",{"type":50,"value":408},{"type":45,"tag":59,"props":445,"children":447},{"className":446},[],[448],{"type":50,"value":449},"@JvmField",{"type":50,"value":451},", or explicit overload preservation for Java consumers.",{"type":45,"tag":98,"props":453,"children":454},{},[455],{"type":50,"value":456},"Mixed Java\u002FKotlin modules can expose incremental compilation and annotation-processing surprises. Keep build verification tight during migration.",{"type":45,"tag":76,"props":458,"children":460},{"id":459},"bytecode-and-interop-nuances",[461],{"type":50,"value":462},"Bytecode And Interop Nuances",{"type":45,"tag":94,"props":464,"children":465},{},[466,477,482,487,498,503],{"type":45,"tag":98,"props":467,"children":468},{},[469,475],{"type":45,"tag":59,"props":470,"children":472},{"className":471},[],[473],{"type":50,"value":474},"internal",{"type":50,"value":476}," visibility is a module-level bytecode concept, not a source-level privacy guarantee. Do not use it casually in previously public or Java-consumed APIs.",{"type":45,"tag":98,"props":478,"children":479},{},[480],{"type":50,"value":481},"Interface default methods, companion objects, and top-level functions alter Java call ergonomics and sometimes reflective lookup paths.",{"type":45,"tag":98,"props":483,"children":484},{},[485],{"type":50,"value":486},"SAM conversion, raw types, and wildcard variance can change overload resolution at Java call sites even when Kotlin looks cleaner.",{"type":45,"tag":98,"props":488,"children":489},{},[490,496],{"type":45,"tag":59,"props":491,"children":493},{"className":492},[],[494],{"type":50,"value":495},"Optional\u003CT>",{"type":50,"value":497},", primitive wrappers, arrays, and checked exceptions each deserve explicit migration treatment; do not lump them under generic nullability cleanup.",{"type":45,"tag":98,"props":499,"children":500},{},[501],{"type":50,"value":502},"Parameter-name retention, generated constructors, and method overloading affect frameworks that use reflection or bytecode-generated proxies.",{"type":45,"tag":98,"props":504,"children":505},{},[506],{"type":50,"value":507},"Annotation processors, generated metamodels, and kapt or KSP transitions can change what \"successful migration\" means for the build beyond source compilation.",{"type":45,"tag":76,"props":509,"children":511},{"id":510},"expert-heuristics",[512],{"type":50,"value":513},"Expert Heuristics",{"type":45,"tag":94,"props":515,"children":516},{},[517,522,527,532],{"type":45,"tag":98,"props":518,"children":519},{},[520],{"type":50,"value":521},"If a class is consumed by Java, optimize for interop predictability before Kotlin elegance.",{"type":45,"tag":98,"props":523,"children":524},{},[525],{"type":50,"value":526},"Migrate behaviorally boring classes first to establish project conventions for logging, nullability, builders, and testing.",{"type":45,"tag":98,"props":528,"children":529},{},[530],{"type":50,"value":531},"Delay introduction of coroutines, sealed redesigns, and stronger domain modeling until the mixed Java\u002FKotlin seam is stable.",{"type":45,"tag":98,"props":533,"children":534},{},[535],{"type":50,"value":536},"When uncertain, preserve explicit methods over collapsing everything into properties or generated helpers. Debuggability and binary stability matter during migration.",{"type":45,"tag":76,"props":538,"children":540},{"id":539},"output-contract",[541],{"type":50,"value":542},"Output Contract",{"type":45,"tag":53,"props":544,"children":545},{},[546],{"type":50,"value":547},"Return these sections:",{"type":45,"tag":94,"props":549,"children":550},{},[551,562,573,584,595],{"type":45,"tag":98,"props":552,"children":553},{},[554,560],{"type":45,"tag":59,"props":555,"children":557},{"className":556},[],[558],{"type":50,"value":559},"Migration scope",{"type":50,"value":561},": what is being converted now and what stays in Java for the moment.",{"type":45,"tag":98,"props":563,"children":564},{},[565,571],{"type":45,"tag":59,"props":566,"children":568},{"className":567},[],[569],{"type":50,"value":570},"Behavioral invariants",{"type":50,"value":572},": what must remain unchanged.",{"type":45,"tag":98,"props":574,"children":575},{},[576,582],{"type":45,"tag":59,"props":577,"children":579},{"className":578},[],[580],{"type":50,"value":581},"Kotlin translation plan",{"type":50,"value":583},": the exact language-level changes to make.",{"type":45,"tag":98,"props":585,"children":586},{},[587,593],{"type":45,"tag":59,"props":588,"children":590},{"className":589},[],[591],{"type":50,"value":592},"Framework constraints",{"type":50,"value":594},": Spring, Jackson, JPA, validation, and binary-compatibility concerns.",{"type":45,"tag":98,"props":596,"children":597},{},[598,604],{"type":45,"tag":59,"props":599,"children":601},{"className":600},[],[602],{"type":50,"value":603},"Verification",{"type":50,"value":605},": tests and runtime checks that prove no semantic drift.",{"type":45,"tag":76,"props":607,"children":609},{"id":608},"guardrails",[610],{"type":50,"value":611},"Guardrails",{"type":45,"tag":94,"props":613,"children":614},{},[615,620,631,636],{"type":45,"tag":98,"props":616,"children":617},{},[618],{"type":50,"value":619},"Do not change public API shape casually.",{"type":45,"tag":98,"props":621,"children":622},{},[623,625,630],{"type":50,"value":624},"Do not hide uncertain nullability behind ",{"type":45,"tag":59,"props":626,"children":628},{"className":627},[],[629],{"type":50,"value":273},{"type":50,"value":275},{"type":45,"tag":98,"props":632,"children":633},{},[634],{"type":50,"value":635},"Do not mix migration with broad architectural redesign unless explicitly asked.",{"type":45,"tag":98,"props":637,"children":638},{},[639],{"type":50,"value":640},"Do not make entity, proxy, or serialization classes \"more idiomatic\" at the cost of framework correctness.",{"type":45,"tag":76,"props":642,"children":644},{"id":643},"quality-bar",[645],{"type":50,"value":646},"Quality Bar",{"type":45,"tag":53,"props":648,"children":649},{},[650],{"type":50,"value":651},"A good run of this skill yields Kotlin that is safer and cleaner while still behaving like the original Java where it matters.\nA bad run produces \"Java with Kotlin syntax\" or, worse, a pretty rewrite that silently breaks callers, proxies, or persistence.",{"items":653,"total":782},[654,672,681,690,701,711,724,733,742,752,761,772],{"slug":655,"name":655,"fn":656,"description":657,"org":658,"tags":659,"stars":669,"repoUrl":670,"updatedAt":671},"mps-aspect-accessories","configure JetBrains MPS module dependencies","Wire MPS module and model dependencies, used languages, used devkits, extended languages, runtime solutions, accessory models, and language\u002Fdependency versions. Use when adding\u002Fremoving module dependencies, importing languages or devkits into a model, declaring runtime solutions, or shipping accessory content visible to consumers without explicit import.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[660,663,666],{"name":661,"slug":662,"type":15},"Architecture","architecture",{"name":664,"slug":665,"type":15},"Configuration","configuration",{"name":667,"slug":668,"type":15},"Engineering","engineering",1650,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS","2026-07-17T06:06:57.311661",{"slug":673,"name":673,"fn":674,"description":675,"org":676,"tags":677,"stars":669,"repoUrl":670,"updatedAt":680},"mps-aspect-actions","define and edit MPS node factories","Use when defining or editing MPS node factories (the \"actions\" aspect) — `NodeFactories` roots, per-concept `NodeFactory` setup functions that initialize a freshly created node and optionally copy data from a replaced `sampleNode`, plus the actions aspect's `CopyPasteHandlers` and `PasteWrappers` roots. Reach for this skill when a substitution, side transform, completion replacement, or `add new initialized(...)` should preserve fields from the node it is replacing, or when defaults set in a constructor are not enough.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[678,679],{"name":661,"slug":662,"type":15},{"name":667,"slug":668,"type":15},"2026-07-17T06:04:48.066901",{"slug":682,"name":682,"fn":683,"description":684,"org":685,"tags":686,"stars":669,"repoUrl":670,"updatedAt":689},"mps-aspect-behavior","define and edit MPS concept behavior","Use when defining or editing MPS `ConceptBehavior` — per-concept methods (non-virtual \u002F virtual \u002F abstract \u002F static \u002F virtual static), constructors, virtual dispatch (MRO), super and interface-default calls (`super\u003CInterface>.method`), overriding methods from `lang.core.behavior` interfaces such as `ScopeProvider.getScope` \u002F `INamedConcept.getName` \u002F `BaseConcept.getPresentation`, calling sibling methods (`LocalBehaviorMethodCall`) and behavior methods from other aspects via `node.method(...)`. Reach for this skill whenever the task involves authoring or modifying `\u003Clang>\u002FlanguageModels\u002Fbehavior.mps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[687,688],{"name":661,"slug":662,"type":15},{"name":667,"slug":668,"type":15},"2026-07-13T06:45:21.757084",{"slug":691,"name":691,"fn":692,"description":693,"org":694,"tags":695,"stars":669,"repoUrl":670,"updatedAt":700},"mps-aspect-constraints","define JetBrains MPS language constraints","Use when defining or editing MPS language constraints — property validators \u002F setters \u002F getters, referent search scopes (imperative or inherited via `ScopeProvider.getScope`), `referentSetHandler` side effects, default-scope blocks, `canBeChild` \u002F `canBeParent` \u002F `canBeAncestor` \u002F `canBeRoot` placement rules, `defaultConcreteConcept` for abstract concepts, `set \u003Cread-only>` and `{name}` aliasing, and scope helpers (`SimpleRoleScope`, `ListScope`, `CompositeScope`, `HidingByNameScope`). Reach for this skill whenever the task involves authoring or modifying `\u003Clang>\u002FlanguageModels\u002Fconstraints.mps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[696,697],{"name":661,"slug":662,"type":15},{"name":698,"slug":699,"type":15},"Code Analysis","code-analysis","2026-07-23T05:41:33.639365",{"slug":702,"name":702,"fn":703,"description":704,"org":705,"tags":706,"stars":669,"repoUrl":670,"updatedAt":710},"mps-aspect-dataflow","define and debug MPS dataflow builders","Use when defining or debugging MPS dataflow builders for a concept — control\u002Fdata flow declarations that drive reachability analysis and variable-use checking. Covers DataFlowBuilderDeclaration, BuilderBlock, emit instructions (code for, jump, ifjump, label, read, write, ret, mayBeUnreachable), positions (AfterPosition, BeforePosition, LabelPosition), the jetbrains.mps.lang.dataFlow language, the NodeParameter implicit, BL+smodel usage inside builder bodies, and IBuilderMode for advanced analyses such as nullable\u002Fnon-null tracking.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[707],{"name":708,"slug":709,"type":15},"Data Analysis","data-analysis","2026-07-13T06:45:19.114674",{"slug":712,"name":712,"fn":713,"description":714,"org":715,"tags":716,"stars":669,"repoUrl":670,"updatedAt":723},"mps-aspect-editor","define MPS editor layouts","Use when creating or changing MPS editor definitions — the overall workflow from scaffolding a `ConceptEditorDeclaration` through componentizing reusable `EditorComponentDeclaration`s, refining cell models and cell layouts, applying style sheets and indent-layout style items, wiring smart references, leveraging inheritance via super-concepts and interfaces, inspecting (`print_node_json`, `show_node_representation`) and validating (`check_root_node_problems`). Covers `jetbrains.mps.lang.editor` cell models (`CellModel_RefNode`\u002F`CellModel_RefNodeList`\u002F`CellModel_RefCell`\u002F`CellModel_Property`\u002F`CellModel_Constant`), layout choices, and JSON blueprints for common editor shapes. For the non-layout side (action maps, keymaps, transformation\u002Fsubstitute menus) use `mps-aspect-editor-menus-and-keymaps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[717,720],{"name":718,"slug":719,"type":15},"Design","design",{"name":721,"slug":722,"type":15},"UI Components","ui-components","2026-07-23T05:41:56.638151",{"slug":725,"name":725,"fn":726,"description":727,"org":728,"tags":729,"stars":669,"repoUrl":670,"updatedAt":732},"mps-aspect-editor-menus-and-keymaps","author MPS editor menus and keymaps","Use when authoring the **non-layout** parts of the MPS editor aspect — what happens when the user types, presses a key, triggers completion, pastes, or invokes a context action. Covers action maps (`CellActionMapDeclaration`), cell keymaps (`CellKeyMapDeclaration`), transformation menus (`TransformationMenu_Default` \u002F `_Named` \u002F `_Contribution`), substitute menus (`SubstituteMenu_Default` \u002F `SubstituteMenu` \u002F contributions), side transforms (LEFT\u002FRIGHT), legacy cell menus, paste wrappers and copy-paste handlers (in the actions language), completion styling, reference presentation, two-step deletion, and the editor selection API. Trigger terms: `actionMap`, `keyMap`, `delete_action_id`, `transformationMenu`, `substituteMenu`, `Ctrl+Space`, `Ctrl+Alt+B`, side transform, paste wrapper, completion styling, `PasteWrappers`, `CopyPasteHandlers`. For the **layout** side (cells, layouts, style sheets) use `mps-aspect-editor` instead.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[730,731],{"name":667,"slug":668,"type":15},{"name":721,"slug":722,"type":15},"2026-07-23T05:41:49.666535",{"slug":734,"name":734,"fn":735,"description":736,"org":737,"tags":738,"stars":669,"repoUrl":670,"updatedAt":741},"mps-aspect-generation-plan","modify MPS generation plans","Use when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches, IncludePlan composition, conditional PlanContribution activation, ParameterEquals\u002FConceptListSelector fork selectors, and InitModelAttributes for targetFacet routing. Apply when working with @genplan models, the jetbrains.mps.lang.generator.plan language, attaching plans via DevKits or the Custom generation facet, or debugging cross-model mapping label resolution.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[739,740],{"name":661,"slug":662,"type":15},{"name":667,"slug":668,"type":15},"2026-07-13T06:44:59.507855",{"slug":743,"name":743,"fn":744,"description":745,"org":746,"tags":747,"stars":669,"repoUrl":670,"updatedAt":751},"mps-aspect-generator","define JetBrains MPS generator rules","Use when defining or modifying MPS generators — author a generator module, add or edit root\u002Freduction\u002Fweaving\u002Fpattern mapping rules, attach template macros ($COPY_SRC, $LOOP, $IF, $PROPERTY, $REF, $SWITCH, $MAP_SRC, $WEAVE, $INSERT, $LABEL, $TRACE, $VAR), wire mapping labels, build template switches, write pre\u002Fpost mapping scripts, navigate `genContext`, or debug \"rule didn't fire\", missing references, empty output, infinite reduction loops, and generated-Java compile failures.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[748,749,750],{"name":661,"slug":662,"type":15},{"name":698,"slug":699,"type":15},{"name":667,"slug":668,"type":15},"2026-07-17T06:06:58.042999",{"slug":753,"name":753,"fn":754,"description":755,"org":756,"tags":757,"stars":669,"repoUrl":670,"updatedAt":760},"mps-aspect-intentions","define and edit MPS intentions","Use when defining or editing MPS intentions (the Alt+Enter context-action aspect) — adding `IntentionDeclaration` roots, parameterized or surround-with variants, description\u002FisApplicable\u002Fexecute blocks, child-filter functions, factory-initialized AST splicing, or debugging why an intention is not offered. Lives in the language's `intentions` model and uses `jetbrains.mps.lang.intentions`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[758,759],{"name":661,"slug":662,"type":15},{"name":667,"slug":668,"type":15},"2026-07-23T05:41:48.692899",{"slug":762,"name":762,"fn":763,"description":764,"org":765,"tags":766,"stars":669,"repoUrl":670,"updatedAt":771},"mps-aspect-migrations","author and debug MPS migration scripts","Use when authoring or debugging MPS migration scripts that upgrade user models after a language definition changes — covers jetbrains.mps.lang.migration (MigrationScript class-based, PureMigrationScript declarative, MoveConcept\u002FMoveContainmentLink\u002FMoveReferenceLink\u002FMoveProperty, ordering via OrderDependency, data exchange via putData\u002FgetData, RefactoringLog, ConceptMigrationReference) and jetbrains.mps.lang.script Enhancement Scripts (MigrationScript with MigrationScriptPart_Instance, ExtractInterfaceMigration, FactoryMigrationScriptPart, CommentMigrationScriptPart) — when a model needs version-gated upgrade, concept rename or removal, link or property rename, instance-level transformation, or composition of migration steps.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[767,770],{"name":768,"slug":769,"type":15},"Debugging","debugging",{"name":23,"slug":24,"type":15},"2026-07-13T06:45:20.372122",{"slug":773,"name":773,"fn":774,"description":775,"org":776,"tags":777,"stars":669,"repoUrl":670,"updatedAt":781},"mps-aspect-structure-concepts","define concepts in MPS structure aspect","Define concepts, interface concepts, enumerations, and constrained data types in an MPS language's `structure` aspect. Covers smart-reference detection, alias rules, cardinality, INamedConcept usage, bulk creation, and the full `mps_mcp_alter_structure` \u002F `mps_mcp_query_structure` reference. Use when authoring or modifying a language's structure model.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[778],{"name":779,"slug":780,"type":15},"Data Modeling","data-modeling","2026-07-23T05:41:30.705975",188,{"items":784,"total":898},[785,804,819,833,848,867,884],{"slug":786,"name":786,"fn":787,"description":788,"org":789,"tags":790,"stars":25,"repoUrl":26,"updatedAt":803},"algorithmic-art","create generative art with p5.js","Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[791,794,797,800],{"name":792,"slug":793,"type":15},"Creative","creative",{"name":795,"slug":796,"type":15},"Generative Art","generative-art",{"name":798,"slug":799,"type":15},"Graphics","graphics",{"name":801,"slug":802,"type":15},"JavaScript","javascript","2026-07-13T06:41:35.540127",{"slug":805,"name":805,"fn":806,"description":807,"org":808,"tags":809,"stars":25,"repoUrl":26,"updatedAt":818},"antfu","configure JavaScript projects with Anthony Fu's tools","Anthony Fu's opinionated tooling and conventions for JavaScript\u002FTypeScript projects. Use when setting up new projects, configuring ESLint\u002FPrettier alternatives, monorepos, library publishing, or when the user mentions Anthony Fu's preferences.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[810,813,814,815],{"name":811,"slug":812,"type":15},"Best Practices","best-practices",{"name":667,"slug":668,"type":15},{"name":801,"slug":802,"type":15},{"name":816,"slug":817,"type":15},"TypeScript","typescript","2026-07-13T06:43:13.153309",{"slug":820,"name":820,"fn":821,"description":822,"org":823,"tags":824,"stars":25,"repoUrl":26,"updatedAt":832},"brand-guidelines","apply Anthropic brand guidelines","Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[825,828,829],{"name":826,"slug":827,"type":15},"Branding","branding",{"name":718,"slug":719,"type":15},{"name":830,"slug":831,"type":15},"Typography","typography","2026-07-13T06:43:06.077629",{"slug":834,"name":834,"fn":835,"description":836,"org":837,"tags":838,"stars":25,"repoUrl":26,"updatedAt":847},"canvas-design","create visual art and design assets","Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[839,840,841,844],{"name":792,"slug":793,"type":15},{"name":718,"slug":719,"type":15},{"name":842,"slug":843,"type":15},"Images","images",{"name":845,"slug":846,"type":15},"PDF","pdf","2026-07-13T06:39:58.803113",{"slug":849,"name":849,"fn":850,"description":851,"org":852,"tags":853,"stars":25,"repoUrl":26,"updatedAt":866},"ci-cd-containerization-advisor","design CI\u002FCD pipelines for Kotlin applications","Design reproducible build, image, and deployment pipelines for Kotlin plus Spring applications, including CI verification, layered containers, rollout safety, and deployment-time migration coordination. Use when creating or improving Dockerfiles, CI workflows, image hardening, Kubernetes manifests, release gates, or deployment strategies for Spring Boot services, especially where build reproducibility and operational safety matter.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[854,857,860,863,864,865],{"name":855,"slug":856,"type":15},"CI\u002FCD","ci-cd",{"name":858,"slug":859,"type":15},"Containers","containers",{"name":861,"slug":862,"type":15},"Deployment","deployment",{"name":667,"slug":668,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:41:47.83899",{"slug":868,"name":868,"fn":869,"description":870,"org":871,"tags":872,"stars":25,"repoUrl":26,"updatedAt":883},"cloudflare-deploy","deploy applications to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[873,876,879,882],{"name":874,"slug":875,"type":15},"Cloudflare","cloudflare",{"name":877,"slug":878,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":880,"slug":881,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":861,"slug":862,"type":15},"2026-07-17T06:04:42.853896",{"slug":885,"name":885,"fn":886,"description":887,"org":888,"tags":889,"stars":25,"repoUrl":26,"updatedAt":897},"compose-ui-control","interact with Compose Desktop applications","Control a running Compose Desktop application via HTTP. Use when you need to interact with UI elements, click buttons, enter text, wait for elements to appear, or capture screenshots in a Compose Desktop app that has compose-ui-test-server enabled.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[890,893,896],{"name":891,"slug":892,"type":15},"Automation","automation",{"name":894,"slug":895,"type":15},"Desktop","desktop",{"name":721,"slug":722,"type":15},"2026-07-13T06:40:38.798626",128]