Phone Harness
ShawnPana/phone-harness
Control the user's phone — an iPhone through the Mac's iPhone Mirroring window, an Android over adb, or a rented cloud Android: open apps, tap, type, swipe, read the screen.
A skill your agent uses when starting a new project with Maestro or when no .maestro.md context file exists yet.
Install Teach Maestro
$ npx skills add sharpdeveye/maestro --skill teach-maestro -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install sharpdeveye/maestro teach-maestro --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/source/skills/teach-maestro .claude/skills/teach-maestro && rm -rf skills-srcUse ~/.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/
Install the "teach-maestro" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/teach-maestro into .claude/skills/teach-maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "teach-maestro", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/sharpdeveye/maestro/tree/main/source/skills/teach-maestroType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add sharpdeveye/maestro --skill teach-maestro -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install sharpdeveye/maestro teach-maestro --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .agents/skills && cp -r skills-src/source/skills/teach-maestro .agents/skills/teach-maestro && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "teach-maestro" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/teach-maestro into .agents/skills/teach-maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "teach-maestro", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sharpdeveye/maestro --skill teach-maestro -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install sharpdeveye/maestro teach-maestro --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/source/skills/teach-maestro .cursor/skills/teach-maestro && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "teach-maestro" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/teach-maestro into .cursor/skills/teach-maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "teach-maestro", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/sharpdeveye/maestro.git --path source/skills/teach-maestro--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add sharpdeveye/maestro --skill teach-maestro -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install sharpdeveye/maestro teach-maestro --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/source/skills/teach-maestro .gemini/skills/teach-maestro && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "teach-maestro" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/teach-maestro into .gemini/skills/teach-maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "teach-maestro", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install sharpdeveye/maestro teach-maestroInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add sharpdeveye/maestro --skill teach-maestro -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .github/skills && cp -r skills-src/source/skills/teach-maestro .github/skills/teach-maestro && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "teach-maestro" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/teach-maestro into .github/skills/teach-maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "teach-maestro", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sharpdeveye/maestro --skill teach-maestro -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install sharpdeveye/maestro teach-maestro --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/source/skills/teach-maestro .opencode/skills/teach-maestro && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "teach-maestro" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/teach-maestro into .opencode/skills/teach-maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "teach-maestro", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
teach-maestro- GitHub stars
- 592
- Token cost
- ~784 tokens
- SKILL.md length
- 339 words
- Files
- 1
- Skills in repo
- 25
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when starting a new project with Maestro or when no .maestro.md context file exists yet.
- Starting a new project with Maestro
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- No .maestro.md context file exists yet
What it does
Teach Maestro is an agent skill from sharpdeveye/maestro. Use when starting a new project with Maestro or when no .maestro.md context file exists yet. Run once per project.
Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Mobile, covering Mobile testing and debugging. The repository describes itself as: Workflow fluency for AI coding agents. 1 core skill · 25 commands · 7 domain references · memory layer · audit trail — works across Cursor, Claude Code, Gemini CLI, Copilot, and… The licence is MIT.
When your agent uses it
- Starting a new project with Maestro
- No .maestro.md context file exists yet
Example prompts
- “/teach-maestro”
What it can do on your machine
Read from SKILL.md and the folder at commit 00f9115. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
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 no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Teach Maestro loads about 784 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 339 words of instructions outside code blocks.
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 passed
The automated check found no risky patterns in SKILL.md.
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); files beside SKILL.md are not scanned.
SKILL.md
The full file from sharpdeveye/maestro at commit 00f9115, republished under its MIT licence (© sharpdeveye). 339 words, ~784 tokens.
Download SKILL.mdSave it as
.claude/skills/teach-maestro/SKILL.md (or your agent's skills folder).- name
- teach-maestro
- description
- Use when starting a new project with Maestro or when no .maestro.md context file exists yet. Run once per project.
- argument-hint
- [project name]
- category
- utility
- version
- 2.0.0
- user-invocable
- true
BOOTSTRAP — First Command to Run
This is the entry point for Maestro. It creates the .maestro.md context file that all other Maestro commands depend on. No other preparation is needed — this IS the preparation.
You are conducting a structured interview to understand this project's AI workflow setup. Be conversational but thorough.
Interview Questions
Ask these questions one section at a time. Wait for answers before proceeding.
Section 1 — Models & Providers
- What AI model(s) are you using? (e.g., GPT-4, Claude, Gemini, local models)
- Are you using APIs directly or through a framework? (e.g., LangChain, LlamaIndex, custom)
- What are your context window sizes?
Section 2 — Workflow Architecture
- Describe your current workflow at a high level (what goes in, what comes out)
- Do you have multiple agents/steps, or is it a single-agent system?
- What tools/functions are available to your agent(s)?
Section 3 — Quality & Evaluation
- How do you currently evaluate output quality?
- Do you have test cases or golden examples?
- What are the most common failure modes?
Section 4 — Constraints
- What are your cost constraints? (budget per request, per day)
- What are your latency requirements? (real-time, batch, async)
- Are there compliance requirements? (HIPAA, GDPR, SOC2, etc.)
Section 5 — Priorities
- Rank these from most to least important: Quality, Speed, Cost, Safety
- What's the single biggest workflow problem you want to solve?
Output Format
After gathering all answers, generate a .maestro.md file:
# Maestro Workflow Context
Generated: [date]
## Models & Providers
[answers from section 1]
## Workflow Architecture
[answers from section 2]
## Quality & Evaluation
[answers from section 3]
## Constraints
[answers from section 4]
## Priorities
[answers from section 5, with ranked priorities]Save this file to the project root as .maestro.md.
Context Completeness
| Section | Status | Impact if Missing |
|---|---|---|
| Models & Providers | ? | Commands can't tailor advice to your stack |
| Workflow Architecture | ? | Commands can't assess complexity |
| Quality & Evaluation | ? | /iterate and /evaluate less effective |
| Constraints | ? | /guard and /accelerate can't set limits |
| Priorities | ? | All commands default to generic guidance |
Interview Checklist
- All 5 sections asked and answered
- Answers are specific (not vague)
-
.maestro.mdfile generated and saved - User confirmed accuracy of the generated context
Recommended Next Step
After creating .maestro.md, run /diagnose for a baseline health check of your workflow.
NEVER:
- Skip questions — every section matters for downstream commands
- Make assumptions — ask if unclear
- Overwrite an existing
.maestro.mdwithout asking
© sharpdeveye, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in source/skills/teach-maestro of sharpdeveye/maestro.
Open the folder on GitHubat commit 00f9115
Compare with similar skills
Teach Maestro 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Teach Maestro this skillsharpdeveye/maestro | 592 | — | ~784 | Automated safety check: Pass | MIT | |
| Phone HarnessShawnPana/phone-harness | 3.2k | — | ~4.3k | Automated safety check: Pass | MIT | |
| Maa Issue Log AnalysisMaaAssistantArknights/MaaAssistantArknights | 24k | — | ~4k | Automated safety check: Pass | AGPL-3.0 | |
| Mobile QAtloncorp/tlon-apps | 107 | — | ~2.4k | Automated safety check: Pass | MIT | |
| Store Listing Screenshotstherxmv/Telegram-Themer | 119 | — | ~2.5k | Automated safety check: Pass | None | |
| Maestro ImproveReinaMacCredy/maestro | 233 | — | ~1.9k | Automated safety check: Pass | MIT |
Similar skills
Maa Issue Log Analysis
MaaAssistantArknights/MaaAssistantArknights
分析 MaaAssistantArknights 上游仓库公开 Issue（https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/...
Mobile QA
tloncorp/tlon-apps
Run a mobile QA checklist on a physical Android device over adb for tlon-apps, then triage what fails into fixes.
Store Listing Screenshots
therxmv/Telegram-Themer
Generate TelegramThemer's Play Store listing images — capture the 8 required app screenshots on a running emulator/device by driving the real UI with adb, then composite them into the final…
Maestro Improve
ReinaMacCredy/maestro
Turn filed lessons into the smallest doctrine edit. An agent skill from ReinaMacCredy/maestro.
Android
yang1ming/android-harness
Direct Android device control through ADB. An agent skill from yang1ming/android-harness.
More from sharpdeveye/maestro
All 25 skills in this repoAccelerate
sharpdeveye/maestro
A skill your agent uses when the workflow is too slow, too expensive, or both and needs latency, cost, or token usage optimization.
Chain
sharpdeveye/maestro
A skill your agent uses when the workflow needs multi-step processing with sequential, parallel, or conditional tool compositions and proper data flow.
Compose
sharpdeveye/maestro
A skill your agent uses when a single agent demonstrably cannot handle the task and multi-agent coordination is justified.
Diagnose
sharpdeveye/maestro
A skill your agent uses when the user wants to find problems, audit workflow quality, or get a comprehensive health check on their AI workflow.
Extract Pattern
sharpdeveye/maestro
A skill your agent uses when the user wants to create templates, extract reusable patterns, document solutions, or build a pattern library from working workflows.
Fortify
sharpdeveye/maestro
A skill your agent uses when the workflow lacks error handling, has been failing in production, or needs retry logic, fallback strategies, and circuit breakers.
Related
Categories
Questions about Teach Maestro
What does Teach Maestro do?
A skill your agent uses when starting a new project with Maestro or when no .maestro.md context file exists yet. Teach Maestro is an agent skill from sharpdeveye/maestro.md context file exists yet.
When should I use Teach Maestro?
Teach Maestro fits situations like: starting a new project with Maestro; no .maestro.md context file exists yet.
How do I install Teach Maestro in Claude Code?
Run `npx skills add sharpdeveye/maestro --skill teach-maestro -a claude-code`. Or copy the skill folder (source/skills/teach-maestro in sharpdeveye/maestro) into .claude/skills/teach-maestro in your project. Claude Code loads it when a task matches its description.
How do I install Teach Maestro in Codex?
Run `npx skills add sharpdeveye/maestro --skill teach-maestro -a codex`. Or copy the skill folder (source/skills/teach-maestro in sharpdeveye/maestro) into .agents/skills/teach-maestro in your project. Codex loads it when a task matches its description.
Can I use Teach Maestro 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 sharpdeveye/maestro --skill teach-maestro -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/teach-maestro, .gemini/skills/teach-maestro, .github/skills/teach-maestro and .opencode/skills/teach-maestro in your project.
What does Teach Maestro need to run?
SKILL.md names no scripts, command-line tools or credentials: Teach Maestro is instructions for the agent only.
Does Teach Maestro 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 Teach Maestro safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Teach Maestro use?
Teach Maestro is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Teach Maestro use?
About 784 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Teach Maestro?
Skills that share tags, products or a category with Teach Maestro: Phone Harness (ShawnPana/phone-harness, 3.2k stars), Maa Issue Log Analysis (MaaAssistantArknights/MaaAssistantArknights, 24k stars), Mobile QA (tloncorp/tlon-apps, 107 stars) and Store Listing Screenshots (therxmv/Telegram-Themer, 119 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Teach Maestro?
sharpdeveye (a GitHub user) maintains it in sharpdeveye/maestro, which has 592 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on April 29, 2026.
Source: sharpdeveye/maestro on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.