<h1 align="center">
๐ค hyperdroid-skill
</h1>
<p align="center">
<strong>Master Android Development from App to ROM</strong><br>
<sub>ADB wizardry โข Fastboot sorcery โข Custom ROM alchemy</sub>
</p>
<p align="center">
<img src="https://img.shields.io/badge/Skills-4_Domains-e135ff?style=for-the-badge&logo=android&logoColor=white" alt="4 Skills">
<img src="https://img.shields.io/badge/Agent-Crash_Analyzer-80ffea?style=for-the-badge&logo=robot&logoColor=black" alt="1 Agent">
<img src="https://img.shields.io/badge/Claude_Code-Plugin-ff6ac1?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Code">
<img src="https://img.shields.io/badge/skills.sh-Compatible-f1fa8c?style=for-the-badge&logo=npm&logoColor=black" alt="skills.sh">
</p>
<p align="center">
<a href="https://github.com/hyperb1iss/hyperdroid-skill/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/hyperb1iss/hyperdroid-skill?style=flat-square&logo=opensourceinitiative&logoColor=white" alt="License">
</a>
</p>
<p align="center">
<a href="#-what-this-is">What This Is</a> โข
<a href="#-skills">Skills</a> โข
<a href="#-agents">Agents</a> โข
<a href="#-installation">Installation</a> โข
<a href="#-sota-knowledge">SOTA Knowledge</a>
</p>
---
## ๐ What This Is
**hyperdroid-skill** is an elite Claude Code plugin for Android developmentโfrom debugging a misbehaving app to building entire custom ROMs. Whether you're a hobbyist flasher or a full-time ROM maintainer, these skills have you covered.
Instead of digging through Stack Overflow and XDA threads, get **domain expertise** directly:
- A **device debugger** who knows logcat, tombstones, and ANR traces inside-out
- A **fastboot specialist** who handles A/B slots, dynamic partitions, and brick prevention
- A **build engineer** who speaks Gradle, Soong, and `lunch` fluently
- A **LineageOS contributor** who knows Gerrit, repopick, and breakfast by heart
Works with Claude Code and any agent supporting the plugin ecosystem.
## ๐ฎ Skills
Skills are contextual knowledge bundles that auto-activate when relevant. Ask about "adb logcat"? The android skill loads. Mention "flash boot image"? Bootloader skill activates.
| Skill | Domain | Triggers |
|-------|--------|----------|
| `android` | Device Mastery | ADB, logcat, shell, app management, UI automation, debugging |
| `android-fastboot` | Danger Zone | Fastboot, partitions, A/B slots, recovery, Magisk, unlocking |
| `android-build` | Build Systems | Gradle CLI, SDK manager, AOSP envsetup/lunch/m, kernels |
| `lineageos` | Custom ROMs | breakfast/brunch, repopick, Gerrit, vendor blobs, porting |
### ๐ฏ `android` โ Device Mastery
Everything about interacting with Android devices via ADB:
- **Connection** โ USB, wireless (`adb tcpip`), multi-device targeting
- **Shell** โ Commands, root access, file push/pull, port forwarding
- **App Management** โ Install, uninstall, start/stop activities, permissions, intents
- **UI Automation** โ Tap, swipe, text input, screenshots, screen recording
- **Debugging** โ Logcat filtering, crash analysis, memory profiling, strict mode
- **System Inspection** โ dumpsys, getprop, /proc exploration, service calls
### โ ๏ธ `android-fastboot` โ Danger Zone
Fastboot and bootloader operations with appropriate safety warnings:
- **Fastboot Commands** โ Flash, erase, boot, getvar, reboot modes
- **Bootloader State** โ Unlock, lock, OEM commands, critical partitions
- **A/B Partitions** โ Slot switching, dynamic partitions (super), metadata
- **Recovery** โ TWRP, stock recovery, sideload, OTA survival
- **Root** โ Magisk installation, boot image patching, module management
- **Brick Prevention** โ Backup strategies, critical partition protection, recovery paths
### ๐ง `android-build` โ Build Systems
Both app and ROM building expertise:
- **Gradle CLI** โ Tasks, variants, dependency resolution, build optimization
- **SDK Tools** โ sdkmanager, avdmanager, emulator management
- **AOSP Build** โ envsetup.sh, lunch targets, m/mm/mmm, ninja
- **Device Trees** โ Makefile structure, BoardConfig, device props
- **Kernel Building** โ Defconfig, cross-compilation, module building
### ๐ `lineageos` โ Custom ROM Development
LineageOS-specific development workflows:
- **Source Management** โ repo init/sync, local manifests, breakfast
- **Building** โ brunch, target selection, signed builds
- **Gerrit Workflow** โ repopick, topic branches, code review
- **Vendor Blobs** โ extract-files.sh, proprietary-files.txt, TheMuppets
- **Device Porting** โ Common trees, inheritance, bring-up process
- **Contributing** โ Commit style, Gerrit etiquette, LineageOS standards
## ๐ฆ Agents
Agents are invoked via the Task tool with `subagent_type="hyperdroid:agent-name"`.
| Agent | Specialty |
|-------|-----------|
| `hyperdroid:crash-analyzer` | Autonomous crash investigation โ collects logs, tombstones, ANR traces, analyzes native crashes, provides root cause diagnosis |
### Crash Analyzer
When your app or device is misbehaving, this agent:
1. Collects relevant logcat output with intelligent filtering
2. Retrieves tombstones and native crash dumps
3. Parses ANR traces and identifies blocked threads
4. Correlates crashes with recent changes
5. Provides actionable diagnosis and fix suggestions
```
> My app keeps crashing on startup
[crash-analyzer agent activates, gathers evidence, returns diagnosis]
```
## โก Installation
### Vercel Skills (npx)
```bash
# Install for all supported agents
npx skills add hyperb1iss/hyperdroid-skill
# Install for a specific agent
npx skills add hyperb1iss/hyperdroid-skill -a cursor
npx skills add hyperb1iss/hyperdroid-skill -a copilot
npx skills add hyperb1iss/hyperdroid-skill -a codex
npx skills add hyperb1iss/hyperdroid-skill -a gemini
```
### Claude Code Plugin
```bash
# Add the marketplace
/plugin marketplace add hyperb1iss/hyperdroid-skill
# Install the plugin
/plugin install hyperdroid
```
### Manual
```bash
git clone https://github.com/hyperb1iss/hyperdroid-skill.git
ln -s $(pwd)/hyperdroid-skill ~/.claude/plugins/hyperdroid-skill
```
### Test Locally
```bash
claude --plugin-dir ./hyperdroid-skill
```
### Compatibility
| Platform | Install Method |
|----------|----------------|
| **Claude Code** | `/plugin marketplace add hyperb1iss/hyperdroid-skill` |
| **Vercel Skills** | `npx skills add hyperb1iss/hyperdroid-skill` |
| **Codex CLI** | `npx skills add hyperb1iss/hyperdroid-skill -a codex` |
| **Cursor** | `npx skills add hyperb1iss/hyperdroid-skill -a cursor` |
| **GitHub Copilot** | `npx skills add hyperb1iss/hyperdroid-skill -a copilot` |
| **Gemini CLI** | `npx skills add hyperb1iss/hyperdroid-skill -a gemini` |
| **Amp** | `npx skills add hyperb1iss/hyperdroid-skill -a amp` |
| **Opencode** | `npx skills add hyperb1iss/hyperdroid-skill -a opencode` |
## ๐ฏ Usage
Skills activate automatically based on context:
```
> Connect to my Android device wirelessly
[android skill activates โ guides through adb tcpip setup]
> Flash the custom boot image I just built
[android-fastboot skill activates โ provides safe fastboot workflow]
> Build LineageOS for my Pixel 8
[lineageos skill activates โ walks through breakfast/brunch process]
> Why does my app crash when rotating the screen?
[crash-analyzer agent investigates lifecycle issues]
```
Or invoke directly:
```bash
/hyperdroid-skill:android # Device interaction guidance
/hyperdroid-skill:android-fastboot # Fastboot and recovery
/hyperdroid-skill:android-build # Build system expertise
/hyperdroid-skill:lineageos # Custom ROM development
```
## ๐งช SOTA Knowledge
Every skill is enhanced with modern Android development knowledge (2024-2026):
### Device Interaction
- **Wireless ADB** โ Direct WiFi pairing (Android 11+), no USB required
- **scrcpy Integration** โ Screen mirroring, wireless debugging, input injection
- **Multi-Device** โ Serial targeting, parallel operations, device farms
- **Automation** โ UI Automator 2, Espresso test orchestration, macro recording
### Build Systems
- **Gradle 8.x** โ Configuration cache, build scans, dependency verification
- **AGP 8.x** โ Baseline profiles, R8 full mode, app bundles
- **Kotlin DSL** โ Type-safe build scripts, convention plugins
- **Version Catalogs** โ Centralized dependency management (libs.versions.toml)
### AOSP/LineageOS
- **Soong** โ Blueprint files, Android.bp, module types
- **Bazel Migration** โ Mixed Soong/Bazel builds, aquery debugging
- **GKI 2.0** โ Generic Kernel Image, DLKM modules, vendor_dlkm
- **Treble** โ HIDL/AIDL interfaces, vendor partitions, GSI compatibility
- **Dynamic Partitions** โ super partition, resize operations, snapshot merges
### Security & Root
- **Magisk 26+** โ Zygisk, DenyList, module development
- **KernelSU** โ Kernel-level root, module compatibility
- **SafetyNet/Play Integrity** โ Attestation, device integrity, hiding root
- **SELinux** โ Policy debugging, permissive domains, audit2allow
### Debugging
- **Perfetto** โ System tracing, custom trace points, SQL analysis
- **Simpleperf** โ CPU profiling, flame graphs, hardware PMU
- **Memory Profiler** โ Heap dumps, allocation tracking, leak detection
- **Network Profiler** โ Traffic inspection, certificate pinning bypass
## ๐ฆ Structure
```
hyperdroid-skill/
โโโ .claude-plugin/
โ โโโ plugin.json # Claude Code manifest
โ โโโ marketplace.json # skills.sh distribution index
โโโ AGENTS.md # Agent compatibility registry
โโโ skills/
โ โโโ android/
โ โ โโโ SKILL.md # Quick reference + triggers
โ โ โโโ references/ # Deep documentation
โ โ โโโ deep-dive.md # Advanced ADB techniques
โ โโโ android-fastboot/
โ โ โโโ SKILL.md
โ โ โโโ references/
โ โ โโโ partitions.md # Partition layouts & safety
โ โโโ android-build/
โ โ โโโ SKILL.md
โ โ โโโ references/
โ โ โโโ aosp.md # AOSP build deep dive
โ โ โโโ lineageos.md # LineageOS specifics
โ โโโ lineageos/
โ โโโ SKILL.md
โ โโโ references/
โ โโโ gerrit-workflow.md
โโโ agents/
โ โโโ crash-analyzer.md # Autonomous crash investigation
โโโ research/ # Development references (not in plugin)
โโโ Makefile # Lint, format, validate
โโโ README.md
```
## ๐ง Development
```bash
# Clone
git clone https://github.com/hyperb1iss/hyperdroid-skill.git
cd hyperdroid-skill
# Lint & format
make lint
make format
# Validate structure
make check
# Show stats
make stats
# Test locally
claude --plugin-dir .
```
## ๐ Philosophy
These skills embody the Android power-user methodology:
| Principle | What It Means |
|-----------|---------------|
| **Know the internals** | Understanding dumpsys, getprop, and /proc makes you dangerous |
| **Respect the danger** | Bootloader operations get explicit warnings โ we don't brick devices |
| **Build from source** | Whether app or ROM, know your build system inside-out |
| **Debug systematically** | Logcat + tombstones + ANR traces = root cause, not guesswork |
| **Give back** | LineageOS thrives on contributors โ learn the Gerrit workflow |
## ๐ Reference Materials
The `research/` directory contains extensive reference documentation used during skill development:
- **ADB mastery** โ Every flag, every trick
- **Fastboot internals** โ Partition tables, A/B mechanics
- **AOSP build system** โ Soong, ninja, make
- **Kernel building** โ Defconfigs, modules, GKI
- **Debugging tools** โ Perfetto, simpleperf, memory analysis
## License
Licensed under the MIT License. See [LICENSE](LICENSE) for details.
---
<p align="center">
<a href="https://github.com/hyperb1iss/hyperdroid-skill">
<img src="https://img.shields.io/github/stars/hyperb1iss/hyperdroid-skill?style=social" alt="Star on GitHub">
</a>
<a href="https://ko-fi.com/hyperb1iss">
<img src="https://img.shields.io/badge/Ko--fi-Support%20Development-ff5e5b?logo=ko-fi&logoColor=white" alt="Ko-fi">
</a>
</p>
<p align="center">
<a href="https://github.com/hyperb1iss">
<img src="https://img.shields.io/badge/GitHub-hyperb1iss-181717?style=for-the-badge&logo=github" alt="GitHub">
</a>
<a href="https://bsky.app/profile/hyperbliss.tech">
<img src="https://img.shields.io/badge/Bluesky-@hyperbliss.tech-1185fe?style=for-the-badge&logo=bluesky" alt="Bluesky">
</a>
</p>
<p align="center">
<sub>
If this helps you master Android development, give us a โญ or <a href="https://ko-fi.com/hyperb1iss">support the project</a>
<br><br>
โฆ Built with obsession by <a href="https://hyperbliss.tech"><strong>Hyperbliss Technologies</strong></a> โฆ
</sub>
</p>