Compose Kotlin Agent Skills

compose-kotlin-agent-skills

Make your AI coding agent actually understand Jetpack Compose & Kotlin — on Android, Kotlin Multiplatform, and Compose Multiplatform. Strict MVI · Kotlin 2.x K2 · Compose 2026 · CI-validated · 27 agents supported.

---

Quick install

Agent	Command
Cursor	git clone https://github.com/haidrrrry/compose-kotlin-agent-skills.git .cursor/skills/compose-kotlin-agent-skills
Claude Code	git clone https://github.com/haidrrrry/compose-kotlin-agent-skills.git ~/.claude/skills/compose-kotlin-agent-skills
Codex CLI	git clone https://github.com/haidrrrry/compose-kotlin-agent-skills.git → add block to root AGENTS.md (guide)
Gemini CLI	git clone https://github.com/haidrrrry/compose-kotlin-agent-skills.git → add block to GEMINI.md (guide)
GitHub Copilot	git clone https://github.com/haidrrrry/compose-kotlin-agent-skills.git .github/skills/compose-kotlin-agent-skills (guide)

Per-agent details → Setup · All 27 agents → agents/README.md

The problem

AI coding agents generate Kotlin/Compose code that compiles but gets the details wrong:

• _state.value = … instead of atomic _state.update { } — race conditions
• collectAsState() instead of collectAsStateWithLifecycle() — battery drain
• Hardcoded UI strings instead of stringResource(R.string.…) — broken localisation
• LazyColumn without key + contentType — broken scroll, recomposition storms
• GlobalScope.launch { } inside ViewModels — leaks
• mutableStateListOf in ViewModel — survives config change wrong

This skill kit fixes that by giving your AI agent:

1. A primary SKILL.md with the 2026 toolchain, strict MVI guardrails, and a dedicated banned-antipatterns reference.
2. 3 modular sub-skills (architecture, Compose, testing) loaded on demand — Compose sub-skill includes REVIEW MODE for screen audits.
3. 20 reference modules (00–19) covering every major Android/Kotlin topic.
4. 27 per-agent install guides so Cursor, Claude Code, Codex, Copilot, Gemini, etc. each load it correctly.
5. CI-validated — every SKILL.md is frontmatter-linted, link-checked, and registered in api/skills.lock on every push.

---

What this is NOT

Wrong guess	Reality
Android library / Gradle dependency	No — nothing to implementation(...). Pure markdown.
Alexa / Bixby / voice-assistant "skill"	No — not a voice platform. The word "skill" here = agentskills.io format.
On-device LLM runtime / tool-calling SDK	No — no model inference, no agent framework.
Compose UI library (coachmarks, theming, charts)	No — we don't ship Composables; we teach how to write them.
Backend or REST API	No — markdown files plus a Python validator.

TL;DR: clone this repo into your agent's skills folder. The agent reads it before writing Kotlin. That's it.

---

What changes when you install it