init-kmp
v1.0.1
Published
A Claude Code skill that scaffolds production-ready Kotlin Multiplatform + Compose Multiplatform projects, or audits an existing one against 8 architecture standards.
Downloads
300
Maintainers
Readme
init-kmp
A Claude Code skill that scaffolds production-ready Kotlin Multiplatform + Compose Multiplatform projects (Room, Koin, type-safe navigation, virtual-time tests) — or audits an existing one against the same 8 architecture standards.
Grounded in real incidents from building a real 6-plan KMP+CMP app, not
textbook clean-architecture theory. See reference/gotchas.md.
Prerequisites
- macOS required for the iOS half (Xcode build/verify gate); Android-only scaffolding and audits work on any OS.
- JDK 17+ to launch Gradle — the daemon auto-provisions JDK 21 itself via
the pinned
gradle-daemon-jvm.properties, which needs network access on first build. - Android SDK with
ANDROID_HOMEset (or alocal.propertiesyou create yourself / your IDE creates for you — the scaffolded project ships without one on purpose). - Xcode 26+ for the xcode26 toolchain line; an older Xcode install works
fine with the
oldertoolchain line instead. - Python 3 to run
scripts/scaffold.pyandscripts/verify.py.
Install
Claude Code:
npx init-kmpInstalls to ~/.claude/skills/init-kmp/ by default. Or copy this folder
there yourself.
Cursor / Codex CLI / GitHub Copilot / Windsurf/Devin / OpenCode (all
confirmed to auto-read a root-level AGENTS.md):
npx init-kmp --target=.agent-skills/init-kmp
echo "See .agent-skills/init-kmp/AGENTS.md for the init-kmp skill." >> AGENTS.mdCline (reads .clinerules/, not root AGENTS.md):
npx init-kmp --target=.agent-skills/init-kmp
mkdir -p .clinerules && echo "See .agent-skills/init-kmp/AGENTS.md for the init-kmp skill." > .clinerules/init-kmp.mdFull per-agent rationale in the project README.
Use
/init-kmp new(or just/init-kmpin an empty directory) — scaffold a new project./init-kmp audit(or just/init-kmpin an existing Gradle project) — score the project against the 8 standards.
Not using Claude Code? See AGENTS.md for the same
instructions in agent-agnostic form.
Toolchain (as of 2026-07)
Two verified lines — see reference/toolchain.md for the full version
tables and the research behind each pairing:
- Xcode 26+: Kotlin 2.3.21 / Compose Multiplatform 1.11.1 / AGP 9.0.1 / KSP 2.3.9
- Older Xcode: Kotlin 2.3.0 / Compose Multiplatform 1.10.3 / AGP 9.0.1 / KSP 2.3.6
License
MIT — see LICENSE.
