{"id":42682998,"url":"https://github.com/hyperb1iss/hyperdroid-skill","last_synced_at":"2026-02-03T16:00:53.951Z","repository":{"id":335152088,"uuid":"1144052341","full_name":"hyperb1iss/hyperdroid-skill","owner":"hyperb1iss","description":"Agent skills for Android and custom ROMs","archived":false,"fork":false,"pushed_at":"2026-01-28T21:48:01.000Z","size":56,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-30T01:20:12.763Z","etag":null,"topics":["agent","android","lineageos","roms","skills"],"latest_commit_sha":null,"homepage":"https://hyperbliss.tech","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperb1iss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-28T08:28:47.000Z","updated_at":"2026-01-29T17:16:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hyperb1iss/hyperdroid-skill","commit_stats":null,"previous_names":["hyperb1iss/android-skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hyperb1iss/hyperdroid-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fhyperdroid-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fhyperdroid-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fhyperdroid-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fhyperdroid-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperb1iss","download_url":"https://codeload.github.com/hyperb1iss/hyperdroid-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fhyperdroid-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28912222,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T11:55:24.701Z","status":"ssl_error","status_checked_at":"2026-01-30T11:54:13.194Z","response_time":66,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","android","lineageos","roms","skills"],"created_at":"2026-01-29T11:55:45.382Z","updated_at":"2026-01-30T12:02:09.638Z","avatar_url":"https://github.com/hyperb1iss.png","language":"Makefile","funding_links":["https://ko-fi.com/hyperb1iss"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  🤖 hyperdroid-skill\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eMaster Android Development from App to ROM\u003c/strong\u003e\u003cbr\u003e\n  \u003csub\u003eADB wizardry • Fastboot sorcery • Custom ROM alchemy\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Skills-4_Domains-e135ff?style=for-the-badge\u0026logo=android\u0026logoColor=white\" alt=\"4 Skills\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Agent-Crash_Analyzer-80ffea?style=for-the-badge\u0026logo=robot\u0026logoColor=black\" alt=\"1 Agent\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Claude_Code-Plugin-ff6ac1?style=for-the-badge\u0026logo=anthropic\u0026logoColor=white\" alt=\"Claude Code\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/skills.sh-Compatible-f1fa8c?style=for-the-badge\u0026logo=npm\u0026logoColor=black\" alt=\"skills.sh\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hyperb1iss/hyperdroid-skill/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/hyperb1iss/hyperdroid-skill?style=flat-square\u0026logo=opensourceinitiative\u0026logoColor=white\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-what-this-is\"\u003eWhat This Is\u003c/a\u003e •\n  \u003ca href=\"#-skills\"\u003eSkills\u003c/a\u003e •\n  \u003ca href=\"#-agents\"\u003eAgents\u003c/a\u003e •\n  \u003ca href=\"#-installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#-sota-knowledge\"\u003eSOTA Knowledge\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 💎 What This Is\n\n**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.\n\nInstead of digging through Stack Overflow and XDA threads, get **domain expertise** directly:\n\n- A **device debugger** who knows logcat, tombstones, and ANR traces inside-out\n- A **fastboot specialist** who handles A/B slots, dynamic partitions, and brick prevention\n- A **build engineer** who speaks Gradle, Soong, and `lunch` fluently\n- A **LineageOS contributor** who knows Gerrit, repopick, and breakfast by heart\n\nWorks with Claude Code and any agent supporting the plugin ecosystem.\n\n## 🔮 Skills\n\nSkills are contextual knowledge bundles that auto-activate when relevant. Ask about \"adb logcat\"? The android skill loads. Mention \"flash boot image\"? Bootloader skill activates.\n\n| Skill | Domain | Triggers |\n|-------|--------|----------|\n| `android` | Device Mastery | ADB, logcat, shell, app management, UI automation, debugging |\n| `android-fastboot` | Danger Zone | Fastboot, partitions, A/B slots, recovery, Magisk, unlocking |\n| `android-build` | Build Systems | Gradle CLI, SDK manager, AOSP envsetup/lunch/m, kernels |\n| `lineageos` | Custom ROMs | breakfast/brunch, repopick, Gerrit, vendor blobs, porting |\n\n### 🎯 `android` — Device Mastery\n\nEverything about interacting with Android devices via ADB:\n\n- **Connection** — USB, wireless (`adb tcpip`), multi-device targeting\n- **Shell** — Commands, root access, file push/pull, port forwarding\n- **App Management** — Install, uninstall, start/stop activities, permissions, intents\n- **UI Automation** — Tap, swipe, text input, screenshots, screen recording\n- **Debugging** — Logcat filtering, crash analysis, memory profiling, strict mode\n- **System Inspection** — dumpsys, getprop, /proc exploration, service calls\n\n### ⚠️ `android-fastboot` — Danger Zone\n\nFastboot and bootloader operations with appropriate safety warnings:\n\n- **Fastboot Commands** — Flash, erase, boot, getvar, reboot modes\n- **Bootloader State** — Unlock, lock, OEM commands, critical partitions\n- **A/B Partitions** — Slot switching, dynamic partitions (super), metadata\n- **Recovery** — TWRP, stock recovery, sideload, OTA survival\n- **Root** — Magisk installation, boot image patching, module management\n- **Brick Prevention** — Backup strategies, critical partition protection, recovery paths\n\n### 🔧 `android-build` — Build Systems\n\nBoth app and ROM building expertise:\n\n- **Gradle CLI** — Tasks, variants, dependency resolution, build optimization\n- **SDK Tools** — sdkmanager, avdmanager, emulator management\n- **AOSP Build** — envsetup.sh, lunch targets, m/mm/mmm, ninja\n- **Device Trees** — Makefile structure, BoardConfig, device props\n- **Kernel Building** — Defconfig, cross-compilation, module building\n\n### 🌙 `lineageos` — Custom ROM Development\n\nLineageOS-specific development workflows:\n\n- **Source Management** — repo init/sync, local manifests, breakfast\n- **Building** — brunch, target selection, signed builds\n- **Gerrit Workflow** — repopick, topic branches, code review\n- **Vendor Blobs** — extract-files.sh, proprietary-files.txt, TheMuppets\n- **Device Porting** — Common trees, inheritance, bring-up process\n- **Contributing** — Commit style, Gerrit etiquette, LineageOS standards\n\n## 🦋 Agents\n\nAgents are invoked via the Task tool with `subagent_type=\"hyperdroid:agent-name\"`.\n\n| Agent | Specialty |\n|-------|-----------|\n| `hyperdroid:crash-analyzer` | Autonomous crash investigation — collects logs, tombstones, ANR traces, analyzes native crashes, provides root cause diagnosis |\n\n### Crash Analyzer\n\nWhen your app or device is misbehaving, this agent:\n\n1. Collects relevant logcat output with intelligent filtering\n2. Retrieves tombstones and native crash dumps\n3. Parses ANR traces and identifies blocked threads\n4. Correlates crashes with recent changes\n5. Provides actionable diagnosis and fix suggestions\n\n```\n\u003e My app keeps crashing on startup\n[crash-analyzer agent activates, gathers evidence, returns diagnosis]\n```\n\n## ⚡ Installation\n\n### Vercel Skills (npx)\n\n```bash\n# Install for all supported agents\nnpx skills add hyperb1iss/hyperdroid-skill\n\n# Install for a specific agent\nnpx skills add hyperb1iss/hyperdroid-skill -a cursor\nnpx skills add hyperb1iss/hyperdroid-skill -a copilot\nnpx skills add hyperb1iss/hyperdroid-skill -a codex\nnpx skills add hyperb1iss/hyperdroid-skill -a gemini\n```\n\n### Claude Code Plugin\n\n```bash\n# Add the marketplace\n/plugin marketplace add hyperb1iss/hyperdroid-skill\n\n# Install the plugin\n/plugin install hyperdroid\n```\n\n### Manual\n\n```bash\ngit clone https://github.com/hyperb1iss/hyperdroid-skill.git\nln -s $(pwd)/hyperdroid-skill ~/.claude/plugins/hyperdroid-skill\n```\n\n### Test Locally\n\n```bash\nclaude --plugin-dir ./hyperdroid-skill\n```\n\n### Compatibility\n\n| Platform | Install Method |\n|----------|----------------|\n| **Claude Code** | `/plugin marketplace add hyperb1iss/hyperdroid-skill` |\n| **Vercel Skills** | `npx skills add hyperb1iss/hyperdroid-skill` |\n| **Codex CLI** | `npx skills add hyperb1iss/hyperdroid-skill -a codex` |\n| **Cursor** | `npx skills add hyperb1iss/hyperdroid-skill -a cursor` |\n| **GitHub Copilot** | `npx skills add hyperb1iss/hyperdroid-skill -a copilot` |\n| **Gemini CLI** | `npx skills add hyperb1iss/hyperdroid-skill -a gemini` |\n| **Amp** | `npx skills add hyperb1iss/hyperdroid-skill -a amp` |\n| **Opencode** | `npx skills add hyperb1iss/hyperdroid-skill -a opencode` |\n\n## 🎯 Usage\n\nSkills activate automatically based on context:\n\n```\n\u003e Connect to my Android device wirelessly\n[android skill activates — guides through adb tcpip setup]\n\n\u003e Flash the custom boot image I just built\n[android-fastboot skill activates — provides safe fastboot workflow]\n\n\u003e Build LineageOS for my Pixel 8\n[lineageos skill activates — walks through breakfast/brunch process]\n\n\u003e Why does my app crash when rotating the screen?\n[crash-analyzer agent investigates lifecycle issues]\n```\n\nOr invoke directly:\n\n```bash\n/hyperdroid-skill:android              # Device interaction guidance\n/hyperdroid-skill:android-fastboot   # Fastboot and recovery\n/hyperdroid-skill:android-build        # Build system expertise\n/hyperdroid-skill:lineageos            # Custom ROM development\n```\n\n## 🧪 SOTA Knowledge\n\nEvery skill is enhanced with modern Android development knowledge (2024-2026):\n\n### Device Interaction\n\n- **Wireless ADB** — Direct WiFi pairing (Android 11+), no USB required\n- **scrcpy Integration** — Screen mirroring, wireless debugging, input injection\n- **Multi-Device** — Serial targeting, parallel operations, device farms\n- **Automation** — UI Automator 2, Espresso test orchestration, macro recording\n\n### Build Systems\n\n- **Gradle 8.x** — Configuration cache, build scans, dependency verification\n- **AGP 8.x** — Baseline profiles, R8 full mode, app bundles\n- **Kotlin DSL** — Type-safe build scripts, convention plugins\n- **Version Catalogs** — Centralized dependency management (libs.versions.toml)\n\n### AOSP/LineageOS\n\n- **Soong** — Blueprint files, Android.bp, module types\n- **Bazel Migration** — Mixed Soong/Bazel builds, aquery debugging\n- **GKI 2.0** — Generic Kernel Image, DLKM modules, vendor_dlkm\n- **Treble** — HIDL/AIDL interfaces, vendor partitions, GSI compatibility\n- **Dynamic Partitions** — super partition, resize operations, snapshot merges\n\n### Security \u0026 Root\n\n- **Magisk 26+** — Zygisk, DenyList, module development\n- **KernelSU** — Kernel-level root, module compatibility\n- **SafetyNet/Play Integrity** — Attestation, device integrity, hiding root\n- **SELinux** — Policy debugging, permissive domains, audit2allow\n\n### Debugging\n\n- **Perfetto** — System tracing, custom trace points, SQL analysis\n- **Simpleperf** — CPU profiling, flame graphs, hardware PMU\n- **Memory Profiler** — Heap dumps, allocation tracking, leak detection\n- **Network Profiler** — Traffic inspection, certificate pinning bypass\n\n## 📦 Structure\n\n```\nhyperdroid-skill/\n├── .claude-plugin/\n│   ├── plugin.json              # Claude Code manifest\n│   └── marketplace.json         # skills.sh distribution index\n├── AGENTS.md                    # Agent compatibility registry\n├── skills/\n│   ├── android/\n│   │   ├── SKILL.md             # Quick reference + triggers\n│   │   └── references/          # Deep documentation\n│   │       └── deep-dive.md     # Advanced ADB techniques\n│   ├── android-fastboot/\n│   │   ├── SKILL.md\n│   │   └── references/\n│   │       └── partitions.md    # Partition layouts \u0026 safety\n│   ├── android-build/\n│   │   ├── SKILL.md\n│   │   └── references/\n│   │       ├── aosp.md          # AOSP build deep dive\n│   │       └── lineageos.md     # LineageOS specifics\n│   └── lineageos/\n│       ├── SKILL.md\n│       └── references/\n│           └── gerrit-workflow.md\n├── agents/\n│   └── crash-analyzer.md        # Autonomous crash investigation\n├── research/                    # Development references (not in plugin)\n├── Makefile                     # Lint, format, validate\n└── README.md\n```\n\n## 🔧 Development\n\n```bash\n# Clone\ngit clone https://github.com/hyperb1iss/hyperdroid-skill.git\ncd hyperdroid-skill\n\n# Lint \u0026 format\nmake lint\nmake format\n\n# Validate structure\nmake check\n\n# Show stats\nmake stats\n\n# Test locally\nclaude --plugin-dir .\n```\n\n## 💜 Philosophy\n\nThese skills embody the Android power-user methodology:\n\n| Principle | What It Means |\n|-----------|---------------|\n| **Know the internals** | Understanding dumpsys, getprop, and /proc makes you dangerous |\n| **Respect the danger** | Bootloader operations get explicit warnings — we don't brick devices |\n| **Build from source** | Whether app or ROM, know your build system inside-out |\n| **Debug systematically** | Logcat + tombstones + ANR traces = root cause, not guesswork |\n| **Give back** | LineageOS thrives on contributors — learn the Gerrit workflow |\n\n## 📚 Reference Materials\n\nThe `research/` directory contains extensive reference documentation used during skill development:\n\n- **ADB mastery** — Every flag, every trick\n- **Fastboot internals** — Partition tables, A/B mechanics\n- **AOSP build system** — Soong, ninja, make\n- **Kernel building** — Defconfigs, modules, GKI\n- **Debugging tools** — Perfetto, simpleperf, memory analysis\n\n## License\n\nLicensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hyperb1iss/hyperdroid-skill\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/hyperb1iss/hyperdroid-skill?style=social\" alt=\"Star on GitHub\"\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\u0026nbsp;\n  \u003ca href=\"https://ko-fi.com/hyperb1iss\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Ko--fi-Support%20Development-ff5e5b?logo=ko-fi\u0026logoColor=white\" alt=\"Ko-fi\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/hyperb1iss\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/GitHub-hyperb1iss-181717?style=for-the-badge\u0026logo=github\" alt=\"GitHub\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://bsky.app/profile/hyperbliss.tech\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Bluesky-@hyperbliss.tech-1185fe?style=for-the-badge\u0026logo=bluesky\" alt=\"Bluesky\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003e\n    If this helps you master Android development, give us a ⭐ or \u003ca href=\"https://ko-fi.com/hyperb1iss\"\u003esupport the project\u003c/a\u003e\n    \u003cbr\u003e\u003cbr\u003e\n    ✦ Built with obsession by \u003ca href=\"https://hyperbliss.tech\"\u003e\u003cstrong\u003eHyperbliss Technologies\u003c/strong\u003e\u003c/a\u003e ✦\n  \u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperb1iss%2Fhyperdroid-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperb1iss%2Fhyperdroid-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperb1iss%2Fhyperdroid-skill/lists"}