How do I install the Maestro Issue skill?

Run npx skillmds@latest add catlog22/maestro-issue-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Maestro Issue safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Maestro Issue?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Maestro Issue free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Maestro Issue?

catlog22 (@catlog22) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Maestro Issue by catlog22 — Agent Skill

Name: Maestro Issue
Author: catlog22

Maestro Issue

Intent-driven issue lifecycle management — describe what you want in natural language (报告一个 bug / 列出开放 issue / 关掉 ISS-xxx / 关联到 task / 扫描发现问题) and the workflow routes to the right operation. Operates on .workflow/issues/. 知识管理走 /maestro-knowledge；knowhow 沉淀走 /maestro-knowhow；约束规则走 /maestro-spec。Triggers on "issue 管理", "报 bug", "记录问题", "issue list", "关闭 issue", "issue discover", "发现问题". Arguments: [intent — e.g. '记录一个登录失败的 bug' | 'list open' | 'close ISS-20260101-001' | 'discover']

catlog22 Updated Sep 21, 2026

File contents

background: false is the default. Use foreground dispatch whenever the result determines the current answer or next action.
Use background: true only for independent work. If this turn must consume a background result, call observe exactly once with action: "wait" and a bounded timeout before continuing; never continue independently while the result is pending.
Otherwise end the turn and wait for the automatic teammate-complete notification. Do not rely on SendMessage, team_msg, or hook callbacks as completion signals.
Never silently ignore an unfinished dispatch.

create — report/record a new issue
list — list issues (with optional filters)
show — view one issue in detail
update — change status/priority/add a note
close — resolve/fail/defer an issue
link — link an issue to a task
discover — automated multi-perspective issue discovery

Pass the full $ARGUMENTS to the workflow. For discover, read ~/.maestro/workflows/issue-discover.md instead. The workflow classifies the intent, extracts parameters, and routes to the requested issue operation.

---name: maestro-issue-2description: Intent-driven issue lifecycle management — describe what you want in natural language (报告一个 bug / 列出开放 issue / 关掉 ISS-xxx / 关联到 task / 扫描发现问题) and the workflow routes to the right operation. Operates on .workflow/issues/. 知识管理走 /maestro-knowledge；knowhow 沉淀走 /maestro-knowhow；约束规则走 /maestro-spec。Triggers on "issue 管理", "报 bug", "记录问题", "issue list", "关闭 issue", "issue discover", "发现问题". Arguments: [intent — e.g. '记录一个登录失败的 bug' | 'list open' | 'close ISS-20260101-001' | 'discover']---<teammate_contract>- `background: false` is the default. Use foreground dispatch whenever the result determines the current answer or next action.- Use `background: true` only for independent work. If this turn must consume a background result, call `observe` exactly once with `action: "wait"` and a bounded timeout before continuing; never continue independently while the result is pending.- Otherwise end the turn and wait for the automatic `teammate-complete` notification. Do not rely on `SendMessage`, `team_msg`, or hook callbacks as completion signals.- Never silently ignore an unfinished dispatch.</teammate_contract><purpose>Intent-driven issue management (renamed from maestro-manage, narrowed to issues). No fixed subcommand grammar — state your intent; the `issue` step classifies it into one operation and extracts the needed parameters:- **create** — report/record a new issue- **list** — list issues (with optional filters)- **show** — view one issue in detail- **update** — change status/priority/add a note- **close** — resolve/fail/defer an issue- **link** — link an issue to a task- **discover** — automated multi-perspective issue discovery</purpose><dispatch>Read `~/.maestro/workflows/issue.md` and follow the execution document directly. Do not create a Session or Run just to load this document.Pass the full `$ARGUMENTS` to the workflow. For `discover`, read `~/.maestro/workflows/issue-discover.md` instead. The workflow classifies the intent, extracts parameters, and routes to the requested issue operation.</dispatch>

Frequently asked questions