haidrrrry/compose-kotlin-agent-skills

compose-kotlin-agent-skills is a pack of markdown documents that you drop into the skills folder of an AI coding agent so that the agent writes better Jetpack Compose and Kotlin code. It is not a library you install with Gradle, not an Android app, not a voice-assistant skill, and not an on-device LLM runtime. It is pure markdown plus a Python validator. The agent reads it before generating code for your project. The README opens with a list of mistakes that AI agents tend to make in Kotlin and Compose: setting StateFlow with _state.value instead of the atomic update block, calling collectAsState instead of collectAsStateWithLifecycle, hardcoding UI strings instead of using stringResource, leaving LazyColumn without stable keys, launching from GlobalScope inside ViewModels, and so on. The skill kit exists to push the agent away from those choices. The content is organised into layers. A root SKILL.md sets the toolchain (Kotlin 2.x with the K2 compiler, AGP 9, Compose BOM 2026, Navigation 3) and lists banned antipatterns. Three sub-skills sit under skills/ for architecture, Compose, and testing, loaded only when the agent is doing that kind of work. Beneath those live thirteen reference documents covering architecture, Compose UI, animations, coroutines and flow, Hilt dependency injection, Room database, navigation, Kotlin Multiplatform and Compose Multiplatform, networking, performance, testing, camera and ML Kit, and a release checklist. The project targets Android, Kotlin Multiplatform, and Compose Multiplatform code, but the documents themselves are read on any operating system where the agent runs. There are 27 separate per-agent install guides under agents/ for Cursor, Claude Code, Codex, Copilot, Gemini, and others. Every SKILL.md file is checked by a GitHub Actions workflow called skill-lint that validates the frontmatter, checks links, and registers the file in api/skills.lock on every push. The license is MIT and setup is described as a two-minute clone-into-skills-folder step.