kotlin-footguns publishes 224 coding agent skills from a production Kotlin app

A GitHub repository called kotlin-footguns collects 224 agent skills for Kotlin, Compose Multiplatform and the desktop JVM in a single Markdown corpus, all extracted from the maintainer's released music application SimpMusic. The repository was created on 20 August 2026 and has reached 443 stars in 27 days.

What is in the repository

The repository holds 27,000 lines across 224 files, grouped into 14 sections labelled A to N. The sections cover native code on the desktop JVM, desktop packaging and CI, Multiplatform architecture, media playback engines, databases and SQL, Compose theming, Compose components, screens and navigation, reactive state, repository patterns, background work, remote API consumption, Kotlin utilities, and engineering methods. Two later batches labelled delta-6 and delta-7 add more recent lessons. Each skill file is a single failure mode with the fix and a verification command the agent is expected to run.

The stated method is that the lessons come from real failures during the production life of SimpMusic, the maintainer's cross-platform music app, which has been released to Android, Windows, macOS and Linux users since April 2023 and currently has 11,272 stars on GitHub. The repository README says the lessons are taken from that codebase rather than from documentation, and that later batches required executing every verification command against the source tree before release.

Who it is for and how it is installed

The skills are formatted for Claude Code, Cursor, Codex, Copilot, Windsurf, Gemini and similar coding agents that support a public skill catalogue. Each skill is in its own Markdown file with a Traps section that lists the specific ways the standard technique fails on desktop JVM or in Compose, followed by the verification commands. The files are also readable by a human as a reference for the same problems.

The corpus is under GPL-3.0, which matches the licence of the SimpMusic source it was taken from. A team pulling one skill into a proprietary project needs to weigh that licence choice: the skills are Markdown, not linked code, but the licence terms still apply to them.

What this fixes for an agent working on Kotlin

Kotlin, Compose Multiplatform and the desktop JVM are three of the areas where a coding agent guessing from public tutorials produces plausible code that runs on Android and breaks on macOS, or compiles on JVM and hangs on the packaging step. The problem for a maintainer is the loop where the model writes the same wrong pattern in a different shape every time. A rule set that captures the wrong patterns and lists the tests that catch them changes that loop into a check the agent runs before it commits.

The value depends on whether the failures a specific project sees overlap with SimpMusic's failures. A music app touches native audio bindings, low-level media playback, cross-platform packaging and background work heavily, and a team writing a business tool in Compose Multiplatform will find fewer of those sections relevant. Adopting only the relevant sections is more honest than pulling every skill.

What makes this worth attention is that the traction number is real and the source is verifiable: 443 stars in 27 days on a domain-specific rule set, taken from a codebase with 11,272 stars, is a stronger signal than a general-purpose "agent skills" repository with the same star count. A team on Kotlin needs only one clone and one skill install to test whether it fits.

Source

maxrave-dev/kotlin-footguns on GitHub, 20 August 2026 onward. Source project: maxrave-dev/SimpMusic.