Android & Engineering Skill Router (android-skill-derek)

Entry point and router for specialized Android development, device verification, multi-agent orchestration, release CI/CD, and document conversion workflows. Inspect the user's request, resolve SKILL_ROOT and the persistent coordinator cache in ~/.config/android-skill-derek/, and load the matching sub-skill module(s) below.

When to Use

• Designing or building Android apps with Material Design 3 (or a custom design language), a themed Shared Component Gallery, deterministic Dummy Data, and safe Debug/Release Signing Keys
• Discovering, leasing, waking, unlocking (with PIN/passcode), and auditing StageDroid, physical, wireless, or Google CLI virtual (AVD) test devices across screen sizes, densities, cutouts, and system bars
• Orchestrating feature-named sub-agents across isolated git worktrees in Manual vs. Automatic mode, executing the Coordinator Cycle Workflow (sweep, check progress and merge, run the cycle, /cycle), assigning scarce test devices, testing rebased branches on device, triaging bugs (fix on the spot vs. send back), and cleaning up worktrees after merge
• Cutting, tagging, or configuring CI/CD for a stable (v1.2.3) or beta (beta_1.2.3) release with explicit per-tag human approval
• Converting documents, PDFs, Office files, images, audio, or archives into Markdown via uvx markitdown
• Architecting, implementing, or reviewing Android & Kotlin Multiplatform (KMP) features following Philipp Lackner's conventions: feature-layered module boundaries, MVI presentation (single State, sealed Action, Channel Event, Root/Screen composables, SavedStateHandle), type-safe Compose Navigation, Koin dependency injection, offline-first data layer (Room, Ktor, DTOs, mappers), typed error handling (Result/DataError), unit tests (JUnit 5 + AssertK + Turbine), reusable Compose components, or GitHub PR reviewer quizzes

Path & Persistent Cache Resolution

1. Resolve SKILL_ROOT: Set SKILL_ROOT to the directory containing this root SKILL.md file (for example, ~/.agents/skills/android-skill-derek when installed globally via npx skills add -g, or ./.agents/skills/android-skill-derek when installed locally). Always reference sub-skills, scripts, and assets via $SKILL_ROOT/<sub-skill>/....
2. Maintain Long-Lived Coordinator Cache (~/.config/android-skill-derek/):
   • Run bash "$SKILL_ROOT/android-agent-orchestration/scripts/detect-env.sh" to load user preferences from ~/.config/android-skill-derek/config.json and auto-detect installed harnesses (orca, claude, antigravity, gemini, codex, opencode), spec tools (openspec), memory services (@agentmemory/agentmemory), and Android SDK/device tools (adb, emulator, avdmanager, sdkmanager, scrcpy, tailscale).
   • Keep ~/.config/android-skill-derek/cache/, devices.json, and config.json persistent across sessions so device passcodes, active leases, live StageDroid /skill specs, architectural digests, and tool preferences are remembered long-term.