Skip to content
Back to search

claude-android-ninja

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/drjacky--claude-android-ninja/badge.svg)](/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

i

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)

  1. ---
  2. name: claude-android-ninja
  3. 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.
  4. 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.
  5. license: Apache-2.0
  6. metadata:
  7. author: DrJacky
  8. version: "1.0.0"
  9. documentation: https://github.com/Drjacky/claude-android-ninja
  10. tags: android, kotlin, compose, mvvm, hilt, room, room3, datastore, paging, gradle, mobile
  11. ---
  12. # Android Kotlin Compose Development
  13. **Context ladder (smaller load first; full references stay complete):**
  14. 1. This file (`SKILL.md`) - routing, stop rules, examples.
  15. 2. `references/*-quick.md` when listed below - required/forbidden + section links (~40 lines).
  16. 3. One target section in the full `references/*.md` - code samples and checklists only.
  17. 4. [INDEX-sections.md](references/INDEX-sections.md) - anchor dump only when quick routing is insufficient.
  18. 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.
  19. 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).
  20. **Required:**
  21. - **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).
  22. - **Greenfield:** [workflows.md](references/workflows.md) → "Creating a new project?"
  23. - 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).
  24. **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).
  25. ## Quick Reference
  26. Rare or niche topics not listed here are in [INDEX.md](references/INDEX.md) (complete file list).
  27. | Task | Reference |
  28. |----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
  29. | Task not in table, greenfield bootstrap, multi-topic setup | [workflows.md](references/workflows.md) |
  30. | 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?") |
  31. | Full index of all reference files | [INDEX.md](references/INDEX.md) |
  32. | Version catalog, pins, alpha policy, brownfield alignment | [dependencies.md](references/dependencies.md#version-strategy) |
  33. | Adding or updating dependencies (catalog aliases) | [dependencies.md](references/dependencies.md) |
  34. | Multi-module dependencies | [dependencies.md](references/dependencies.md) |
  35. | Project structure and modules | [modularization.md](references/modularization.md) |
  36. | MVVM layers, repositories, DI | [architecture.md](references/architecture.md) |
  37. | Retrofit / OkHttp, NetworkModule, nullable DTOs, AuthInterceptor | [architecture.md](references/architecture.md#network-layer-setup-corenetwork); [dependencies.md](references/dependencies.md) |
  38. | DataStore (preferences, typed), Room vs DataStore rules | [architecture.md](references/architecture.md#datastore-preferences--typed) |
  39. | Code formatting (Spotless, `spotlessCheck` / `spotlessApply`) | [assets/convention/QUICK_REFERENCE.md](assets/convention/QUICK_REFERENCE.md#spotless-plugin); [gradle-setup.md](references/gradle-setup.md) |
  40. | Compose patterns, motion, animation, modifiers, stability | [compose-patterns-quick.md](references/compose-patterns-quick.md) |
  41. | Paging 3 + Room + network (`RemoteMediator`, remote keys, `initialize`) | [compose-patterns.md](references/compose-patterns.md#offline-first-paging-and-remotemediator) |
  42. | Accessibility, TalkBack, label copy, live regions, Espresso a11y | [android-accessibility-quick.md](references/android-accessibility-quick.md) |
  43. | Notifications, foreground services, MediaStyle, PiP, sharesheet | [android-notifications.md](references/android-notifications.md) |
  44. | Media: API 37 background playback, Media3, picking, FileProvider, sharesheet | [android-media.md](references/android-media.md) |
  45. | Data sync and offline-first patterns | [android-data-sync-quick.md](references/android-data-sync-quick.md) |
  46. | Material 3 theming, spacing tokens, dynamic colors | [android-theming-quick.md](references/android-theming-quick.md) |
  47. | Navigation3, deep links, App Links, adaptive layouts | [android-navigation-quick.md](references/android-navigation-quick.md) |
  48. | Kotlin patterns, View lifecycle interop | [kotlin-patterns.md](references/kotlin-patterns.md) |
  49. | Coroutine patterns (`StateFlow`, `Channel`, `callbackFlow`) | [coroutines-patterns-quick.md](references/coroutines-patterns-quick.md) |
  50. | Gradle, product flavors, BuildConfig, build performance, R8 | [gradle-setup.md](references/gradle-setup.md) |
  51. | Code quality (Detekt convention plugin, CI) | [code-quality.md](references/code-quality.md) |
  52. | Testing approach (unit, instrumented, Compose UI) | [testing-quick.md](references/testing-quick.md) |
  53. | Internationalization and localization | [android-i18n.md](references/android-i18n.md) |
  54. | Runtime permissions, Photo Picker, API 37 location privacy | [android-permissions.md](references/android-permissions.md) |
  55. | Kotlin delegation patterns | [kotlin-delegation.md](references/kotlin-delegation.md) |
  56. | Crash reporting (Firebase / Sentry interfaces, PII scrubbing) | [crashlytics.md](references/crashlytics.md) |
  57. | Design patterns (GoF-style, Room FTS) | [design-patterns-quick.md](references/design-patterns-quick.md) |
  58. | Performance, Play Vitals, startup, recomposition, jank, APA, Perfetto | [android-performance.md](references/android-performance.md) |
  59. | Android 17 QPR2 memory budgets on constrained devices (optional) | [android-performance.md](references/android-performance.md#android-17-qpr2-memory-budgets-optional) |
  60. | Debugging, Logcat, ANR, Gradle errors, R8 mapping, memory leaks | [android-debugging.md](references/android-debugging.md) |
  61. | 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) |
  62. ## Examples
  63. **Greenfield Android app with convention plugins**
  64. User goal: new repo matching the skill stack.
  65. 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).
  66. Result: root + `app` + core modules with version catalog and convention plugins applied.
  67. **New feature screen (Compose + ViewModel)**
  68. User goal: one new flow in a feature module.
  69. 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.
  70. Result: feature module with Screen composable, ViewModel, `UiState`, and DI aligned to existing graphs.
  71. **Offline-first list with Room 3 and remote API**
  72. User goal: cached list + network refresh.
  73. 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.
  74. Result: single source of truth in Room, UI driven by `PagingData` or equivalent pattern from the guide.
  75. **Target SDK / compile SDK bump (e.g. API 37)**
  76. User goal: migrate toolchain and platform requirements.
  77. 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).
  78. Result: `compileSdk` / `targetSdk` raised with manifest, Gradle, and feature code adjusted per the migration doc.
  79. ## Troubleshooting
  80. | Symptom | Likely cause | Fix |
  81. |----------------------------------------------------------------------|--------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
  82. | 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 |
  83. | 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) |
  84. | 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) |
  85. | 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) |
  86. | 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) |
  87. | 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) |
  88. | 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) |
  89. | 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) |
  90. | 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) |
  91. | 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)

  1. <p align="center">
  2. <img width="300px" src="/claude-android-ninja.png" />
  3. </p>
  4. # Android Agent Skill
  5. ![Kotlin](https://img.shields.io/badge/Kotlin-2.3.21-blue)
  6. ![AGP](https://img.shields.io/badge/AGP-9.3.1-orange)
  7. ![Min SDK](https://img.shields.io/badge/Min_SDK-24-green)
  8. ![Target SDK](https://img.shields.io/badge/Target_SDK-37-green)
  9. This repository is an **Agent Skill** package for Android development with Kotlin and Jetpack Compose.
  10. It provides a structured set of instructions, templates, and references that help agents build
  11. production-quality Android apps consistently and efficiently.
  12. Learn more about the Agent Skills format here: [agentskills.io](https://agentskills.io/home)
  13. Browse this skill on [SkillsMP](https://skillsmp.com/skills/drjacky-claude-android-ninja-skill-md)
  14. ## What This Skill Covers
  15. - Modular Android architecture (feature-first, core modules, strict dependencies)
  16. - Domain/Data/UI layering patterns with auth-focused examples
  17. - Jetpack Compose patterns, state management, animation, side effects, modifiers, and adaptive UI (NavigationSuiteScaffold, ListDetailPaneScaffold, SupportingPaneScaffold)
  18. - Edge-to-edge display and predictive back gesture handling
  19. - Material 3 theming (dynamic colors, typography, shapes, 8dp spacing tokens, app-category style fit, reserved resource names, dark/light mode)
  20. - Navigation3 guidance (stable catalog pin, deep-link routing, SavedState Compose with `NavKey`), adaptive navigation, and large-screen quality tiers (phones, tablets, foldables, input expectations)
  21. - Accessibility support (TalkBack, semantic properties, label copy, live regions, Espresso accessibility checks, WCAG alignment)
  22. - Internationalization & localization (i18n/l10n, RTL support, plurals)
  23. - Notifications (channels, styles, actions, foreground services, progress-centric, media/audio focus, PiP, system sharesheet, Navigation3 state from taps)
  24. - 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
  25. - Data synchronization & offline-first (sync strategies, conflict resolution, cache invalidation)
  26. - Material Symbols icons, adaptive launcher icon specs, graphics, custom drawing with Canvas, and Coil3 image loading patterns (AsyncImage, SubcomposeAsyncImage, Hilt ImageLoader)
  27. - Gradle/build conventions, product flavors and BuildConfig, version catalog usage, KSP migration, Spotless formatting, and build performance optimization (diagnostics, lazy tasks, configuration cache)
  28. - 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`)
  29. - Coroutines patterns, structured concurrency, Flow (callbackFlow, backpressure, combine, shareIn), and common pitfalls
  30. - Kotlin delegation patterns and composition over inheritance
  31. - Dependency management rules and templates
  32. - Crash reporting with provider-agnostic interfaces (Firebase/Sentry)
  33. - 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`)
  34. - 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)
  35. - StrictMode guardrails and Compose compiler stability diagnostics
  36. - Code coverage with JaCoCo (unit + instrumented tests)
  37. - 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)
  38. - Retrofit/networking patterns (service interfaces, nullable JSON DTOs, Hilt NetworkModule, AuthInterceptor)
  39. - Haptic feedback, touch targets, and forms/input patterns (keyboard types, autofill, validation)
  40. - 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)
  41. - 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))
  42. - Code quality with Detekt and Compose rules
  43. - 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))
  44. ## Key Files
  45. - [`SKILL.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/SKILL.md) - entry point (Quick Reference, Examples, Troubleshooting)
  46. - [`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)
  47. - [`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)
  48. - [`references/workflows.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/workflows.md) - extended task routing when Quick Reference is not enough
  49. - [`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
  50. - [`references/modularization.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/modularization.md) - module structure, dependency rules, and feature module creation
  51. - [`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
  52. - [`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
  53. - [`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
  54. - [`references/android-accessibility.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-accessibility.md) - accessibility, TalkBack, label copy, semantic properties, WCAG
  55. - [`references/android-i18n.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-i18n.md) - internationalization, localization, RTL support, plurals
  56. - [`references/android-notifications.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-notifications.md) - notifications, channels, media/PiP/sharesheet, foreground services
  57. - [`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
  58. - [`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
  59. - [`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)
  60. - [`references/coroutines-patterns.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/coroutines-patterns.md) - coroutines best practices and patterns
  61. - [`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)
  62. - [`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
  63. - [`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
  64. - [`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
  65. - [`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
  66. - [`references/kotlin-delegation.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/kotlin-delegation.md) - delegation patterns and composition guidance
  67. - [`references/crashlytics.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/crashlytics.md) - crash reporting with modular provider swaps
  68. - [`references/android-strictmode.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/android-strictmode.md) - StrictMode guardrails and Compose stability
  69. - [`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
  70. - [`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
  71. - [`references/code-quality.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/code-quality.md) - Detekt setup and code quality rules
  72. - [`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)
  73. - [`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
  74. - [`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
  75. - [`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
  76. - [`references/design-patterns.md`](https://github.com/Drjacky/claude-android-ninja/blob/master/references/design-patterns.md) - Android-focused design patterns
  77. - [`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
  78. - [`assets/detekt.yml.template`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/detekt.yml.template) - Detekt static analysis configuration
  79. - [`assets/libs.versions.toml.template`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/libs.versions.toml.template) - Version catalog with all dependencies
  80. - [`assets/settings.gradle.kts.template`](https://github.com/Drjacky/claude-android-ninja/blob/master/assets/settings.gradle.kts.template) - Project settings with repositories
  81. - [`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)
  82. ## Scope
  83. This skill is focused on Android app development using:
  84. - **Kotlin** (with coroutines, Flow, and kotlinx-datetime)
  85. - **Jetpack Compose** and **Material 3** (dynamic color, Material Symbols icons, adaptive layouts: NavigationSuiteScaffold and pane scaffolds)
  86. - **Navigation3** (type-safe routing)
  87. - **Hilt** (dependency injection)
  88. - **Room 3** (`androidx.room3`, KSP, `SQLiteDriver` / `sqlite-bundled`, Flow and `suspend` DAOs)
  89. - **Retrofit** + **OkHttp** (networking)
  90. - **Coil3** (image loading)
  91. - **Media3** (ExoPlayer, session, playback preloading; catalog in `libs.versions.toml.template`)
  92. - **Firebase Crashlytics** / **Sentry** (crash reporting)
  93. - **Macrobenchmark** / **Microbenchmark** (performance testing)
  94. - **Detekt** + **Compose Rules** (code quality)
  95. - **Google Truth** + **Turbine** (testing assertions)
  96. ## Installation
  97. 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).
  98. ### For AI agents
  99. 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.
  100. Paths below are each agent's **primary** install locations. Many agents also scan shared fallbacks such as `.agents/skills/` or `.claude/skills/`.
  101. | Agent | Project path | Global path | Docs |
  102. |----------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
  103. | <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) |
  104. | <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) |
  105. | <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) |
  106. | <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) |
  107. | <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/) |
  108. | <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) |
  109. | <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) |
  110. | <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) |
  111. | <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/) |
  112. | <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) |
  113. | <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) |
  114. | <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) |
  115. | <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) |
  116. | <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) |
  117. | <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) |
  118. **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.
  119. ```bash
  120. npx skills add drjacky/claude-android-ninja
  121. ```
  122. | Step | Action |
  123. |------|---------------------------------------------------------------------------------------------------------|
  124. | 1 | Install via [Vercel Skills](#vercel-skills-cli), [manual install](#manual-install), or the table above. |
  125. | 2 | Start a **new** agent session (skills load at startup). |
  126. | 3 | Route Android tasks through `SKILL.md`; load linked reference files on demand. |
  127. ### Manual install
  128. 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):
  129. ```bash
  130. git clone https://github.com/Drjacky/claude-android-ninja.git
  131. # Example: Claude Code global - swap the destination for your agent's path
  132. mkdir -p ~/.claude/skills
  133. cp -r claude-android-ninja ~/.claude/skills/claude-android-ninja
  134. ```
  135. Expected layout (destination varies by agent):
  136. ```
  137. <agent-skills-dir>/claude-android-ninja/
  138. ├── SKILL.md
  139. ├── references/
  140. └── assets/
  141. ```
  142. Restart the agent or start a new session so the skill is discovered.
  143. ### Vercel Skills CLI
  144. [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).
  145. Project install (default; symlinks into detected agents):
  146. ```bash
  147. npx skills add drjacky/claude-android-ninja
  148. ```
  149. Global install (available in all projects):
  150. ```bash
  151. npx skills add drjacky/claude-android-ninja -g
  152. ```
  153. Install to specific agents (non-interactive):
  154. ```bash
  155. npx skills add drjacky/claude-android-ninja -a claude-code -a cursor -a kilo -y
  156. ```
  157. Install to all supported agents without prompts:
  158. ```bash
  159. npx skills add drjacky/claude-android-ninja --all
  160. ```
  161. 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`.
  162. ### Verify install
  163. - Folder contains `SKILL.md`, `references/`, and `assets/` (templates and convention plugins).
  164. - Agent session was restarted after copy or install.
  165. - `npx skills list` shows `claude-android-ninja` under the expected agent paths.
  166. ### Validate skill package (contributors)
  167. From the repo root:
  168. ```bash
  169. ./.github/scripts/validate-skill.sh # line counts + links + ergonomics + voice + typography + skills-ref frontmatter
  170. ./.github/scripts/check-skill-index-line-counts.sh # reference line counts in skill markdown
  171. ./.github/scripts/check-skill-index-line-counts.sh --fix # refresh stale counts locally
  172. ./.github/scripts/check-skill-links.sh # internal markdown links only
  173. ./.github/scripts/check-skill-ergonomics.sh # INDEX/SKILL line caps; -quick.md for refs >= 1500 lines
  174. ./.github/scripts/check-skill-voice.sh # directive-first prose ban-list (SKILL.md + references/)
  175. ./.github/scripts/check-skill-typography.sh # ASCII dashes, quotes, spaces, ellipsis (skill markdown)
  176. ```
  177. 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`.
  178. ## Contributing
  179. ### Request Missing Best Practices
  180. 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.
  181. [Create a Feature Request](https://github.com/drjacky/claude-android-ninja/issues/new?template=feature_request.md)
  182. ### Report Issues
  183. Found a bug, outdated pattern, or incorrect guidance? Please report it so we can fix it.
  184. [Report a Bug](https://github.com/drjacky/claude-android-ninja/issues/new?template=bug_report.md)
  185. ### Star History Chart
  186. [![Star History Chart](https://api.star-history.com/svg?repos=drjacky/claude-android-ninja&Date=&type=Date)](https://api.star-history.com/svg?repos=drjacky/claude-android-ninja&Date=&type=Date)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.