OpenSkillIndex← back to search
claude-codeautomation

Claude-skill-registry adb-magisk-installer

Complete Magisk system installation - from initial app setup to full system integration

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/adb-magisk-installer" ~/.claude/skills/majiayu000-claude-skill-registry-adb-magisk-installer && rm -rf "$T"
manifest: skills/data/adb-magisk-installer/SKILL.md
tags
#adb-installation#magisk-setup#boot-patching#fastboot-flashing#system-integration
source content

Quick Reference (30 seconds)

Complete Magisk System Installation

What It Does: Fully automates Magisk system installation from scratch. Handles app installation, boot image extraction, patching, and flashing. Transforms "Installed: N/A" to "Installed: Yes".

Core Capabilities:

  • 📥 Download: Get latest Magisk APK and files from GitHub
  • 📱 App Install: Install Magisk Manager via adb install
  • 💾 Boot Extract: Pull boot.img from device
  • 🔧 Boot Patch: Patch boot image using Magisk
  • ⚡ Boot Flash: Flash patched image via fastboot

When to Use:

  • Device shows "Installed: N/A" (Magisk not system-integrated)
  • Fresh Magisk setup needed
  • Upgrading Magisk version (27.0 → 30.6)
  • Boot image needs patching

Device Status Meaning:

  • ✅ 
    Installed: Yes
    - Magisk integrated with system
  • ⚠️ 
    Installed: N/A
    - App installed, but boot image not patched/flashed
  • ❌ 
    Installed: No
    - Magisk app not installed

Installation Workflow

The complete Magisk installation process (magisk-complete-install.toon):

Phase 1: Download & Prepare

  • Download Magisk APK from GitHub releases
  • Download matching boot image (device-specific)
  • Stage files on device storage (/sdcard)

Phase 2: Install App

  • Push Magisk Manager APK to device
  • Install via 
    adb install
  • Verify app launches successfully

Phase 3: Extract Boot Image

  • Connect via adb
  • Extract boot.img from active partition
  • Store locally for patching

Phase 4: Patch Boot Image

  • Launch Magisk Manager app
  • Select boot image for patching
  • Magisk generates patched_boot.img
  • Pull patched image from device

Phase 5: Flash Boot Image

  • Enable USB fastboot mode
  • Flash patched_boot.img via fastboot
  • Verify installation
  • Device reboots with Magisk integrated

Scripts

adb-magisk-download.py

Download latest Magisk APK and boot image from GitHub releases.

# Download latest version
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --output-dir /tmp/magisk

# Download specific version
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --version 30.6 \
    --output-dir /tmp/magisk

# Include boot image
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --version 30.6 \
    --include-boot \
    --output-dir /tmp/magisk

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-download.py \
    --version 30.6 \
    --json

adb-magisk-install-app.py

Install Magisk Manager APK via adb install.

# Install APK on device
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk

# Force reinstall
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk \
    --force

# Verify after install
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk \
    --verify

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-install-app.py \
    --device 127.0.0.1:5555 \
    --apk-path /tmp/magisk/Magisk-v30.6.apk \
    --json

adb-magisk-extract-boot.py

Extract boot.img from device via adb pull.

# Extract boot image (auto-detects active partition)
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --output-path /tmp/magisk/boot.img

# Extract from specific partition
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --partition boot_a \
    --output-path /tmp/magisk/boot_a.img

# Verify integrity
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --output-path /tmp/magisk/boot.img \
    --verify

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-extract-boot.py \
    --device 127.0.0.1:5555 \
    --output-path /tmp/magisk/boot.img \
    --json

adb-magisk-patch-boot.py

Patch boot image using Magisk Manager app.

# Patch boot image (interactive via Magisk app)
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img

# Wait for patching to complete
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img \
    --wait-completion

# Download patched image automatically
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img \
    --output-path /tmp/magisk/patched_boot.img

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-patch-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /sdcard/boot.img \
    --json

adb-magisk-flash-boot.py

Flash patched boot image via fastboot.

# Flash patched boot image
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img

# Flash to specific partition
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --partition boot_b

# Auto-reboot after flash
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --reboot

# Verify before flashing
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --verify

# JSON output
uv run .claude/skills/adb-magisk-installer/scripts/adb-magisk-flash-boot.py \
    --device 127.0.0.1:5555 \
    --boot-path /tmp/magisk/patched_boot.img \
    --json

Workflows

magisk-complete-install.toon

Complete Magisk installation from scratch (14 steps, ~15 minutes).

name: Complete Magisk Installation
description: Full system installation from "Installed: N/A" to "Installed: Yes"

parameters:
  device: "127.0.0.1:5555"
  version: "latest"
  timeout: 900

phases:
  - id: phase1_download
    name: Download Magisk Files
    steps:
      - id: download_apk
        action: adb-magisk-download
        params:
          version: "{{ version }}"
          include_boot: true
          output_dir: "/tmp/magisk"

  - id: phase2_app_install
    name: Install Magisk Manager App
    steps:
      - id: push_apk
        action: adb-magisk-install-app
        params:
          device: "{{ device }}"
          apk_path: "/tmp/magisk/Magisk-v{{ version }}.apk"
          force: true

      - id: verify_app
        action: adb-magisk-launch
        params:
          device: "{{ device }}"
          timeout: 15

  - id: phase3_extract_boot
    name: Extract Boot Image
    steps:
      - id: extract
        action: adb-magisk-extract-boot
        params:
          device: "{{ device }}"
          output_path: "/tmp/magisk/boot.img"

  - id: phase4_push_boot
    name: Push Boot to Device Storage
    steps:
      - id: push
        action: adb-push
        params:
          device: "{{ device }}"
          local: "/tmp/magisk/boot.img"
          remote: "/sdcard/boot.img"

  - id: phase5_patch_boot
    name: Patch Boot Image via Magisk
    steps:
      - id: open_magisk
        action: adb-magisk-launch
        params:
          device: "{{ device }}"

      - id: navigate_to_install
        action: adb-tap
        params:
          device: "{{ device }}"
          x: 100
          y: 400

      - id: select_boot
        action: adb-file-select
        params:
          path: "/sdcard/boot.img"

      - id: wait_patch
        action: adb-wait-for
        params:
          method: text
          target: "Patching complete"
          timeout: 120

  - id: phase6_pull_patched
    name: Pull Patched Boot Image
    steps:
      - id: pull
        action: adb-pull
        params:
          device: "{{ device }}"
          remote: "/sdcard/Download/magisk_patched*.img"
          local: "/tmp/magisk/patched_boot.img"

  - id: phase7_reboot_fastboot
    name: Reboot to Fastboot Mode
    steps:
      - id: reboot
        action: adb-reboot
        params:
          device: "{{ device }}"
          mode: fastboot

      - id: wait_fastboot
        action: adb-wait-fastboot
        params:
          device: "{{ device }}"
          timeout: 30

  - id: phase8_flash_boot
    name: Flash Patched Boot Image
    steps:
      - id: flash
        action: adb-magisk-flash-boot
        params:
          device: "{{ device }}"
          boot_path: "/tmp/magisk/patched_boot.img"
          reboot: true

      - id: wait_boot
        action: adb-wait-device
        params:
          device: "{{ device }}"
          timeout: 60

  - id: phase9_verify_installation
    name: Verify Magisk Installation
    steps:
      - id: launch_app
        action: adb-magisk-launch
        params:
          device: "{{ device }}"
          wait_text: "Installed"
          timeout: 30

recovery:
  - on_error: phase5_patch_boot
    action: retry
    max_attempts: 2
    delay: 5

  - on_error: phase8_flash_boot
    action: adb-screenshot-capture
    then: pause

Decision Logic Integration

This skill follows IndieDevDan Decision Logic Framework patterns:

Decision Point 1: Is Magisk Installed?

Device Status Check:
├─ Installed: Yes → Use adb-magisk skill
├─ Installed: No (app missing) → Phase 2 (install app)
└─ Installed: N/A (boot not patched) → Full workflow (Phase 1-9)

Decision Point 2: Which Installation Method?

Installation Selection:
├─ Fresh device → Full workflow (download → install → patch → flash)
├─ App exists, needs patching → Skip Phase 1-2, start Phase 3
└─ Upgrade from older version → Full workflow with version override

Decision Point 3: Boot Image Management

Boot Image Strategy:
├─ Extract → Patch → Flash workflow
├─ Auto-detect active partition (boot_a or boot_b)
├─ Verify integrity before flashing
└─ Rollback strategy if patch fails

Integration Points

Depends On:

  • adb-screen-detection
    (screenshot, OCR for "Patching complete")
  • adb-navigation-base
    (tap, swipe, wait-for actions)
  • adb-uiautomator
    (UI element interaction)
  • adb-workflow-orchestrator
    (workflow execution and phase management)

Used By:

  • adb-karrot
    (requires Magisk+PlayIntegrityFork for bypass)
  • Any automation requiring system-level modifications
  • ADB Auto Player setup workflows

External Integration:

  • GitHub API (download Magisk releases)
  • Fastboot protocol (flash boot images)
  • ADB protocol (device communication)

Troubleshooting

"Installed: N/A" doesn't change after flashing

  • Boot image may not be flashable on this device
  • Try alternative partition (boot_b instead of boot_a)
  • Some devices require vendor_boot patching (Magisk 30+)
  • Check device bootloader version compatibility

Fastboot connection fails

  • Ensure device is in fastboot mode: 
    adb reboot fastboot
  • Check USB cable and host connection
  • Verify fastboot binary is available in PATH
  • Some devices need special drivers for fastboot

Magisk patching fails

  • Boot image format may be unsupported
  • Try manual patching in Magisk app UI
  • Check available storage on device (/sdcard)
  • Ensure boot image file isn't corrupted

Device bootloops after flashing

  • Flash original boot.img to recover
  • Use recovery mode if available
  • Connect to custom recovery (TWRP) and flash backup
  • Restore device via stock ROM if necessary

Related Skills

  • adb-magisk
    - Magisk Manager automation (module installation, configuration)
  • adb-karrot
    - Uses Magisk for Play Integrity bypass
  • adb-workflow-orchestrator
    - Orchestrates complex installation workflows

Version: 1.0.0 Status: ✅ Complete Installation Tier Scripts: 5 Workflows: 1 Last Updated: 2025-12-02 Tier: 3 (System Installation)