Agent skill

Reflect

Analyze command history to identify which skills work, which fail, and where to improve.

MITAuto-check passedMobile

Install Reflect

skills CLI

$ npx skills add sharpdeveye/maestro --skill reflect -a claude-code

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

GitHub CLI

$ gh skill install sharpdeveye/maestro reflect --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/sharpdeveye/maestro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/source/skills/reflect .claude/skills/reflect && 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/

Paste into Claude Code

Install the "reflect" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/reflect into .claude/skills/reflect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reflect", 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

$skill-installer install https://github.com/sharpdeveye/maestro/tree/main/source/skills/reflect

Type 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.

skills CLI

$ npx skills add sharpdeveye/maestro --skill reflect -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install sharpdeveye/maestro reflect --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .agents/skills && cp -r skills-src/source/skills/reflect .agents/skills/reflect && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "reflect" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/reflect into .agents/skills/reflect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reflect", 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.

skills CLI

$ npx skills add sharpdeveye/maestro --skill reflect -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install sharpdeveye/maestro reflect --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/source/skills/reflect .cursor/skills/reflect && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "reflect" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/reflect into .cursor/skills/reflect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reflect", 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

$ gemini skills install https://github.com/sharpdeveye/maestro.git --path source/skills/reflect

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add sharpdeveye/maestro --skill reflect -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install sharpdeveye/maestro reflect --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/source/skills/reflect .gemini/skills/reflect && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "reflect" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/reflect into .gemini/skills/reflect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reflect", 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.

GitHub CLI

$ gh skill install sharpdeveye/maestro reflect

Installs 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).

skills CLI

$ npx skills add sharpdeveye/maestro --skill reflect -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .github/skills && cp -r skills-src/source/skills/reflect .github/skills/reflect && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "reflect" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/reflect into .github/skills/reflect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reflect", 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.

skills CLI

$ npx skills add sharpdeveye/maestro --skill reflect -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install sharpdeveye/maestro reflect --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sharpdeveye/maestro.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/source/skills/reflect .opencode/skills/reflect && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "reflect" agent skill from https://github.com/sharpdeveye/maestro/tree/main/source/skills/reflect into .opencode/skills/reflect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reflect", 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: reflect
GitHub stars: 592
Token cost: ~932 tokens
SKILL.md length: 304 words
Files: 1
Skills in repo: 25
Repo updated: Apr 29, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Analyze command history to identify which skills work, which fail, and where to improve.

Works in 2 steps: .maestro/audit.jsonl — every command… → .maestro/decisions.jsonl — decisions…
Mobile work in your project
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reflect is an agent skill from sharpdeveye/maestro. Analyze command history to identify which skills work, which fail, and where to improve.

Its SKILL.md is about 930 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. 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

Mobile work in your project

Example prompts

“/reflect”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

.maestro/audit.jsonl — every command invocation with duration, cost, and outcome
.maestro/decisions.jsonl — decisions made with outcomes and next steps

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.
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

Reflect loads about 932 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 304 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~24
When it runs · the whole SKILL.md, loaded when a task matches: ~932

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). 304 words, ~932 tokens.

Download SKILL.mdSave it as .claude/skills/reflect/SKILL.md (or your agent's skills folder).

name: reflect
description: Analyze command history to identify which skills work, which fail, and where to improve.
argument-hint: [time period]
category: analysis
version: 2.0.0
user-invocable: true

MANDATORY PREPARATION

Invoke /agent-workflow — it contains workflow principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no workflow context exists yet, you MUST run /teach-maestro first.

Analyze the Maestro audit trail and decision log to produce a skill-effectiveness scorecard. This tells you which commands work, which fail, and where your workflow needs attention.

Data Sources

Read these files from the project root:

.maestro/audit.jsonl — every command invocation with duration, cost, and outcome
.maestro/decisions.jsonl — decisions made with outcomes and next steps

If neither file exists, respond: "No audit data found. Run commands with Maestro to start tracking, then come back."

Analysis Dimensions

1. Usage Frequency

Which commands run most/least?
Are any commands never used? (candidates for removal)

2. Completion Rate

What % of invocations complete successfully?
Which commands fail most often?

3. Command Flow

What are the most common command sequences (A → B)?
Which commands lead to follow-ups vs. abandonment?
Abandonment rate per command (no follow-up within 30 min)

4. Cost Distribution

Total estimated cost across all commands
Cost per command (average)
Most/least expensive commands

5. Duration Analysis

Average duration per command
Outliers (unusually slow invocations)

Output Format

text

╔══════════════════════════════════════════╗
║          MAESTRO EFFECTIVENESS           ║
╠══════════════════════════════════════════╣
║ Commands Run         __ (__ unique)      ║
║ Completion Rate      __%                 ║
║ Most Used            /_____ (__×)        ║
║ Most Abandoned       /_____ (__% ⚠️)     ║
║ Avg Duration         __s                 ║
║ Total Cost           ~$__.__             ║
╠══════════════════════════════════════════╣
║           STRONGEST PIPELINES            ║
╠══════════════════════════════════════════╣
║ /_____ → /_____    __×                   ║
║ /_____ → /_____    __×                   ║
╠══════════════════════════════════════════╣
║           COST PER COMMAND               ║
╠══════════════════════════════════════════╣
║ /_____    $__.__/run  ████░░  avg        ║
║ /_____    $__.__/run  █░░░░░  cheap      ║
║ /_____    $__.__/run  █████░  costly     ║
╚══════════════════════════════════════════╝

INSIGHTS:
1. [Data-driven observation with recommended action]
2. [Data-driven observation with recommended action]
3. [Data-driven observation with recommended action]

Insights Rules

Every insight MUST:

Reference specific data (e.g., "40% abandonment rate")
Suggest a specific Maestro command to address it
Distinguish correlation from causation

Reflection Checklist

All 5 analysis dimensions covered
Scorecard generated with real data
Insights are data-driven, not speculative
Cost estimates labeled as approximate (~)
Recommended actions reference specific Maestro commands

Recommended Next Step

After reflecting, run /streamline to remove unused commands, or /refine on the most-abandoned command to improve its prompt quality.

NEVER:

Require audit data to exist — degrade gracefully
Invent metrics beyond what the logs contain
Show cost data without the "estimate" disclaimer (~)
Make judgments without evidence (say "100% completion rate" not "works great")
Compare across projects — reflect is project-scoped

Files

Just SKILL.md in source/skills/reflect of sharpdeveye/maestro.

Open the folder on GitHubat commit 00f9115

Compare with similar skills

Reflect 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.

Reflect compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Reflect this skillsharpdeveye/maestro	592	—	~932	Automated safety check: Pass	MIT	5 mo ago
React Native Best Practicesvercel-labs/openreview	1.7k	17 repos	~1.1k	Automated safety check: Pass	MIT	7 mo ago
Swiftui Protwostraws/SwiftUI-Agent-Skill	5.1k	2 repos	~1.5k	Automated safety check: Pass	MIT	yesterday
Kortix Brandkortix-ai/suna	20k	—	~4k	Automated safety check: Pass	Custom licence	today
Ip As LogoKartikLabhshetwar/better-shot	2.4k	1 repos	~4.3k	Automated safety check: Pass	MIT	7 days ago
Compose Multiplatform Patternsmonta-app/ocpp-emulator	180	5 repos	~2k	Automated safety check: Pass	Apache-2.0	7 days ago

Similar skills

React Native Best Practices
vercel-labs/openreview
Official
A prioritized rule set for React Native and Expo apps covering list performance, animation, navigation, UI patterns, state, rendering, monorepos and configuration.
1.7k GitHub starsUsed in 17 repos~1.1k tokens
MobileAuto-check passed
Swiftui Pro
twostraws/SwiftUI-Agent-Skill
Comprehensively reviews SwiftUI code for best practices on modern APIs, maintainability, and performance.
5.1k GitHub starsUsed in 2 repos~1.5k tokens
MobileAuto-check passed
Kortix Brand
kortix-ai/suna
Load FIRST for anything that carries the Kortix look or voice: product or mobile UI, copy of any kind, decks, social, images, email, CLI output, anything with the logo, and reviews of these.
20k GitHub stars~4k tokensUpdated today
MobileAuto-check passed
Ip As Logo
KartikLabhshetwar/better-shot
Generate extremely simple, cute, personified square character images with rounded heavy forms, two purposeful character colors, one solid background color, and a dominant lower-corner composition.
2.4k GitHub starsUsed in 1 repo~4.3k tokens
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.
180 GitHub starsUsed in 5 repos~2k tokens
MobileAuto-check passed
Aso Appstore Screenshots
adamlyttleapps/claude-skill-aso-appstore-screenshots
Generate high-converting App Store screenshots by analyzing your app's codebase, discovering core benefits, and creating ASO-optimized screenshot images using Nano Banana Pro.
1.8k GitHub starsUsed in 1 repo~9.6k tokens
MobileAuto-check passed

Questions about Reflect

What does Reflect do?

Analyze command history to identify which skills work, which fail, and where to improve. Reflect is an agent skill from sharpdeveye/maestro. Analyze command history to identify which skills work, which fail, and where to improve.

When should I use Reflect?

Reflect fits situations like: mobile work in your project.

How do I install Reflect in Claude Code?

Run `npx skills add sharpdeveye/maestro --skill reflect -a claude-code`. Or copy the skill folder (source/skills/reflect in sharpdeveye/maestro) into .claude/skills/reflect in your project. Claude Code loads it when a task matches its description.

How do I install Reflect in Codex?

Run `npx skills add sharpdeveye/maestro --skill reflect -a codex`. Or copy the skill folder (source/skills/reflect in sharpdeveye/maestro) into .agents/skills/reflect in your project. Codex loads it when a task matches its description.

Can I use Reflect 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 reflect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reflect, .gemini/skills/reflect, .github/skills/reflect and .opencode/skills/reflect in your project.

What does Reflect need to run?

SKILL.md names no scripts, command-line tools or credentials: Reflect is instructions for the agent only.

Does Reflect 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 Reflect 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 Reflect use?

Reflect 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 Reflect use?

About 932 tokens (SKILL.md is roughly 3.7k 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 Reflect?

Skills that share tags, products or a category with Reflect: React Native Best Practices (vercel-labs/openreview, 1.7k stars), Swiftui Pro (twostraws/SwiftUI-Agent-Skill, 5.1k stars), Kortix Brand (kortix-ai/suna, 20k stars) and Ip As Logo (KartikLabhshetwar/better-shot, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reflect?

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.

Reflect

Install Reflect

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

MANDATORY PREPARATION

Data Sources

Analysis Dimensions

Output Format

Insights Rules

Reflection Checklist

Recommended Next Step

Files

Compare with similar skills

Similar skills

React Native Best Practices

Swiftui Pro

Kortix Brand

Ip As Logo

Compose Multiplatform Patterns

Aso Appstore Screenshots

More from sharpdeveye/maestro

Accelerate

Chain

Compose

Diagnose

Extract Pattern

Fortify

Questions about Reflect

Install Reflect

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

MANDATORY PREPARATION

Data Sources

Analysis Dimensions

Output Format

Insights Rules

Reflection Checklist

Recommended Next Step

Files

Compare with similar skills

Similar skills

More from sharpdeveye/maestro

Related

Questions about Reflect