{
  "markdown": "# Maestro\n\n[![npm version](https://img.shields.io/npm/v/@alissonpokry/maestro.svg)](https://www.npmjs.com/package/@alissonpokry/maestro)\n[![npm package](https://img.shields.io/badge/npm-@alissonpokry%2Fmaestro-red.svg)](https://www.npmjs.com/package/@alissonpokry/maestro)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nDynamic skill bundle manager for AI coding assistants.\n\n[Brazilian Portuguese](README.pt-BR.md)\n\nMaestro helps agents load the right instructions for the task in front of them. Instead of keeping every language, framework, and workflow rule in the active prompt, Maestro routes the request to a focused bundle of skills and keeps the agent context smaller.\n\n## Install\n\nRun the installer directly from npm:\n\n```bash\nnpm i @alissonpokry/maestro\n```\n\nThen execute the installer:\n\n```bash\nnpx @alissonpokry/maestro\n```\n\n## Package\n\n| Field | Value |\n| --- | --- |\n| Package | `@alissonpokry/maestro` |\n| Current version | `1.0.3` |\n| npm install | `npm i @alissonpokry/maestro` |\n| npx usage | `npx @alissonpokry/maestro` |\n| CLI binary | `maestro` |\n| License | MIT |\n| Runtime dependencies | None |\n| Node.js | `>=18` |\n\n## What Maestro Does\n\n- Installs slash-command skills for Cursor, Claude, Antigravity/Gemini, and Codex/Agents.\n- Stores one active `skill-bundle-folder` path for Maestro.\n- Scans bundle folders and builds a compact `Known Bundles` index.\n- Routes `/maestro` requests to the best matching bundle and skill files.\n- Provides maintenance commands for switching folders, refreshing the index, and checking current configuration.\n\n## Quick Start\n\n1. Install Maestro in your project or user folder as stated in the install section above.\n\n2. Set your skill bundle folder:\n\n```text\n/maestro-set C:\\Users\\user\\Desktop\\My-Skill-Bundles\n```\n\n3. Route a task through Maestro:\n\n```text\n/maestro Build a login page in Angular.\n```\n\nMaestro checks the request, selects the most relevant bundle, reads only the matched skill instructions, and then continues the task with focused context.\n\n## Installer Options\n\nThe installer asks for:\n\n- Action: installation or uninstallation.\n- Scope: local project or global user folder.\n- AI environment: Cursor, Claude, Antigravity/Gemini, Codex/Agents, or all supported environments.\n\nLocal installs place Maestro files into the current project. Global installs place them under the relevant user-level assistant folders.\n\n## Commands\n\n| Command | Purpose |\n| --- | --- |\n| `/maestro <task>` | Route a task through the best matching bundle. |\n| `/maestro-set <folder-path>` | Save or switch the active `skill-bundle-folder`. |\n| `/maestro-fetch [folder-path]` | Refresh the `Known Bundles` index. |\n| `/maestro-stats` | Show the active bundle folder and indexed bundles. |\n\nIf your agent exposes only `/maestro`, use these aliases:\n\n| Alias | Equivalent command |\n| --- | --- |\n| `/maestro switch <folder-path>` | `/maestro-set <folder-path>` |\n| `/maestro fetch [folder-path]` | `/maestro-fetch [folder-path]` |\n| `/maestro stats` | `/maestro-stats` |\n\n## Skill Bundle Layout\n\nMaestro expects a folder whose direct children are bundles. Each bundle can contain one or more skills, and each skill is represented by a `SKILL.md` file.\n\n```text\nMy-Skill-Bundles/\n|\n+-- Angular-pro/\n|   +-- angular-architecture/\n|   |   +-- SKILL.md\n|   +-- angular-ui-patterns/\n|       +-- SKILL.md\n|\n+-- Python-pro/\n|   +-- python-testing/\n|       +-- SKILL.md\n|\n+-- Seo-pro/\n    +-- seo-audit/\n        +-- SKILL.md\n```\n\nIn Maestro terminology:\n\n- `skill-bundle-folder` is the folder that contains all bundles.\n- `bundle` is an immediate child folder, such as `Angular-pro`.\n- `skill` is a specific `SKILL.md` inside a bundle.\n\n## Supported Environments\n\nMaestro can install command and skill files for:\n\n- Cursor\n- Claude\n- Antigravity/Gemini\n- Codex/Agents\n\n## Repository Development\n\nThis package has no runtime dependencies. The CLI entry point is:\n\n```bash\nbin/cli.js\n```\n\nUseful local commands:\n\n```bash\nnode bin/cli.js init\nnode bin/cli.js uninstall\nnpm test\nnpm run pack:dry-run\n```\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n",
  "bytes": 4115,
  "sha": "d392905abfa5e295a9ba89f3571b9d039eec05a2a27fc3a5cc8dcb0dca79a8f5",
  "repo_slug": "alissonpokry/maestro",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_alissonpokry_maestro_88662694/readme"
}