maistro-skill

A Claude Code skill that orchestrates large projects by decomposing goals into tasks executed by specialized subagents (Architect, Developer, QA).

Install

npx maistro-skill install

Or install globally:

npm i -g maistro-skill
maistro-skill install

This copies the skill and agent files to ~/.claude/ so they're available in all projects.

Usage

In any Claude Code session:

/maistro Build a REST API with user authentication and CRUD operations

Commands

| Command | Description | |---------|-------------| | /maistro <goal> | Start a new project with the given goal | | /maistro resume | Resume an interrupted session | | /maistro status | Show current project progress |

How It Works

/maistro <goal>
    │
    ├─ Architect agent (discovery questions + task planning)
    │    └─ Interactive questions → writes .maistro/state.json
    │
    └─ For each task:
         ├─ Developer agent (implements code, runs tests)
         └─ QA agent (validates via git diff + acceptance criteria)
              └─ PASS → commit, next task
              └─ FAIL → retry or skip

1. Discovery — Architect analyzes your goal, asks clarifying questions via interactive UI
2. Planning — Decomposes into ordered tasks with acceptance criteria, writes .maistro/state.json
3. Execution — For each task: Developer implements → QA validates → commit on pass
4. Resilience — Failed tasks retry up to 3x, state persists for resume

State & Logs

• State: .maistro/state.json — full project state, compatible with the maistro CLI
• Logs: .maistro/logs/log-<taskId>.log — full subagent prompts and outputs per task

Manage Installation

maistro-skill status      # Check if installed
maistro-skill uninstall   # Remove from ~/.claude/

Related

• maistro — Standalone CLI version with TUI interface

Feedback

This tool exists to answer one question:

Does explicit orchestration help manage Claude Code context for larger tasks?

If you try it and decide the answer is "no", that feedback is just as valuable.

Issues, ideas, and criticism are welcome. Send them my way at [email protected]

License

Copyright (c) 2026 DreamTeam Mobile. All rights reserved.

Permission is granted, free of charge, to use this software for any purpose, including commercial applications, subject to the following conditions:

1. You MAY use this software for personal or commercial purposes.
2. You MAY NOT modify, adapt, or create derivative works.
3. You MAY NOT redistribute, sublicense, or resell this software.
4. You MAY NOT remove or alter any copyright notices.

This software is provided "as is", without warranty of any kind, express or implied. In no event shall the authors be liable for any claim, damages, or other liability arising from the use of this software.