init-boot-sequence-expert

Diagnose Android init boot failures and .rc misconfigurations.

40|7|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/jonaschen/Android-Software --skill init-boot-sequence-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init-boot-sequence-expert
Source: https://github.com/jonaschen/Android-Software/tree/main/skills/L2-init-boot-sequence-expert
Command: npx skills add https://github.com/jonaschen/Android-Software --skill init-boot-sequence-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Android boot failures and daemon misbehaviors are hard to debug because init spans system, vendor, and device overlays with strict timing, SELinux, and property constraints. This skill captures the init lifecycle, .rc syntax, property scoping, and vendor overlay expectations so you can diagnose why a service never starts, sockets are missing, or props trigger too early without wandering through irrelevant subsystems.

Core Features & Use Cases

  • Path-aware boot architecture: The path scope table maps every relevant directory from system/core/init/ to vendor and device overlays, and the boot sequence intelligence summarizes how early-init, post-fs, and boot phases transition so you know where to look first.
  • Syntax, property, and SELinux guardrails: The .rc reference catalog explains service blocks, actions, commands, property namespaces, and socket details, while the forbidden actions section keeps you aligned with SELinux-friendly domains, property timing, and vendor edit rules.
  • Validation tooling and handoffs: Use the validate_rc_syntax.py script to flag missing users, seclabels, or bad triggers, and rely on the handoff table to defer SELinux, HAL, framework, build, or kernel issues to the right L2 expert when boot problems cross domains.

Quick Start

Use the init-boot-sequence-expert to scan adb logcat for init failures, align the triggers with documented init rc rules, and update vendor overlays with validated service definitions.

Frequently Asked Questions about init-boot-sequence-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug an Android init boot failure when a service never starts?

To debug an Android init boot failure, analyze service definitions, triggers, and socket interactions using adb logcat. Check early-init, post-fs, and boot phase transitions, then validate .rc syntax to identify missing users, seclabels, or bad triggers.

How does the Android init boot sequence transition between phases?

The Android init boot sequence transitions through early-init, post-fs, and boot phases. Each phase has specific timing and property constraints that govern when services start, making it critical to align triggers with documented init rc rules to avoid startup failures.

How do I validate .rc file syntax for SELinux-friendly service definitions?

To validate .rc file syntax, use a validator script to flag missing users, seclabels, or bad triggers. Ensuring SELinux-friendly definitions, proper trigger ordering, and property/socket hygiene prevents daemon misbehaviors and boot sequencing issues across system and vendor overlays.

Why does my Android daemon fail to start due to property timing issues?

Android daemon startup fails when properties trigger too early or violate property scoping rules. The init lifecycle enforces strict timing constraints across system, vendor, and device overlays, requiring proper trigger ordering and property namespace alignment to resolve.

Can I use adb logcat to diagnose missing sockets in Android init services?

Yes, you can use adb logcat to scan for init failures and diagnose missing sockets. Analyzing socket interactions within service definitions and verifying proper socket details in the .rc reference catalog helps identify why sockets are missing during the boot sequence.

What should I do when Android boot problems cross into SELinux or kernel domains?

When boot problems cross into SELinux, HAL, framework, build, or kernel domains, defer the issue to the appropriate L2 expert. Use the handoff table to route domain-specific startup sequencing or property timing issues beyond init scope.