claude-android-ninja
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 27 GitHub stars
Code Pass
- Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
This tool is an Agent Skill package providing structured instructions, templates, and best practices for building production-quality Android applications using Kotlin and Jetpack Compose.
Security Assessment
The overall risk is Low. This package does not execute shell commands, make external network requests, or access sensitive user data. The light code audit confirmed the absence of dangerous code patterns, hardcoded secrets, and unnecessary permissions. It functions strictly as a reference guide and template system rather than an executable application.
Quality Assessment
The project demonstrates excellent health and maintenance standards. It is licensed under the permissive MIT license, ensuring clear usage rights. The repository is highly active, with its most recent push occurring today, which suggests active development and responsiveness from the creator. It also enjoys a modest but positive level of community trust, currently backed by 27 GitHub stars.
Verdict
Safe to use.
Agent Skill for Android development with Kotlin and Jetpack Compose, covering modular architecture, Navigation3, Gradle conventions, dependency management, and testing best practices.
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/noncebinding, 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 treereferences/architecture.md- architecture principles, data/domain/ui/common layers, nullable network DTOs, and flowsreferences/modularization.md- module structure, dependency rules, and feature module creationreferences/android-navigation.md- Navigation3, adaptive navigation, large-screen quality tiersreferences/compose-patterns.md- Compose patterns, Material motion, animation, side effects, modifiers, stability, and migrationsreferences/android-theming.md- Material 3 theming, spacing tokens, category style, colors, typography, shapesreferences/android-accessibility.md- accessibility, TalkBack, label copy, semantic properties, WCAGreferences/android-i18n.md- internationalization, localization, RTL support, pluralsreferences/android-notifications.md- notifications, channels, media/PiP/sharesheet, foreground servicesreferences/android-data-sync.md- offline-first, sync strategies, conflict resolutionreferences/kotlin-patterns.md- Kotlin best practices and View lifecycle interop (must-read for Kotlin code)references/coroutines-patterns.md- coroutines best practices and patternsreferences/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 Navigation3references/android-graphics.md- Material Symbols icons, adaptive launcher icons, Canvas drawing, Palette APIreferences/android-permissions.md- runtime permissions and best practicesreferences/kotlin-delegation.md- delegation patterns and composition guidancereferences/crashlytics.md- crash reporting with modular provider swapsreferences/android-strictmode.md- StrictMode guardrails and Compose stabilityreferences/android-code-coverage.md- JaCoCo code coverage setup and CI integrationreferences/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 safetyreferences/code-quality.md- Detekt setup and code quality rulesreferences/dependencies.md- dependency rules and version catalog guidancereferences/android-performance.md- Play Vitals thresholds, optional Play Developer Reporting API (CI/Slack), benchmarking, recomposition, app startup, splash screenreferences/android-debugging.md- Logcat levels, ANR timeouts, LeakCanary, R8 de-obfuscation, Gradle errors, Compose recompositionreferences/migration.md- XML to Compose, LiveData to StateFlow, RxJava, Navigation, Accompanist, Material, Edge-to-Edge, and Room 2.x → Room 3references/design-patterns.md- Android-focused design patternsassets/proguard-rules.pro.template- R8/ProGuard rules for all librariesassets/detekt.yml.template- Detekt static analysis configurationassets/libs.versions.toml.template- Version catalog with all dependenciesassets/settings.gradle.kts.template- Project settings with repositoriesassets/convention/- Gradle convention plugins,config/helpers, andQUICK_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 andsuspendDAOs) - 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.
Report Issues
Found a bug, outdated pattern, or incorrect guidance? Please report it so we can fix it.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found