ayush016/android-lead-agent-skills

---

What This Actually Does

Claude already knows what Hilt, Room, and Compose are. You don’t need to teach it Android.

What you do need is for every AI-generated screen in your project to follow your architectural decisions — your spacing grid, your state modelling pattern, your animation standards, your colour token hierarchy. Without a skill, Claude will make different choices on different days, and your codebase slowly diverges.

This skill is a team standards document for AI. Install it once. Every Claude Code session — yours, your teammates’, your CI’s — follows the same patterns.

Without skill → Claude produces correct-but-generic Android code
With skill    → Claude produces your project's Android code

---

What You Get

---

Coverage

---

Sample App

Luminary — a news reader built entirely with this skill. Demonstrates shared element transitions, full 29-role colour system, skeleton loading, staggered animations, and Clean Architecture end-to-end.

Every pattern in that codebase traces to a specific section of this skill.

---

Installation

For Claude Code (project-local — recommended for teams)

# From your project root
git clone https://github.com/ayush016/android-lead-agent-skills.git \
  .claude/skills/android

Add to your project’s CLAUDE.md:

## Active Skills

- **android**: `.claude/skills/android/SKILL.md`
  Covers architecture, Compose, animations, theming, navigation, security, performance, testing, and more.

For Claude Code (user-global — personal use)

mkdir -p ~/.claude/skills
git clone https://github.com/ayush016/android-lead-agent-skills.git \
  ~/.claude/skills/android

Add to ~/.claude/CLAUDE.md:

## Skills
- android: ~/.claude/skills/android/SKILL.md

For other AI assistants (Copilot, Cursor, Gemini)

Copy SKILL.md into the relevant rules/instructions location for your tool:

---

How to Invoke

Automatic (Claude Code)

The skill auto-loads when it detects Android-related work — any .kt file with Compose imports, mentions of ViewModel / Hilt / Room / Coroutines, Gradle config, or ADB / MCP usage.

Explicit reference

Using the android skill, build a product detail screen with a shared element 
transition from the list thumbnail. Use the offline-first data layer pattern.

Review this composable against the android skill's UI excellence checklist.

Using the android skill, set up Baseline Profiles and Macrobenchmark 
for the critical cold-start and scroll paths.

---

What This Skill Does NOT Do

Be clear-eyed about limitations:

• It does not make Claude write bug-free code. Code generation still requires review and testing. The skill shapes patterns and architecture decisions, not syntax correctness.
• It does not replace documentation. The official Android Developer docs, Material 3 guidelines, and Kotlin references are always the authoritative source. This skill synthesises patterns from them.
• It will get stale. Android APIs evolve fast. Compose BOM, Navigation, AGP versions listed here will not be the latest in 12 months. Check the dates and update your pinned versions accordingly.
• It won’t fit entirely in one context window. 8,500+ lines of content means Claude works from the most relevant sections. For very complex tasks, reference the specific file explicitly.

---

File Structure

android-lead-agent-skills/
│
├── SKILL.md                              ← Load this into your AI tool
│
├── references/                           ← Deep-dive guides (load on demand)
│   ├── theming-and-color.md             ★ All 29 M3 roles, 3-layer tokens
│   ├── shared-element-transitions.md    ★ 4 full Kotlin patterns + 6 pitfalls
│   ├── compose-ui-system.md             ★ Design system, shimmer, gradients
│   ├── motion-and-animation.md          ★ Spring physics, Canvas, choreography
│   ├── navigation.md                      Type-safe nav, deep links, multi-module
│   ├── architecture.md                    ViewModel, state, DI, Clean Architecture
│   ├── adaptive-layouts.md               WindowSizeClass, foldables, insets
│   ├── coroutines-and-flow.md            Dispatchers, operators, cancellation
│   ├── data-layer.md                      Offline-first, Room, Retrofit
│   ├── performance.md                     Baseline Profiles, R8, recomposition
│   ├── security.md                        Encryption, biometrics, cert pinning
│   ├── background-work.md               WorkManager, Foreground Services, Alarms
│   ├── image-loading.md                  Coil3, SubcomposeAsyncImage, caching
│   ├── notifications.md                   FCM, channels, action receivers
│   ├── accessibility.md                   Semantics, TalkBack, WCAG AA
│   ├── testing.md                         Roborazzi, Turbine, fakes
│   ├── build-and-modules.md             Gradle, convention plugins, bootstrap
│   └── android-mcp.md                   ADB, screenshot review, debugging
│
└── assets/
    └── ui-excellence-checklist.md       ← 29-item binary quality gate

Files marked ★ are the most impactful — start here if you’re evaluating the skill.

---

Compatibility

Versions are pinned at time of last update. Always verify against the official AGP compatibility table before upgrading.

---

Contributing

The skill improves when patterns fail in the real world. Open a PR if:

• An API listed here is deprecated or has a better replacement
• A pattern caused a compilation error or runtime bug
• A domain is missing (e.g., CameraX, Media3, Wear OS)
• You have a better code example for an existing pattern

PR format: Include the specific file and section, the problem with the current content, the replacement, and ideally a link to the relevant Android documentation.

---

License

MIT © 2025 Ayush Shrivastava KARIKALCHOLAN

See LICENSE for full terms. TL;DR: use it, fork it, build on it — attribution appreciated but not required.

---