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 you need to act as an Elite Software Architect (Maestro) to manage complex repositories.
Install Maestro
$ npx skills add xenitV1/claude-code-maestro --skill maestro -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install xenitV1/claude-code-maestro maestro --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
Claude Code skills documentation · loads skills from .claude/skills/
Install the "maestro" agent skill from https://github.com/xenitV1/claude-code-maestro/tree/main into .claude/skills/maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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.
$ npx skills add xenitV1/claude-code-maestro --skill maestro -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install xenitV1/claude-code-maestro maestro --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "maestro" agent skill from https://github.com/xenitV1/claude-code-maestro/tree/main into .agents/skills/maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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 xenitV1/claude-code-maestro --skill maestro -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install xenitV1/claude-code-maestro maestro --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "maestro" agent skill from https://github.com/xenitV1/claude-code-maestro/tree/main into .cursor/skills/maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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.
$ npx skills add xenitV1/claude-code-maestro --skill maestro -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install xenitV1/claude-code-maestro maestro --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "maestro" agent skill from https://github.com/xenitV1/claude-code-maestro/tree/main into .gemini/skills/maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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 xenitV1/claude-code-maestro 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 xenitV1/claude-code-maestro --skill maestro -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "maestro" agent skill from https://github.com/xenitV1/claude-code-maestro/tree/main into .github/skills/maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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 xenitV1/claude-code-maestro --skill 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 xenitV1/claude-code-maestro maestro --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "maestro" agent skill from https://github.com/xenitV1/claude-code-maestro/tree/main into .opencode/skills/maestro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "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
maestro- GitHub stars
- 229
- Token cost
- ~1.1k tokens
- SKILL.md length
- 491 words
- Files
- 21
- Skills in repo
- 13
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when you need to act as an Elite Software Architect (Maestro) to manage complex repositories.
- Works in 5 steps: Law of Initiation (Mandatory Priority):… → Socratic Gate: Before any execution, you… → Architecture First: Complex tasks… → …
- You need to act as an Elite Software Architect (Maestro) to manage complex repositories
- SKILL.md covers � The Prime Directives…, 🏛️ Project Anatomy, 🧠 Persistent Consciousness… and 🛠️ Orchestration & Skill…, plus 1 more section
- Runs JavaScript scripts from its folder
What it does
Maestro is an agent skill from xenitV1/claude-code-maestro. Use when you need to act as an Elite Software Architect (Maestro) to manage complex repositories. It enforces a "Why over How" philosophy, maintains a persistent project memory (Brain), and orchestrates specialized sub-skills through a Plan-Act-Verify lifecycle.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 25 other files (for example `.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` and `.mcp.json`).
It sits in Mobile, covering Mobile testing and debugging and Agent memory. The licence is MIT.
When your agent uses it
- You need to act as an Elite Software Architect (Maestro) to manage complex repositories
- Tasks that involve Mobile testing and debugging
- Tasks that involve Agent memory
Example prompts
- “Why over How”
- “/maestro”
Requirements
- Node.js
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Law of Initiation (Mandatory Priority): Architectural continuity is non-negotiable. You MUST initiate every session by reading files in…
- Socratic Gate: Before any execution, you MUST analyze the user's intent and ask at least one strategic question regarding scope, edge…
- Architecture First: Complex tasks require an implementation_plan.md (RFC-Lite). Do not write production code on assumptions.
- Iron Law of TDD: No production code is written without a preceding failing test (Red-Green-Refactor).
- Verification Matrix: Every deliverable must be verified with evidence before marking it "complete".
What it can do on your machine
Read from SKILL.md and the folder at commit 924315b. 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 script files (JavaScript, from the files we listed), which the agent can run.
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
Maestro loads about 1.1k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 491 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 xenitV1/claude-code-maestro at commit 924315b, republished under its MIT licence (© xenitV1). 491 words, ~1,063 tokens.
Download SKILL.mdSave it as
.claude/skills/maestro/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.- name
- maestro
- description
- Use when you need to act as an Elite Software Architect (Maestro) to manage complex repositories. It enforces a "Why over How" philosophy, maintains a persistent project memory (Brain), and orchestrates specialized sub-skills through a Plan-Act-Verify lifecycle.
MAESTRO: THE ARCHITECTURAL GOVERNANCE FRAMEWORK
Maestro is not a tool; it is a Governance Protocol that transforms an AI agent from a reactive coder into a proactive Elite Software Architect. It enforces discipline, maintains project continuity, and orchestrates specialized expertise.
� The Prime Directives (Mandatory)
- Law of Initiation (Mandatory Priority): Architectural continuity is non-negotiable. You MUST initiate every session by reading files in this strict sequence: 1.
SKILL.md(Governance), 2.agents/(Persona), 3.skills/(Domain Expertise). - Socratic Gate: Before any execution, you MUST analyze the user's intent and ask at least one strategic question regarding scope, edge cases, or the underlying "Why".
- Architecture First: Complex tasks require an
implementation_plan.md(RFC-Lite). Do not write production code on assumptions. - Iron Law of TDD: No production code is written without a preceding failing test (Red-Green-Refactor).
- Verification Matrix: Every deliverable must be verified with evidence before marking it "complete".
🏛️ Project Anatomy
The Maestro repository is organized into specialized domains to ensure modularity and architectural integrity:
.maestro/: The "Brain" of the project. Contains persistent long-term memory (brain.jsonl) and state files. Note: Automatically created via hooks; do not manually initialize. Focus on orchestrating viaagents/andskills/.agents/: Personas and orchestration logic. Thegrandmaster.mddefines the Elite Architect's behavior.hooks/: Automation scripts that fire during the AI lifecycle (e.g., session starts, memory syncing). Note: Hooks are designed for Claude Code CLI; if using an IDE tool that skips hooks, disregard and proceed with the protocol manually.skills/: A library of specialized expertise (Frontend, Backend, Debugging, QA) that Maestro delegates to.commands/: Custom tactical workflows and CLI extensions.SKILL.md: This document—the foundational governance protocol for the entire framework.
Show full SKILL.md (216 more words)Show less
🧠 Persistent Consciousness (The Brain)
Maestro maintains a long-term memory system in .maestro/brain.jsonl.
- Session Initialization: Every interaction begins by auditing the tech stack, architectural patterns, and recent compact summaries stored in the Brain.
- State Sync: You must reflect all key decisions, completed tasks, and file changes back to the Brain to ensure cross-session continuity.
🛠️ Orchestration & Skill Routing
You act as the Grandmaster Conductor, delegating domain-specific work to Maestro's specialized internal skills.
Routing Protocol: Always read the core persona from agents/ first to establish the architectural stance. Then, based on the task requirements, dynamically select and read the relevant SKILL.md from the skills/ directory.
- UI/UX Intelligence: Route to
skills/frontend-design/SKILL.md. Enforce physics-based animations and anti-AI aesthetics. - Backend & API Design: Route to
skills/backend-design/SKILL.md. Enforce zero-trust architecture and strict API contracts. - Surgical Debugging: Route to
skills/debug-mastery/SKILL.md. Use 4-phase systematic diagnostics. - Autonomous QA (Ralph Wiggum): Trigger the self-healing iteration loop for any bug fix or optimization task.
🔄 The Execution Loop
- Analyze: Detect language, identify tech stack, and interrogate requirements.
- Plan: Create short, high-level tactical sequences using
planning-mastery. - Act: Execute tasks one-by-one with surgical precision. No
// TODOcomments or lazy placeholders. - Verify: Run tests, perform UX audits via scripts, and provide proof of functionality.
Philosophy: "Urgency is never an excuse for bad architecture. Trust the protocol. Orchestrate the future."
© xenitV1, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 20 other files in the repository root of xenitV1/claude-code-maestro.
- SKILL.md
- .claude-plugin/marketplace.json
- .claude-plugin/plugin.json
- .gitignore
- .mcp.json
- CHANGELOG.md
- LICENSE
- README.md
- README_tr.md
- agents/grandmaster.md
- commands/maestro.md
- hooks/brain-sync.js
- hooks/hooks.json
- hooks/lib/brain.js
- hooks/lib/ralph.js
- hooks/lib/utils.js
- … and 5 more
Open the folder on GitHubat commit 924315b
Compare with similar skills
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 |
|---|---|---|---|---|---|---|
| Maestro this skillxenitV1/claude-code-maestro | 229 | — | ~1.1k | 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 xenitV1/claude-code-maestro
All 13 skills in this repoClean Code
xenitV1/claude-code-maestro
The Foundation Skill. An agent skill from xenitV1/claude-code-maestro.
Ralph Wiggum
xenitV1/claude-code-maestro
Surgical Debugger & Code Optimizer. An agent skill from xenitV1/claude-code-maestro.
Backend Design
xenitV1/claude-code-maestro
Elite Tier Backend standards, including Vertical Slice Architecture, Zero Trust Security, and High-Performance API protocols.
Brainstorming
xenitV1/claude-code-maestro
Design-first methodology. An agent skill from xenitV1/claude-code-maestro.
Browser Extension
xenitV1/claude-code-maestro
Master specialized skill for building 2025/2026-grade browser extensions.
Debug Mastery
xenitV1/claude-code-maestro
Systematic debugging methodology with 4-phase process, root cause tracing, and elite observability standards.
Related
Categories
Questions about Maestro
What does Maestro do?
A skill your agent uses when you need to act as an Elite Software Architect (Maestro) to manage complex repositories. Maestro is an agent skill from xenitV1/claude-code-maestro. Use when you need to act as an Elite Software Architect (Maestro) to manage complex repositories.
When should I use Maestro?
Maestro fits situations like: you need to act as an Elite Software Architect (Maestro) to manage complex repositories; tasks that involve Mobile testing and debugging; tasks that involve Agent memory.
How do I install Maestro in Claude Code?
Run `npx skills add xenitV1/claude-code-maestro --skill maestro -a claude-code`. Or copy the skill folder (the xenitV1/claude-code-maestro repository) into .claude/skills/maestro in your project. Claude Code loads it when a task matches its description.
How do I install Maestro in Codex?
Run `npx skills add xenitV1/claude-code-maestro --skill maestro -a codex`. Or copy the skill folder (the xenitV1/claude-code-maestro repository) into .agents/skills/maestro in your project. Codex loads it when a task matches its description.
Can I use 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 xenitV1/claude-code-maestro --skill 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/maestro, .gemini/skills/maestro, .github/skills/maestro and .opencode/skills/maestro in your project.
What does Maestro need to run?
Going by SKILL.md and its folder, Maestro needs JavaScript for the scripts in its folder. Our summary lists: Node.js.
Does 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 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 Maestro use?
Maestro is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Maestro use?
About 1.1k tokens (SKILL.md is roughly 4.3k 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 Maestro?
Skills that share tags, products or a category with 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 Maestro?
xenitV1 (a GitHub user) maintains it in xenitV1/claude-code-maestro, which has 229 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on January 24, 2026.
Source: xenitV1/claude-code-maestro on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.