claude-android-ninja
Build and migrate Android apps with Kotlin, Jetpack Compose, MVVM, Hilt, Room 3 (KSP, SQLiteDriver, Flow/suspend DAOs), Navigation3, and multi-module Gradle. Use for new projects or modules, Compose screens and ViewModels, Room 3 and RemoteMediator, API 37 / targetSdk migration, Play Integrity client wiring, offline-first sync, and version-catalog alignment. Not for iOS, Flutter, React Native, KMP-only shared code without an Android app module, or backend-only APIs with no Android client.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/drjacky--claude-android-ninja)HTML
<a href="/listings/drjacky--claude-android-ninja"><img src="/api/listings/drjacky--claude-android-ninja/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Agent entry point after install: [`SKILL.md`](SKILL.md) (Quick Reference table; extended routing in [`references/workflows.md`](references/workflows.md)). Open `references/` files only for the task at hand. Format spec: [agentskills.io](https://agentskills.io/home).
For AI agents
This skill uses the open [Agent Skills](https://agentskills.io/home) format: a folder named `claude-android-ninja/` with `SKILL.md`, `references/`, and `assets/`. Agents load skill metadata at session start; route Android work through [`SKILL.md`](SKILL.md) and open reference files only when needed.
Paths below are each agent's **primary** install locations. Many agents also scan shared fallbacks such as `.agents/skills/` or `.claude/skills/`.
| Agent | Project path | Global path | Docs | |----------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|------------------------------------------------------|---------------------------------------------------------------------------------------------------------| | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/claude-color.svg" width="18" height="18" align="absmiddle" alt=""> [Claude Code](https://code.claude.com/docs/en/skills) | `.claude/skills/claude-android-ninja/` | `~/.claude/skills/claude-android-ninja/` | [Skills](https://code.claude.com/docs/en/skills) | | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/cline.svg" width="18" height="18" align="absmiddle" alt=""> [Cline](https://docs.cline.bot/customization/skills) | `.cline/skills/claude-android-ninja/` | `~/.cline/skills/claude-android-ninja/` | [Skills](https://docs.cline.bot/customization/skills) | | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/codex-color.svg" width="18" height="18" align="absmiddle" alt=""> [Codex](https://developers.openai.com/codex/skills) | `.agents/skills/claude-android-ninja/` (repo / CWD) | `~/.codex/skills/claude-android-ninja/` | [Agent Skills](https://developers.openai.com/codex/skills) | | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/cursor.svg" width="18" height="18" align="absmiddle" alt=""> [Cursor](https://cursor.com/docs/context/skills) | `.cursor/skills/claude-android-ninja/` | `~/.cursor/skills/claude-android-ninja/` | [Agent Skills](https://cursor.com/docs/context/skills) | | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/gemini-color.svg" width="18" height="18" align="absmiddle" alt=""> [Gemini CLI](https://geminicli.com/docs/cli/skills/) | `.gemini/skills/claude-android-ninja/` | `~/.gemini/skills/claude-android-ninja/` | [Agent Skills](https://geminicli.com/docs/cli/skills/) |
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 120 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: claude-android-ninja
- description: Build and migrate Android apps with Kotlin, Jetpack Compose, MVVM, Hilt, Room 3 (KSP, SQLiteDriver, Flow/suspend DAOs), Navigation3, and multi-module Gradle. Use for new projects or modules, Compose screens and ViewModels, Room 3 and RemoteMediator, API 37 / targetSdk migration, Play Integrity client wiring, offline-first sync, and version-catalog alignment. Not for iOS, Flutter, React Native, KMP-only shared code without an Android app module, or backend-only APIs with no Android client.
- compatibility: JDK 17+. Android Studio with Android SDK installed. Network access for Gradle dependency downloads. Version pins in assets/templates follow the repo catalog; align AGP/Kotlin/KSP with the user project before applying upgrades.
- license: Apache-2.0
- metadata:
- author: DrJacky
- version: "1.0.0"
- documentation: https://github.com/Drjacky/claude-android-ninja
- tags: android, kotlin, compose, mvvm, hilt, room, room3, datastore, paging, gradle, mobile
- ---
- # Android Kotlin Compose Development
- **Context ladder (smaller load first; full references stay complete):**
- 1. This file (`SKILL.md`) - routing, stop rules, examples.
- 2. `references/*-quick.md` when listed below - required/forbidden + section links (~40 lines).
- 3. One target section in the full `references/*.md` - code samples and checklists only.
- 4. [INDEX-sections.md](references/INDEX-sections.md) - anchor dump only when quick routing is insufficient.
- Forbidden: load [INDEX-sections.md](references/INDEX-sections.md) or an entire multi-thousand-line reference when one section or a quick file covers the task.
- Route tasks through the Quick Reference table. When no row matches, or the task needs greenfield bootstrap: [workflows.md](references/workflows.md). Full file list: [INDEX.md](references/INDEX.md).
- **Required:**
- - **Existing project:** read `settings.gradle.kts`, `gradle/libs.versions.toml`, and the `app` module build file before copying from `assets/` - [dependencies.md](references/dependencies.md#existing-project-brownfield), [modularization.md](references/modularization.md#existing-project-alignment). Stack migrations: [migration.md](references/migration.md).
- - **Greenfield:** [workflows.md](references/workflows.md) → "Creating a new project?"
- - After module, DI, navigation, Room schema, or AGP/Kotlin/KSP changes: `./gradlew help` then `:app:assembleDebug` (use the real app module name) - [gradle-setup.md](references/gradle-setup.md#verify-after-toolchain-or-module-changes).
- **Outside-repo stop rules (do not substitute repo edits):** Play upload, tracks, rollout, `versionCode` - [android-ci-cd.md](references/android-ci-cd.md); Play Integrity prerequisites (Console/Cloud setup) - [android-security-quick.md](references/android-security-quick.md); production `adb install` / `pm clear` - [testing.md](references/testing.md#agent-automation-adb-and-uiautomator).
- ## Quick Reference
- Rare or niche topics not listed here are in [INDEX.md](references/INDEX.md) (complete file list).
- | Task | Reference |
- |----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
- | Task not in table, greenfield bootstrap, multi-topic setup | [workflows.md](references/workflows.md) |
- | Optional Android CLI project discovery, Studio checks, preview, and test-device inspection | [workflows.md](references/workflows.md) ("Using the optional Android CLI for agent workflows?") |
- | Full index of all reference files | [INDEX.md](references/INDEX.md) |
- | Version catalog, pins, alpha policy, brownfield alignment | [dependencies.md](references/dependencies.md#version-strategy) |
- | Adding or updating dependencies (catalog aliases) | [dependencies.md](references/dependencies.md) |
- | Multi-module dependencies | [dependencies.md](references/dependencies.md) |
- | Project structure and modules | [modularization.md](references/modularization.md) |
- | MVVM layers, repositories, DI | [architecture.md](references/architecture.md) |
- | Retrofit / OkHttp, NetworkModule, nullable DTOs, AuthInterceptor | [architecture.md](references/architecture.md#network-layer-setup-corenetwork); [dependencies.md](references/dependencies.md) |
- | DataStore (preferences, typed), Room vs DataStore rules | [architecture.md](references/architecture.md#datastore-preferences--typed) |
- | Code formatting (Spotless, `spotlessCheck` / `spotlessApply`) | [assets/convention/QUICK_REFERENCE.md](assets/convention/QUICK_REFERENCE.md#spotless-plugin); [gradle-setup.md](references/gradle-setup.md) |
- | Compose patterns, motion, animation, modifiers, stability | [compose-patterns-quick.md](references/compose-patterns-quick.md) |
- | Paging 3 + Room + network (`RemoteMediator`, remote keys, `initialize`) | [compose-patterns.md](references/compose-patterns.md#offline-first-paging-and-remotemediator) |
- | Accessibility, TalkBack, label copy, live regions, Espresso a11y | [android-accessibility-quick.md](references/android-accessibility-quick.md) |
- | Notifications, foreground services, MediaStyle, PiP, sharesheet | [android-notifications.md](references/android-notifications.md) |
- | Media: API 37 background playback, Media3, picking, FileProvider, sharesheet | [android-media.md](references/android-media.md) |
- | Data sync and offline-first patterns | [android-data-sync-quick.md](references/android-data-sync-quick.md) |
- | Material 3 theming, spacing tokens, dynamic colors | [android-theming-quick.md](references/android-theming-quick.md) |
- | Navigation3, deep links, App Links, adaptive layouts | [android-navigation-quick.md](references/android-navigation-quick.md) |
- | Kotlin patterns, View lifecycle interop | [kotlin-patterns.md](references/kotlin-patterns.md) |
- | Coroutine patterns (`StateFlow`, `Channel`, `callbackFlow`) | [coroutines-patterns-quick.md](references/coroutines-patterns-quick.md) |
- | Gradle, product flavors, BuildConfig, build performance, R8 | [gradle-setup.md](references/gradle-setup.md) |
- | Code quality (Detekt convention plugin, CI) | [code-quality.md](references/code-quality.md) |
- | Testing approach (unit, instrumented, Compose UI) | [testing-quick.md](references/testing-quick.md) |
- | Internationalization and localization | [android-i18n.md](references/android-i18n.md) |
- | Runtime permissions, Photo Picker, API 37 location privacy | [android-permissions.md](references/android-permissions.md) |
- | Kotlin delegation patterns | [kotlin-delegation.md](references/kotlin-delegation.md) |
- | Crash reporting (Firebase / Sentry interfaces, PII scrubbing) | [crashlytics.md](references/crashlytics.md) |
- | Design patterns (GoF-style, Room FTS) | [design-patterns-quick.md](references/design-patterns-quick.md) |
- | Performance, Play Vitals, startup, recomposition, jank, APA, Perfetto | [android-performance.md](references/android-performance.md) |
- | Android 17 QPR2 memory budgets on constrained devices (optional) | [android-performance.md](references/android-performance.md#android-17-qpr2-memory-budgets-optional) |
- | Debugging, Logcat, ANR, Gradle errors, R8 mapping, memory leaks | [android-debugging.md](references/android-debugging.md) |
- | Migrations (XML, RxJava, Navigation, Compose, Room 2→3, API 37, 16 KB native, Compose-XML interop) | [migration.md](references/migration.md); [16 KB page size](references/migration.md#16-kb-memory-page-size-play-and-native-code); [Compose-XML interop](references/migration.md#compose-xml-interop-hardening) |
- ## Examples
- **Greenfield Android app with convention plugins**
- User goal: new repo matching the skill stack.
- Actions: copy `assets/settings.gradle.kts.template`, `assets/libs.versions.toml.template`, `assets/convention/` into `build-logic/` per `assets/convention/QUICK_REFERENCE.md`; wire `includeBuild("build-logic")`; read [modularization.md](references/modularization.md) and [gradle-setup.md](references/gradle-setup.md).
- Result: root + `app` + core modules with version catalog and convention plugins applied.
- **New feature screen (Compose + ViewModel)**
- User goal: one new flow in a feature module.
- Actions: [modularization.md](references/modularization.md) for module naming and dependency direction; [compose-patterns-quick.md](references/compose-patterns-quick.md) for Screen, state, effects; [kotlin-patterns.md](references/kotlin-patterns.md) + [coroutines-patterns-quick.md](references/coroutines-patterns-quick.md) for `StateFlow` / events; [architecture.md](references/architecture.md) for domain vs data boundaries.
- Result: feature module with Screen composable, ViewModel, `UiState`, and DI aligned to existing graphs.
- **Offline-first list with Room 3 and remote API**
- User goal: cached list + network refresh.
- Actions: [compose-patterns.md](references/compose-patterns.md#offline-first-paging-and-remotemediator) for Paging 3 + `RemoteMediator`; [architecture.md](references/architecture.md) for repository placement; Room 3 + `SQLiteDriver` per [workflows.md](references/workflows.md) (Working with databases) and [migration.md](references/migration.md#room-2x-to-room-3) if upgrading.
- Result: single source of truth in Room, UI driven by `PagingData` or equivalent pattern from the guide.
- **Target SDK / compile SDK bump (e.g. API 37)**
- User goal: migrate toolchain and platform requirements.
- Actions: walk [migration.md](references/migration.md#android-17-api-37-migration); pin AGP/Kotlin/KSP using [gradle-setup.md](references/gradle-setup.md) and [dependencies.md](references/dependencies.md); cross-check edge-to-edge, media, security per [workflows.md](references/workflows.md) (Migrating to target SDK 37).
- Result: `compileSdk` / `targetSdk` raised with manifest, Gradle, and feature code adjusted per the migration doc.
- ## Troubleshooting
- | Symptom | Likely cause | Fix |
- |----------------------------------------------------------------------|--------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
- | Gradle sync fails, plugin not found, or version catalog errors | Missing `google()` / `mavenCentral()`, wrong plugin id, or catalog alias drift | [gradle-setup.md](references/gradle-setup.md); align with `assets/libs.versions.toml.template` when bootstrapping |
- | KSP errors on Room, or Room 3 builder rejects missing driver | Room 3 (template `3.0.3`) expects `setDriver(BundledSQLiteDriver())` (or project equivalent) | [migration.md](references/migration.md#room-2x-to-room-3); [modularization.md](references/modularization.md); [architecture.md](references/architecture.md) |
- | Unresolved `@TypeConverter`, or a DAO return type is rejected | Room 3 renamed it to `@ColumnTypeConverter`; non-`Flow`/`suspend` return types need `@DaoReturnTypeConverters` | [migration.md](references/migration.md#dao-return-type-converters) |
- | Release-only crash while the class **is** listed in `seeds.txt` | AGP 9 `strictFullModeForKeepRules`: `-keep class A` no longer keeps its constructor | [android-debugging.md](references/android-debugging.md#r8-keep-rules-troubleshooting); [gradle-setup.md](references/gradle-setup.md#agp-9-r8-defaults-that-change-existing-behavior) |
- | Gradle sync fails right after bumping Compose, nav3, or androidx.hilt | Those libraries compile against `compileSdk` 37 and require **AGP >= 9.2.0** | [migration.md](references/migration.md#libraries-that-force-the-agp-floor); [gradle-setup.md](references/gradle-setup.md#agp-requires-a-minimum-gradle-wrapper) |
- | LAN device discovery or a local HTTP call silently fails at target 37 | `ACCESS_LOCAL_NETWORK` is required, or use the permissionless `NsdManager` picker | [android-permissions.md](references/android-permissions.md#local-network-access-api-37); [migration.md](references/migration.md#local-network-access-target-sdk-37) |
- | Background audio is silent with no exception | API 37 audio hardening - no `MediaSession`, or no `mediaPlayback` FGS | [android-media.md](references/android-media.md#diagnosing-silent-audio-failures) |
- | Compose runtime warnings about unstable / skippable recompositions | Unstable parameter types or state held incorrectly | [compose-patterns-quick.md](references/compose-patterns-quick.md); [android-performance.md](references/android-performance.md); [kotlin-patterns.md](references/kotlin-patterns.md) |
- | Release build crashes, `ClassNotFoundException`, or missing R8 rules | Shrinking removed reflective or JNI entry points | [android-debugging.md](references/android-debugging.md#r8-keep-rules-troubleshooting); [gradle-setup.md](references/gradle-setup.md#r8-keep-rules-audit) |
- | ANR or jank claims without evidence | Main-thread or measurement assumptions | [android-performance.md](references/android-performance.md#android-performance-analyzer-apa) or [Perfetto](references/android-performance.md#perfetto-system-traces) before architecture changes |
README.md · README · 236 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <img width="300px" src="/claude-android-ninja.png" />
- </p>
- # Android Agent Skill
- 
- 
- 
- 
- This repository is an **Agent Skill** package for Android development with Kotlin and Jetpack Compose.
- It provides a structured set of instructions, templates, and references that help agents build
- production-quality Android apps consistently and efficiently.
- Learn more about the Agent Skills format here: [agentskills.io](https://agentskills.io/home)
- Browse this skill on [SkillsMP](https://skillsmp.com/skills/drjacky-claude-android-ninja-skill-md)
- ## What This Skill Covers
- - Modular Android architecture (feature-first, core modules, strict dependencies)
- - Domain/Data/UI layering patterns with auth-focused examples
- - Jetpack Compose patterns, state management, animation, side effects, modifiers, and adaptive UI (NavigationSuiteScaffold, ListDetailPaneScaffold, SupportingPaneScaffold)
- - Edge-to-edge display and predictive back gesture handling
- - Material 3 theming (dynamic colors, typography, shapes, 8dp spacing tokens, app-category style fit, reserved resource names, dark/light mode)
- - Navigation3 guidance (stable catalog pin, deep-link routing, SavedState Compose with `NavKey`), adaptive navigation, and large-screen quality tiers (phones, tablets, foldables, input expectations)
- - Accessibility support (TalkBack, semantic properties, label copy, live regions, Espresso accessibility checks, WCAG alignment)
- - Internationalization & localization (i18n/l10n, RTL support, plurals)
- - Notifications (channels, styles, actions, foreground services, progress-centric, media/audio focus, PiP, system sharesheet, Navigation3 state from taps)
- - Background media playback hardening at target SDK 37 (Media3 `MediaSessionService` for audio and video, `mediaPlayback` foreground service type, `FOREGROUND_SERVICE_MEDIA_PLAYBACK` permission, standalone `MediaPlayer`/`AudioTrack` forbidden in background, `requestAudioFocus` enforcement) and Media3 ExoPlayer catalog wiring with playback preloading guidance
- - Data synchronization & offline-first (sync strategies, conflict resolution, cache invalidation)
- - Material Symbols icons, adaptive launcher icon specs, graphics, custom drawing with Canvas, and Coil3 image loading patterns (AsyncImage, SubcomposeAsyncImage, Hilt ImageLoader)
- - Gradle/build conventions, product flavors and BuildConfig, version catalog usage, KSP migration, Spotless formatting, and build performance optimization (diagnostics, lazy tasks, configuration cache)
- - Testing practices with fakes, Hilt testing, Room 3 testing (`SQLiteDriver`, `room3-testing`), Compose Preview Screenshot Testing and Roborazzi trade routing, pre-release UI state checklist (empty, loading, error, offline, permissions), ADB device targeting, install or launch smoke, and UIAutomator black-box checks (`references/testing.md`)
- - Coroutines patterns, structured concurrency, Flow (callbackFlow, backpressure, combine, shareIn), and common pitfalls
- - Kotlin delegation patterns and composition over inheritance
- - Dependency management rules and templates
- - Crash reporting with provider-agnostic interfaces (Firebase/Sentry)
- - Runtime permissions with Compose patterns (`references/android-permissions.md`) including contact picker, Embedded Photo Picker, and Android 17 location privacy; media playback, picking, FileProvider, and sharesheet routing (`references/android-media.md`)
- - Performance benchmarking (Macrobenchmark, Microbenchmark, Baseline Profiles, ProfileInstaller, System Tracing), Android Performance Analyzer (APA) for Studio system traces, Perfetto UI for attached traces, Google Play Vitals context (crash/ANR bars, startup targets, frame budgets, battery/background), optional Play Developer Reporting API vitals, Compose recomposition optimization (three phases, deferred state reads, Strong Skipping Mode), and app startup optimization (App Startup library, splash screen, lazy initialization)
- - StrictMode guardrails and Compose compiler stability diagnostics
- - Code coverage with JaCoCo (unit + instrumented tests)
- - Security (certificate pinning, encryption, biometrics, Credential Manager and passkeys, device identifiers and privacy, Play Data safety, Play Integrity Standard/Classic with server `decodeIntegrityToken`, `requestHash`/`nonce` binding, tiered policy, remediation, URI grants on outbound intents, local root/emulator checks as supplementary)
- - Retrofit/networking patterns (service interfaces, nullable JSON DTOs, Hilt NetworkModule, AuthInterceptor)
- - Haptic feedback, touch targets, and forms/input patterns (keyboard types, autofill, validation)
- - Debugging guide (Logcat levels, ANR timeouts, Gradle error patterns, LeakCanary, Compose recomposition, R8 mapping and manual de-obfuscation, R8 keep-rules troubleshooting, process kill under memory caps / memory-limiter reproduction)
- - Consolidated migration guide (XML to Compose, LiveData to StateFlow, RxJava to Coroutines, Navigation 2.x to Navigation3, Accompanist to official APIs, Material 2 to 3, Edge-to-Edge, Room 2.x to Room 3 (composite `@Relation` / `@Junction` keys), Android 17 / API 37 checklist (memory limiter, location privacy), 16 KB native page size and Play alignment, Compose-XML interop hardening, Splash Screen API; [`references/migration.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/migration.md))
- - Code quality with Detekt and Compose rules
- - Play CI/CD: AAB, release tracks, signing boundaries, staged rollout, upload automation (fastlane vs Gradle Play Publisher routing), and Play developer identity verification (Console human step outside the repo; [`references/android-ci-cd.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-ci-cd.md))
- ## Key Files
- - [`SKILL.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/SKILL.md) - entry point (Quick Reference, Examples, Troubleshooting)
- - [`references/INDEX.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/INDEX.md) - summary table of all reference files and quick companions (~50 lines)
- - [`references/INDEX-sections.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/INDEX-sections.md) - detailed section anchors (open only when quick routing is insufficient)
- - [`references/workflows.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/workflows.md) - extended task routing when Quick Reference is not enough
- - [`references/architecture.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/architecture.md) - architecture principles, data/domain/ui/common layers, nullable network DTOs, and flows
- - [`references/modularization.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/modularization.md) - module structure, dependency rules, and feature module creation
- - [`references/android-navigation.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-navigation.md) - Navigation3 (stable pin, deep links, shared elements), adaptive navigation, large-screen quality tiers
- - [`references/compose-patterns.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/compose-patterns.md) - Compose patterns, Material motion, animation, side effects, modifiers, stability, and migrations
- - [`references/android-theming.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-theming.md) - Material 3 theming, spacing tokens, category style, colors, typography, shapes
- - [`references/android-accessibility.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-accessibility.md) - accessibility, TalkBack, label copy, semantic properties, WCAG
- - [`references/android-i18n.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-i18n.md) - internationalization, localization, RTL support, plurals
- - [`references/android-notifications.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-notifications.md) - notifications, channels, media/PiP/sharesheet, foreground services
- - [`references/android-media.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-media.md) - picking and sharing media/files (router), background playback at API 37 (Media3 `MediaSessionService`, FGS type, audio focus), and playback preloading
- - [`references/android-data-sync.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-data-sync.md) - offline-first, sync strategies, conflict resolution
- - [`references/kotlin-patterns.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/kotlin-patterns.md) - Kotlin best practices and View lifecycle interop (must-read for Kotlin code)
- - [`references/coroutines-patterns.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/coroutines-patterns.md) - coroutines best practices and patterns
- - [`references/gradle-setup.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/gradle-setup.md) - build logic, product flavors, BuildConfig, conventions, R8 Keep-Rules Audit, build files, and registering optional root tasks (for example Play Vitals reporting)
- - [`references/android-ci-cd.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-ci-cd.md) - Play release AAB, tracks, signing boundaries, staged rollout, developer verification, bundletool sideloads, CI release lane ordering
- - [`references/testing.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/testing.md) - testing patterns with fakes, Hilt, Room 3, Navigation3, Compose and UIAutomator smoke, ADB device targeting, pre-release UI state checklist, Preview vs Roborazzi visual regression routing, deep links, and screenshot testing
- - [`references/android-graphics.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-graphics.md) - Material Symbols icons, adaptive launcher icons, Canvas drawing, Palette API
- - [`references/android-permissions.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-permissions.md) - runtime permissions, contact picker, Embedded Photo Picker, Android 17 location privacy
- - [`references/kotlin-delegation.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/kotlin-delegation.md) - delegation patterns and composition guidance
- - [`references/crashlytics.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/crashlytics.md) - crash reporting with modular provider swaps
- - [`references/android-strictmode.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-strictmode.md) - StrictMode guardrails and Compose stability
- - [`references/android-code-coverage.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-code-coverage.md) - JaCoCo code coverage setup and CI integration
- - [`references/android-security.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-security.md) - Play Integrity (Standard/Classic), server decode and verdict policy, `requestHash`/`nonce`, errors/remediation, device trust vs local root checks, Credential Manager, pinning, encryption, Data safety
- - [`references/code-quality.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/code-quality.md) - Detekt setup and code quality rules
- - [`references/dependencies.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/dependencies.md) - dependency rules and version catalog guidance (Navigation3, Room 3, Media3, SavedState Compose pins)
- - [`references/android-performance.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-performance.md) - Play Vitals thresholds, optional Play Developer Reporting API (CI/Slack), benchmarking, APA and Perfetto trace routing, recomposition, app startup, splash screen
- - [`references/android-debugging.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-debugging.md) - Logcat levels, ANR timeouts, LeakCanary, R8 de-obfuscation and keep-rules troubleshooting, memory-limiter reproduction, Gradle errors, Compose recomposition
- - [`references/migration.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/migration.md) - XML to Compose, LiveData to StateFlow, RxJava, Navigation, Accompanist, Material, Edge-to-Edge, Room 2.x → Room 3, Android 17 / API 37 (memory limiter, location privacy), [16 KB native / Play](https://github.com/Drjacky/claude-android-ninja/blob/master/references/migration.md#16-kb-memory-page-size-play-and-native-code), [Compose-XML interop hardening](https://github.com/Drjacky/claude-android-ninja/blob/master/references/migration.md#compose-xml-interop-hardening), legacy splash
- - [`references/design-patterns.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/design-patterns.md) - Android-focused design patterns
- - [`assets/proguard-rules.pro.template`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/proguard-rules.pro.template) - R8/ProGuard rules for all libraries
- - [`assets/detekt.yml.template`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/detekt.yml.template) - Detekt static analysis configuration
- - [`assets/libs.versions.toml.template`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/libs.versions.toml.template) - Version catalog with all dependencies
- - [`assets/settings.gradle.kts.template`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/settings.gradle.kts.template) - Project settings with repositories
- - [`assets/convention/`](https://github.com/Drjacky/claude-android-ninja/tree/master/assets/convention) - Gradle convention plugins, `config/` helpers, and [`QUICK_REFERENCE.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/convention/QUICK_REFERENCE.md)
- ## Scope
- This skill is focused on Android app development using:
- - **Kotlin** (with coroutines, Flow, and kotlinx-datetime)
- - **Jetpack Compose** and **Material 3** (dynamic color, Material Symbols icons, adaptive layouts: NavigationSuiteScaffold and pane scaffolds)
- - **Navigation3** (type-safe routing)
- - **Hilt** (dependency injection)
- - **Room 3** (`androidx.room3`, KSP, `SQLiteDriver` / `sqlite-bundled`, Flow and `suspend` DAOs)
- - **Retrofit** + **OkHttp** (networking)
- - **Coil3** (image loading)
- - **Media3** (ExoPlayer, session, playback preloading; catalog in `libs.versions.toml.template`)
- - **Firebase Crashlytics** / **Sentry** (crash reporting)
- - **Macrobenchmark** / **Microbenchmark** (performance testing)
- - **Detekt** + **Compose Rules** (code quality)
- - **Google Truth** + **Turbine** (testing assertions)
- ## Installation
- Agent entry point after install: [`SKILL.md`](SKILL.md) (Quick Reference table; extended routing in [`references/workflows.md`](references/workflows.md)). Open `references/` files only for the task at hand. Format spec: [agentskills.io](https://agentskills.io/home).
- ### For AI agents
- This skill uses the open [Agent Skills](https://agentskills.io/home) format: a folder named `claude-android-ninja/` with `SKILL.md`, `references/`, and `assets/`. Agents load skill metadata at session start; route Android work through [`SKILL.md`](SKILL.md) and open reference files only when needed.
- Paths below are each agent's **primary** install locations. Many agents also scan shared fallbacks such as `.agents/skills/` or `.claude/skills/`.
- | Agent | Project path | Global path | Docs |
- |----------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/claude-color.svg" width="18" height="18" align="absmiddle" alt=""> [Claude Code](https://code.claude.com/docs/en/skills) | `.claude/skills/claude-android-ninja/` | `~/.claude/skills/claude-android-ninja/` | [Skills](https://code.claude.com/docs/en/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/cline.svg" width="18" height="18" align="absmiddle" alt=""> [Cline](https://docs.cline.bot/customization/skills) | `.cline/skills/claude-android-ninja/` | `~/.cline/skills/claude-android-ninja/` | [Skills](https://docs.cline.bot/customization/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/codex-color.svg" width="18" height="18" align="absmiddle" alt=""> [Codex](https://developers.openai.com/codex/skills) | `.agents/skills/claude-android-ninja/` (repo / CWD) | `~/.codex/skills/claude-android-ninja/` | [Agent Skills](https://developers.openai.com/codex/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/cursor.svg" width="18" height="18" align="absmiddle" alt=""> [Cursor](https://cursor.com/docs/context/skills) | `.cursor/skills/claude-android-ninja/` | `~/.cursor/skills/claude-android-ninja/` | [Agent Skills](https://cursor.com/docs/context/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/gemini-color.svg" width="18" height="18" align="absmiddle" alt=""> [Gemini CLI](https://geminicli.com/docs/cli/skills/) | `.gemini/skills/claude-android-ninja/` | `~/.gemini/skills/claude-android-ninja/` | [Agent Skills](https://geminicli.com/docs/cli/skills/) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/githubcopilot.svg" width="18" height="18" align="absmiddle" alt=""> [GitHub Copilot](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) (VS Code / agent mode) | `.github/skills/claude-android-ninja/` | `~/.copilot/skills/claude-android-ninja/` | [About agent skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/githubcopilot.svg" width="18" height="18" align="absmiddle" alt=""> [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills) | `.github/skills/claude-android-ninja/` | `~/.copilot/skills/claude-android-ninja/` | [Add skills (CLI)](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/antigravity-color.svg" width="18" height="18" align="absmiddle" alt=""> [Google Antigravity](https://antigravity.google/docs/skills) | `.agent/skills/claude-android-ninja/` (workspace) | `~/.gemini/antigravity/skills/claude-android-ninja/` | [Skills codelab](https://codelabs.developers.google.com/getting-started-with-antigravity-skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/goose.svg" width="18" height="18" align="absmiddle" alt=""> [Goose](https://goose-docs.ai/docs/guides/context-engineering/using-skills/) | `.goose/skills/claude-android-ninja/` | `~/.config/goose/skills/claude-android-ninja/` | [Using skills](https://goose-docs.ai/docs/guides/context-engineering/using-skills/) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/nousresearch.svg" width="18" height="18" align="absmiddle" alt=""> [Hermes](https://nousresearch-hermes-agent.mintlify.app/user-guide/features/skills) | `.hermes/skills/claude-android-ninja/` | `~/.hermes/skills/claude-android-ninja/` | [Skills system](https://nousresearch-hermes-agent.mintlify.app/user-guide/features/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/kilocode.svg" width="18" height="18" align="absmiddle" alt=""> [Kilo Code](https://kilo.ai/docs/customize/skills) | `.kilo/skills/claude-android-ninja/` | `~/.kilo/skills/claude-android-ninja/` | [Skills](https://kilo.ai/docs/customize/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/openclaw-color.svg" width="18" height="18" align="absmiddle" alt=""> [OpenClaw](https://docs.openclaw.ai/tools/skills) | `skills/claude-android-ninja/` (workspace root) | `~/.openclaw/skills/claude-android-ninja/` | [Skills](https://docs.openclaw.ai/tools/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/opencode.svg" width="18" height="18" align="absmiddle" alt=""> [OpenCode](https://opencode.ai/docs/skills) | `.opencode/skills/claude-android-ninja/` | `~/.config/opencode/skills/claude-android-ninja/` | [Skills](https://opencode.ai/docs/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/roocode.svg" width="18" height="18" align="absmiddle" alt=""> [Roo Code](https://docs.roocode.com/features/skills) | `.roo/skills/claude-android-ninja/` | `~/.roo/skills/claude-android-ninja/` | [Skills](https://docs.roocode.com/features/skills) |
- | <img src="https://unpkg.com/@lobehub/icons-static-svg/icons/windsurf.svg" width="18" height="18" align="absmiddle" alt=""> [Windsurf](https://docs.windsurf.com/windsurf/cascade/skills) (Cascade) | `.windsurf/skills/claude-android-ninja/` | `~/.codeium/windsurf/skills/claude-android-ninja/` | [Skills](https://docs.windsurf.com/windsurf/cascade/skills) |
- **Recommended install:** [Vercel Skills](#vercel-skills-cli) (`npx skills`) writes into each agent's native path (50+ agents, auto-detect). See [supported agents](https://github.com/vercel-labs/skills#supported-agents) for CLI path overrides.
- ```bash
- npx skills add drjacky/claude-android-ninja
- ```
- | Step | Action |
- |------|---------------------------------------------------------------------------------------------------------|
- | 1 | Install via [Vercel Skills](#vercel-skills-cli), [manual install](#manual-install), or the table above. |
- | 2 | Start a **new** agent session (skills load at startup). |
- | 3 | Route Android tasks through `SKILL.md`; load linked reference files on demand. |
- ### Manual install
- Clone this repo, then copy the whole folder into the **project** or **global** path for your agent from the table above (same tree for every tool):
- ```bash
- git clone https://github.com/Drjacky/claude-android-ninja.git
- # Example: Claude Code global - swap the destination for your agent's path
- mkdir -p ~/.claude/skills
- cp -r claude-android-ninja ~/.claude/skills/claude-android-ninja
- ```
- Expected layout (destination varies by agent):
- ```
- <agent-skills-dir>/claude-android-ninja/
- ├── SKILL.md
- ├── references/
- └── assets/
- ```
- Restart the agent or start a new session so the skill is discovered.
- ### Vercel Skills CLI
- [Vercel Skills](https://github.com/vercel-labs/skills) (`npx skills`) installs this repo into each agent's **native** skills directory (see the [For AI agents](#for-ai-agents) table). It auto-detects installed agents, or you can target them with `-a`. Browse more skills at [skills.sh](https://skills.sh).
- Project install (default; symlinks into detected agents):
- ```bash
- npx skills add drjacky/claude-android-ninja
- ```
- Global install (available in all projects):
- ```bash
- npx skills add drjacky/claude-android-ninja -g
- ```
- Install to specific agents (non-interactive):
- ```bash
- npx skills add drjacky/claude-android-ninja -a claude-code -a cursor -a kilo -y
- ```
- Install to all supported agents without prompts:
- ```bash
- npx skills add drjacky/claude-android-ninja --all
- ```
- Use `--copy` instead of symlinks when your environment does not support symlinks. Other useful commands: `npx skills list`, `npx skills update claude-android-ninja`, `npx skills remove claude-android-ninja`, `npx skills find android`.
- ### Verify install
- - Folder contains `SKILL.md`, `references/`, and `assets/` (templates and convention plugins).
- - Agent session was restarted after copy or install.
- - `npx skills list` shows `claude-android-ninja` under the expected agent paths.
- ### Validate skill package (contributors)
- From the repo root:
- ```bash
- ./.github/scripts/validate-skill.sh # line counts + links + ergonomics + voice + typography + skills-ref frontmatter
- ./.github/scripts/check-skill-index-line-counts.sh # reference line counts in skill markdown
- ./.github/scripts/check-skill-index-line-counts.sh --fix # refresh stale counts locally
- ./.github/scripts/check-skill-links.sh # internal markdown links only
- ./.github/scripts/check-skill-ergonomics.sh # INDEX/SKILL line caps; -quick.md for refs >= 1500 lines
- ./.github/scripts/check-skill-voice.sh # directive-first prose ban-list (SKILL.md + references/)
- ./.github/scripts/check-skill-typography.sh # ASCII dashes, quotes, spaces, ellipsis (skill markdown)
- ```
- CI runs the full skill package validation on push and pull requests (`.github/workflows/validate-skill.yml`). `skills-ref` checks `name` / `description` frontmatter only; it does not require renaming `claude-android-ninja`.
- ## Contributing
- ### Request Missing Best Practices
- If you need a best practice topic or pattern that's missing from this SKILL, please create a feature request on GitHub. This helps us prioritize what to add next.
- [Create a Feature Request](https://github.com/drjacky/claude-android-ninja/issues/new?template=feature_request.md)
- ### Report Issues
- Found a bug, outdated pattern, or incorrect guidance? Please report it so we can fix it.
- [Report a Bug](https://github.com/drjacky/claude-android-ninja/issues/new?template=bug_report.md)
- ### Star History Chart
- [](https://api.star-history.com/svg?repos=drjacky/claude-android-ninja&Date=&type=Date)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.