kotlin-footguns
228 documented traps for Kotlin, Compose Multiplatform and desktop JVM development.
Install
/plugin marketplace add maxrave-dev/kotlin-footguns
/plugin install kotlin-footguns@maxrave
npx skills add maxrave-dev/kotlin-footguns -a claude-code
npx skills add maxrave-dev/kotlin-footguns -a claude-code -g
Or copy the skill folder into .claude/skills/ (project) or ~/.claude/skills/ (all projects).
npx skills add maxrave-dev/kotlin-footguns -a codex
npx skills add maxrave-dev/kotlin-footguns -a codex -g
Or copy the skill folder into .agents/skills/ (project) or ~/.agents/skills/ (all projects).
npx skills add maxrave-dev/kotlin-footguns -a cursor
npx skills add maxrave-dev/kotlin-footguns -a cursor -g
Or copy the skill folder into .agents/skills/ (project) or ~/.cursor/skills/ (all projects).
npx skills add maxrave-dev/kotlin-footguns -a windsurf
npx skills add maxrave-dev/kotlin-footguns -a windsurf -g
Or copy the skill folder into .windsurf/skills/ (project) or ~/.codeium/windsurf/skills/ (all projects).
npx skills add maxrave-dev/kotlin-footguns -a droid
npx skills add maxrave-dev/kotlin-footguns -a droid -g
Or copy the skill folder into .agents/skills/ (project) or ~/.factory/skills/ (all projects).
Install as a Claude Code plugin, or copy the files into your agent's skills folder.
When to use
Use it on Kotlin and Compose Multiplatform projects, especially desktop, to stop an agent repeating the mistakes that already cost the author time.
Kotlin Footguns is a list of 228 traps in Kotlin, Compose Multiplatform and desktop JVM development. The author maintains SimpMusic, a cross-platform music app, and mined every lesson from that production codebase instead of writing them from documentation.
The traps are grouped into ten area skills, each an index, plus a scanner that checks a change against them. Each trap is a standalone markdown file the agent opens only when the work matches, and the whole set runs past 28,000 lines. It works in Claude Code and other agents, and a human can read it too.
Related skills
-
rea
Lets your agent reverse engineer an app from the outside, down to native binaries, and then build its own version.
-
superpowers
A set of development habits for your agent: test first, debug systematically, and plan before you code.
-
skills
The skills Matt Pocock uses in his own day-to-day engineering work.
-
ECC
A ready-made setup for coding agents that adds skills, persistent memory and security checks.