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.