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

Browse this skill on SkillsMP

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, 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)
• 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, and build performance optimization (diagnostics, lazy tasks, configuration cache)
• Testing practices with fakes, Hilt testing, Room 3 testing (SQLiteDriver, room3-testing), and Compose Preview Screenshot Testing
• 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
• Performance benchmarking (Macrobenchmark, Microbenchmark, Baseline Profiles, ProfileInstaller, System Tracing), 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, 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)
• 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)
• Code quality with Detekt and Compose rules

Key Files

• SKILL.md - entry point and workflow decision tree
• references/architecture.md - architecture principles, data/domain/ui/common layers, nullable network DTOs, and flows
• references/modularization.md - module structure, dependency rules, and feature module creation
• references/android-navigation.md - Navigation3, adaptive navigation, large-screen quality tiers
• references/compose-patterns.md - Compose patterns, Material motion, animation, side effects, modifiers, stability, and migrations
• references/android-theming.md - Material 3 theming, spacing tokens, category style, colors, typography, shapes
• references/android-accessibility.md - accessibility, TalkBack, label copy, semantic properties, WCAG
• references/android-i18n.md - internationalization, localization, RTL support, plurals
• references/android-notifications.md - notifications, channels, media/PiP/sharesheet, foreground services
• references/android-data-sync.md - offline-first, sync strategies, conflict resolution
• references/kotlin-patterns.md - Kotlin best practices and View lifecycle interop (must-read for Kotlin code)
• references/coroutines-patterns.md - coroutines best practices and patterns
• references/gradle-setup.md - build logic, product flavors, BuildConfig, conventions, build files, and registering optional root tasks (for example Play Vitals reporting)
• references/testing.md - testing patterns with fakes, Hilt, Room 3, and Navigation3
• references/android-graphics.md - Material Symbols icons, adaptive launcher icons, Canvas drawing, Palette API
• references/android-permissions.md - runtime permissions and best practices
• references/kotlin-delegation.md - delegation patterns and composition guidance
• references/crashlytics.md - crash reporting with modular provider swaps
• references/android-strictmode.md - StrictMode guardrails and Compose stability
• references/android-code-coverage.md - JaCoCo code coverage setup and CI integration
• 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 - Detekt setup and code quality rules
• references/dependencies.md - dependency rules and version catalog guidance
• references/android-performance.md - Play Vitals thresholds, optional Play Developer Reporting API (CI/Slack), benchmarking, recomposition, app startup, splash screen
• references/android-debugging.md - Logcat levels, ANR timeouts, LeakCanary, R8 de-obfuscation, Gradle errors, Compose recomposition
• references/migration.md - XML to Compose, LiveData to StateFlow, RxJava, Navigation, Accompanist, Material, Edge-to-Edge, and Room 2.x → Room 3
• references/design-patterns.md - Android-focused design patterns
• assets/proguard-rules.pro.template - R8/ProGuard rules for all libraries
• assets/detekt.yml.template - Detekt static analysis configuration
• assets/libs.versions.toml.template - Version catalog with all dependencies
• assets/settings.gradle.kts.template - Project settings with repositories
• assets/convention/ - Gradle convention plugins, config/ helpers, and QUICK_REFERENCE.md

Scope

This skill is focused on Android app development using:

• Kotlin (with coroutines, Flow, and kotlinx-datetime)
• Jetpack Compose (Material 3 with Material Symbols icons)
• Material 3 Adaptive (NavigationSuiteScaffold, adaptive pane scaffolds)
• Navigation3 (type-safe routing)
• Material 3
• Hilt (dependency injection)
• Room 3 (androidx.room3, KSP, SQLiteDriver / sqlite-bundled, Flow and suspend DAOs)
• Retrofit + OkHttp (networking)
• Coil3 (image loading)
• Firebase Crashlytics / Sentry (crash reporting)
• Macrobenchmark / Microbenchmark (performance testing)
• Detekt + Compose Rules (code quality)
• Google Truth + Turbine (testing assertions)

Installation

1. Claude Code (manual)

Clone or download this repo, then place it in Claude's skills folder and refresh skills.

~/.claude/skills/claude-android-ninja/
├── SKILL.md
├── references/
└── assets/

If you prefer project-local skills, use .claude/skills/ inside your project.

2. OpenSkills CLI

OpenSkills can install any skill repo and generate the AGENTS/skills metadata for multiple agents.

npx openskills install drjacky/claude-android-ninja
npx openskills sync

Global install (installs to ~/.claude/skills/, shared across all projects):

npx openskills install drjacky/claude-android-ninja --global

Optional universal install (shared across agents):

npx openskills install drjacky/claude-android-ninja --universal

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

Report Issues

Found a bug, outdated pattern, or incorrect guidance? Please report it so we can fix it.

Report a Bug