bootstrap-android

bootstrap-android is a portable Codex plugin/router skill for Android development. Use it before touching Android code to detect project surfaces, choose focused references/tools, and define the verification required for the task.

It is modeled after Ray Fernando's bootstrap-ios pattern, but for Android, Jetpack Compose, XML/View projects, Gradle/AGP, Kotlin, Android testing, emulator/device debugging, and Play Store release workflows.

When to use it

Use bootstrap-android when you want an agent to first answer: what kind of Android project is this, what task type is this, what focused references/tools should be loaded, and what verification is required before calling the work done?

Good fits include Compose or XML UI work, Gradle/build changes, Kotlin/coroutines/Flow, Room/DataStore persistence, Hilt/Koin, Navigation, tests, emulator/device debugging, screenshots/layout inspection, Play Store release work, third-party SDK integration, multi-module apps, and Kotlin Multiplatform Android projects.

What it does

• Detects Android project surfaces: Gradle wrapper, AGP/Kotlin versions, version catalogs, manifests, source sets, Compose/XML usage, Room/DataStore, Hilt/Koin, tests, multi-module, and KMP markers.
• Routes tasks to focused references instead of loading all Android guidance at once.
• Treats QyperXit/android-skills as the primary optional public Android skill pack/reference source.
• Treats AndroidBuildMCP as optional build/emulator/device tooling when available.
• Requires build/test/lint/device verification or an exact blocker report before completion.
• Keeps local/private skills optional; it does not depend on .factory or machine-local skills.

Example prompts

Copy and paste one of these into Codex:

Use bootstrap-android, then detect this Android project and tell me the right verification path.

Use bootstrap-android, then fix this Compose screen.

Use bootstrap-android, then debug this crash on emulator.

Use bootstrap-android, then audit this screen for recomposition/performance issues.

Use bootstrap-android, then add Room/DataStore persistence safely.

Use bootstrap-android, then prepare Play Store release notes.

Use bootstrap-android, then set up or review Material 3 theming.

How it relates to QyperXit/android-skills

• bootstrap-android is the router/meta-skill. It decides what kind of Android work is being requested, what project surfaces are present, which references should be loaded, and what verification is required.
• QyperXit/android-skills is the focused specialist skill pack. It contains task-specific skills such as emulator debugging, Compose UI patterns, Compose performance auditing, Material 3 theming, and Play Store changelog generation.
• AndroidBuildMCP and Android CLI are optional hands/tools for emulator, build, app lifecycle, screenshot, layout, and device flows. The router can point agents to them when available, but does not require them.

Safety model

• The bootstrap helper is dry-run-first.
• It does not silently install global tools, Android SDK packages, agent skills, or MCP config.
• It should not commit secrets, local paths, signing files, keystores, API keys, or credentials.
• Android work is not done until the agent runs appropriate build/test/lint/device verification or reports the exact blocker and next command.

Structure

bootstrap-android/
  .codex-plugin/plugin.json
  skills/bootstrap-android/SKILL.md
  skills/bootstrap-android/references/*.md
  skills/bootstrap-android/scripts/bootstrap-android-skills.sh

Install/use

As a Codex plugin

Publish this directory as a Git repository or place it in a Codex plugin marketplace, then install it through your configured marketplace:

codex plugin marketplace add <marketplace-or-repo>
codex plugin add bootstrap-android@<marketplace-name>

If publishing this as its own repository, update .codex-plugin/plugin.json with the final homepage and repository URLs after the repo exists.

As a skill only

Copy the skill folder into your Codex skills directory:

cp -R skills/bootstrap-android ~/.codex/skills/bootstrap-android

Then ask Codex to use bootstrap-android before Android work.

Optional bootstrap helper

The helper script is dry-run-first and does not silently install tools or modify agent configuration:

bash skills/bootstrap-android/scripts/bootstrap-android-skills.sh --dry-run --agent codex

After reviewing the printed commands, use --execute only if you intentionally want to run its safe commands.

Before publishing

Once the GitHub repo exists, add the final homepage and repository URLs back into .codex-plugin/plugin.json. Do not add placeholder or fake URLs.

Sources and attribution

See skills/bootstrap-android/references/sources.md for the public docs, repositories, and research sources used to build the router.