claude-android-ninja

skill
Security Audit
Pass
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
Purpose
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.
SUMMARY

Agent Skill for Android development with Kotlin and Jetpack Compose, covering modular architecture, Navigation3, Gradle conventions, dependency management, and testing best practices.

README.md

Android Agent Skill

Kotlin
AGP
Min SDK
Target SDK

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

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

Reviews (0)

No results found