Agent skill

OpenGUI Bootstrap

by Core-Mate in Core-Mate/OpenGUI

Installs, configures and runs OpenGUI's backend and Android client from a plain-language request, running the repo's own setup scripts and asking the user only for physical phone steps or secrets.

Custom licenceAuto-check: notesMobile

Install OpenGUI Bootstrap

skills CLI
$ npx skills add Core-Mate/OpenGUI --skill open-gui-bootstrap -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Core-Mate/OpenGUI open-gui-bootstrap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Core-Mate/OpenGUI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/open-gui-bootstrap .claude/skills/open-gui-bootstrap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
open-gui-bootstrap
GitHub stars
1.8k
Token cost
~1.7k tokens
SKILL.md length
968 words
Files
4 (incl. scripts, references)
Skills in repo
7
Repo updated
First seen
Licence
Custom licence

At a glance

Installs, configures and runs OpenGUI's backend and Android client from a plain-language request, running the repo's own setup scripts and asking the user only for physical phone steps or secrets.

  • Works in 8 steps: Inspect the checkout → Interpret the user's intent → Bootstrap the backend with the actual… → …
  • Setting up OpenGUI's backend and Android client from a plain-language request
  • SKILL.md covers Trigger Guidance, Example Prompts, Core Rules and First Step, plus 2 more sections
  • Runs Shell scripts from its folder; calls adb; needs VLM_API_KEY and FEISHU_APP_SECRET

What it does

The skill treats the current coding agent as the installer and operator rather than an instructor: it runs the repository's actual scripts, such as server/start.sh, client/start.sh and client/gradlew, instead of inventing a custom setup flow, and defaults to doing the work directly rather than explaining how. It is meant to accept requests phrased in plain language, like asking to bootstrap OpenGUI with a specific planning model and a specific vision-language model for the phone-use agent, without requiring the user to know environment variable names or command order.

The user is only asked for things the agent cannot do itself: physical taps on the phone, OS-level permission dialogs, secrets, or other Android device interaction. The first step always runs a bundled preflight.sh script, whose result tells the agent whether the checkout contains the runnable backend and client at all, continuing with setup only when the checkout is confirmed complete, and stopping to say so clearly when it is not. Each major setup step is verified before the skill claims the system is ready.

When your agent uses it

  • Setting up OpenGUI's backend and Android client from a plain-language request
  • Configuring OpenGUI with specific planning and vision-language model APIs
  • Debugging why an OpenGUI checkout won't start

Example prompts

  • “Help me run OpenGUI on my phone.”
  • “Set up OpenGUI with Qwen 3.6 Plus for planning and Doubao Pro for vision.”
  • “Get OpenGUI running and only tell me what I need to tap on the phone.”

Requirements

  • The OpenGUI repository checkout with its server and client folders
  • Android device or emulator access

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Inspect the checkout
  2. Interpret the user's intent
  3. Bootstrap the backend with the actual script
  4. Route model providers
  5. Build and install the Android client with the actual script
  6. Minimize device-side hand-offs
  7. Verify the first run
  8. Keep current source-available behavior in mind

What it can do on your machine

Read from SKILL.md and the folder at commit ad6d57f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • adb

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • VLM_API_KEY
    • FEISHU_APP_SECRET
    • TELEGRAM_BOT_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OpenGUI Bootstrap loads about 1.7k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 968 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:113
    - creates `.env` from `.env.example` on first run and exits
  • NoteMentions a .env fileSKILL.md:119
    If the first run exits after creating `.env`, ask only for the values still missing. With the repository defaults, ask f
  • NoteMentions a .env fileSKILL.md:205
    - "The backend script created `.env` and stopped. Add `VLM_API_KEY` to continue with the default model settings."

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 968 words (~1,725 tokens).

“Launch OpenGUI from a plain-language request.”

— opening of SKILL.md by Core-Mate, Custom licence
name
open-gui-bootstrap

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts, references) in skills/open-gui-bootstrap of Core-Mate/OpenGUI.

  • SKILL.md
  • agents/openai.yaml
  • references/setup-flow.md
  • scripts/preflight.sh

Open the folder on GitHubat commit ad6d57f

Compare with similar skills

OpenGUI Bootstrap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OpenGUI Bootstrap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OpenGUI Bootstrap this skillCore-Mate/OpenGUI1.8k—~1.7kAutomated safety check: NotesCustom licence
Android Hidden API and R8 Checkgkd-kit/gkd43k—~1.5kAutomated safety check: PassGPL-3.0
Android API Diffgkd-kit/gkd43k—~796Automated safety check: PassGPL-3.0
Android Readme Screenshot Studiopermissionlesstech/bitchat-android7.7k—~3kAutomated safety check: PassGPL-3.0
Compose Multiplatform Patternsmonta-app/ocpp-emulator1795 repos~2kAutomated safety check: PassApache-2.0
Android Tombstone Symbolicationdotnet/skills5.6k1 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Checks whether Android hidden-API implementations and system callbacks survive R8 minification, and diagnoses Release-only failures such as AbstractMethodError.

    43k GitHub stars~1.5k tokensUpdated today
    MobileAuto-check passed
  • Android API Diff

    gkd-kit/gkd

    Looks up Android framework Java and AIDL APIs across versions with the android-api-diff CLI: signatures, availability, source files and hidden-API access code.

    43k GitHub stars~796 tokensUpdated today
    MobileAuto-check passed
  • Android Readme Screenshot Studio

    permissionlesstech/bitchat-android

    Create or refresh polished, high-resolution screenshots of the Bitchat Android app for README and repository showcase use.

    7.7k GitHub stars~3k tokensUpdated yesterday
    MobileAuto-check passed
  • Compose Multiplatform Patterns

    monta-app/ocpp-emulator

    Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.

    179 GitHub starsUsed in 5 repos~2k tokens
    MobileAuto-check passed
  • Official

    Resolves native crash frames from .NET Android tombstones to function names, source files and line numbers using BuildIds, Microsoft's symbol server and llvm-symbolizer.

    5.6k GitHub starsUsed in 1 repo~2.1k tokens
    MobileAuto-check passed
  • Android Development

    dpconde/claude-android-skill

    Create production-quality Android applications following Google's official architecture guidance and NowInAndroid best practices.

    336 GitHub stars~1.7k tokensUpdated 10 mo ago
    MobileAuto-check passed

More from Core-Mate/OpenGUI

  • OpenGUI Installer for DSH

    Core-Mate/OpenGUI

    Installs and verifies the latest stable OpenGUI release in a DeepSeek Harness web profile on macOS without disturbing existing plugins or settings.

    1.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Lets a coding agent list, run, pause, resume or cancel natural-language tasks on an Android phone through the OpenGUI backend instead of raw ADB commands.

    1.8k GitHub stars~2.6k tokensUpdated today
    Auto-check: notes
  • Controls an authorized local Android phone, or shows its live read-only video feed, for phone app tasks and Android UI checks on macOS.

    1.8k GitHub stars~762 tokensUpdated today
    Auto-check passed
  • Completes an already-authorized task on a real Android phone or a macOS iOS simulator one screenshot-driven action at a time.

    1.8k GitHub stars~7.2k tokensUpdated today
    Auto-check passed
  • OpenGUI Plugin Installer

    Core-Mate/OpenGUI

    Installs or upgrades the standalone OpenGUI plugin for Codex or WorkBuddy on macOS from verified prebuilt GitHub releases, checking the SHA-256 before running anything.

    1.8k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • OpenGUI Android Control

    Core-Mate/OpenGUI

    Drives locally connected Android phones through OpenGUI screenshots and allowlisted actions, one observed step at a time, for app, game and multi-device tasks.

    1.8k GitHub stars~788 tokensUpdated today
    Auto-check passed

Works with

Questions about OpenGUI Bootstrap

What does OpenGUI Bootstrap do?

Installs, configures and runs OpenGUI's backend and Android client from a plain-language request, running the repo's own setup scripts and asking the user only for physical phone steps or secrets. sh and client/gradlew, instead of inventing a custom setup flow, and defaults to doing the work directly rather than explaining how. It is meant to accept requests phrased in plain language, like asking to bootstrap OpenGUI with a specific planning model and a specific vision-language model for the phone-use agent, without requiring the user to know environment variable names or command order.

When should I use OpenGUI Bootstrap?

OpenGUI Bootstrap fits situations like: setting up OpenGUI's backend and Android client from a plain-language request; configuring OpenGUI with specific planning and vision-language model APIs; debugging why an OpenGUI checkout won't start.

How do I install OpenGUI Bootstrap in Claude Code?

Run `npx skills add Core-Mate/OpenGUI --skill open-gui-bootstrap -a claude-code`. Or copy the skill folder (skills/open-gui-bootstrap in Core-Mate/OpenGUI) into .claude/skills/open-gui-bootstrap in your project. Claude Code loads it when a task matches its description.

How do I install OpenGUI Bootstrap in Codex?

Run `npx skills add Core-Mate/OpenGUI --skill open-gui-bootstrap -a codex`. Or copy the skill folder (skills/open-gui-bootstrap in Core-Mate/OpenGUI) into .agents/skills/open-gui-bootstrap in your project. Codex loads it when a task matches its description.

Can I use OpenGUI Bootstrap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Core-Mate/OpenGUI --skill open-gui-bootstrap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/open-gui-bootstrap, .gemini/skills/open-gui-bootstrap, .github/skills/open-gui-bootstrap and .opencode/skills/open-gui-bootstrap in your project.

What does OpenGUI Bootstrap need to run?

Going by SKILL.md and its folder, OpenGUI Bootstrap needs a shell for the scripts in its folder, the command-line tools its instructions call (adb) and credentials named VLM_API_KEY, FEISHU_APP_SECRET and TELEGRAM_BOT_TOKEN. Our summary lists: The OpenGUI repository checkout with its server and client folders; Android device or emulator access.

Does OpenGUI Bootstrap access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is OpenGUI Bootstrap safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does OpenGUI Bootstrap use?

OpenGUI Bootstrap has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does OpenGUI Bootstrap use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 967 tokens, read only when the agent opens those files.

What are the alternatives to OpenGUI Bootstrap?

Skills that share tags, products or a category with OpenGUI Bootstrap: Android Hidden API and R8 Check (gkd-kit/gkd, 43k stars), Android API Diff (gkd-kit/gkd, 43k stars), Android Readme Screenshot Studio (permissionlesstech/bitchat-android, 7.7k stars) and Compose Multiplatform Patterns (monta-app/ocpp-emulator, 179 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OpenGUI Bootstrap?

Core-Mate (a GitHub organization) maintains it in Core-Mate/OpenGUI, which has 1,815 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: Core-Mate/OpenGUI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.