init-android
v1.0.1
Published
A Claude Code skill that scaffolds production-ready, multi-module Android projects, or audits an existing one against 7 architecture standards.
Maintainers
Readme
init-android
A Claude Code skill that scaffolds production-ready, multi-module Android projects (Hilt, Room, MockK, type-safe Compose Navigation) — or audits an existing one against the same 7 architecture standards.
Grounded in real bugs found while building and compiling this skill's own
reference project — not textbook clean-architecture theory. See
reference/gotchas.md.
Prerequisites
- JDK 17+ to launch Gradle.
- Android SDK with
ANDROID_HOMEset (or alocal.propertiesyou create yourself / your IDE creates for you — the scaffolded project ships without one on purpose). - Python 3 to run
scripts/scaffold.pyandscripts/verify.py.
Install
Claude Code:
npx init-androidInstalls to ~/.claude/skills/init-android/ 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-android --target=.agent-skills/init-android
echo "See .agent-skills/init-android/AGENTS.md for the init-android skill." >> AGENTS.mdCline (reads .clinerules/, not root AGENTS.md):
npx init-android --target=.agent-skills/init-android
mkdir -p .clinerules && echo "See .agent-skills/init-android/AGENTS.md for the init-android skill." > .clinerules/init-android.mdFull per-agent rationale in the project README.
Use
/init-android new(or just/init-androidin an empty directory) — scaffold a new project./init-android audit(or just/init-androidin an existing Gradle project) — score the project against the 7 standards.
Not using Claude Code? See AGENTS.md for the same
instructions in agent-agnostic form.
Toolchain (as of 2026-07)
One verified line — see reference/toolchain.md for the full version
table and the research behind it: AGP 9.2.1 / Kotlin 2.3.21 / KSP 2.3.9 /
compileSdk 37 / Hilt 2.60.1 / Room 2.8.4 / Compose BOM 2026.06.01.
Optional add-ons
Firebase (auth/firestore/analytics/crashlytics), a Retrofit-based remote
API client, Google Play Billing, and AdMob — each independently verified to
compile. See reference/addons.md.
License
MIT — see LICENSE.
