maestro-overlay

Create non-invasive CLI overlays that apply JSON patches to Maestro commands.

511|63|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-overlay
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maestro-overlay
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/maestro-overlay
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill maestro-overlay

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Non-invasive CLI overlays let teams customize Maestro command behavior by injecting JSON patches without touching core code, enabling safer experimentation and quick rollbacks.

Core Features & Use Cases

  • Non-invasive patching: augment existing commands with minimal risk by applying JSON patches stored in ~/.maestro/overlays.
  • End-to-end overlay workflow: intent parsing, target identification, patch drafting, installation, and verification.
  • Re-apply after reinstall: overlays are re-applied automatically during maestro install to preserve custom behavior.

Quick Start

Describe your intent, generate the overlay patch, and install it with maestro overlay add.

Frequently Asked Questions about maestro-overlay

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize Maestro commands without modifying core code files?▼

You can customize Maestro commands by applying non-invasive JSON patches stored under ~/.maestro/overlays, which modify command behavior without touching the original core files.

What is a CLI overlay and how does it work for command automation?▼

A CLI overlay is an idempotent JSON patch that augments existing command behavior. It is generated from your intent, installed, and verified to ensure safe modifications and quick rollbacks.

How do I generate and install a Maestro overlay patch from intent?▼

Describe your customization intent, generate the overlay patch, and install it using the maestro overlay add command to complete the end-to-end patching workflow.

Do Maestro overlays persist after reinstalling the CLI tool?▼

Yes, overlays persist after reinstalling. Stored patches are automatically re-applied during the maestro install process to preserve your custom command behavior.

What is the best way to safely patch and test changes to Maestro workflows?▼

The safest way to patch Maestro workflows is using non-invasive overlays, which inject JSON patches without editing core code, enabling safer experimentation and quick rollbacks.

Can I apply one overlay to multiple Maestro commands at the same time?▼

Yes, the overlay workflow supports applying generated patches to multiple Maestro commands through an end-to-end process from intent parsing to installation and verification.