android-project-scaffold

Scaffolds a spec-conforming native Android project with Gradle Kotlin DSL, Compose, and CI.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/nolte/claude-android-engineering --skill android-project-scaffold-nolte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: android-project-scaffold
Source: https://github.com/nolte/claude-android-engineering/tree/main/skills/android-project-scaffold
Command: npx skills add https://github.com/nolte/claude-android-engineering --skill android-project-scaffold-nolte

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a new native Android project involves dozens of interlocking decisions — Gradle version catalogs, AGP 9 built-in Kotlin, KSP, Compose BOM, bilingual resources, security baselines, test suites, and CI wiring — and getting any of them wrong produces a project that fails to build or violates platform requirements. This Skill generates the entire project tree against an explicit spec corpus and verifies it with a green ./gradlew build. ## Core Features & Use Cases - Spec-grounded scaffolding: Generates a single-module :app project (or a modularized layout when a concrete trigger exists) with a version catalog, plugins-only root build script, JDK 17 toolchain, Compose BOM, KSP, and Spotless/ktlint formatting. - Built-in baselines: Ships bilingual English/German resources with localeFilters, an L1 security manifest with explicit android:exported, a shrunk release build with log stripping, StrictMode in debug, a logging facade, and a minimal JVM test suite. - CI and verification: Writes a Taskfile and GitHub Actions workflow, then runs ./gradlew build and task check, reporting every failure with a proposed fix instead of silently patching. - Use Case: Ask to create a new Android app named Notensammler with package de.nolte.notensammler; the Skill confirms parameters, presents the file plan for approval, writes the scaffold, and verifies the build is green — with resume support if interrupted. ## Quick Start Ask the assistant to scaffold a new Android app project with your chosen app name, package, and minSdk, then approve the parameter and file-plan gates it presents.

Frequently Asked Questions about android-project-scaffold

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new Android app project with Kotlin and Jetpack Compose?

Invoke the skill with your app name, package, and minSdk; it confirms parameters, presents a file plan for approval, then writes a single-module :app project with a Gradle version catalog, Compose BOM, KSP, and JDK 17 toolchain. It finishes by running ./gradlew build and task check to verify everything is green.

What Gradle setup does an AGP 9 Android project need?

AGP 9 ships built-in Kotlin, so org.jetbrains.kotlin.android must not be applied; the Compose compiler plugin org.jetbrains.kotlin.plugin.compose references the Kotlin version. The scaffold uses a plugins-only root build script, a libs.versions.toml catalog, KSP instead of kapt, and kotlin { jvmToolchain(17) }.

Does the scaffold support multi-module Android projects?

Yes, but only when the operator names a concrete modularization trigger such as cross-app code reuse or team-scale ownership. It then generates an :app/:feature/:core layout with a build-logic included build of convention plugins, and records the trigger in docs/decisions.md.

Can I use this skill to build Compose UI screens in an existing app?

No, this skill only scaffolds new projects from scratch. For authoring or restyling Compose UI in an existing app use android-compose-ui, and for debugging an existing build or runtime defect use android-debugging.

What happens when the scaffolded project fails to build?

The skill reports the full failing task output, diagnoses the cause against the blueprint (for example kapt residue or a missing android:exported), and proposes a specific fix. It applies the fix only after operator approval and re-runs the verify sequence; a red build is never silently patched.

Does the Android scaffold include CI and localization from the start?

Yes, it writes a GitHub Actions workflow and Taskfile running single-variant unit tests plus lint with Gradle caching, and ships bilingual English source strings with German values-b+de translations, localeFilters, generateLocaleConfig, and a language picker.