К основному содержанию
скилл CX Codex

maestro-coach — скилл для Claude Code: учит и объясняет выбор

Скилл maestro-coach для Claude и Codex, который разбирает непонятный вопрос по шагам и объясняет концепт за решением на реальном коде вашего репозитория.

MIT ★ 238 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ReinaMacCredy/maestro --skill maestro-coach -a claude-code
Открыть на GitHub

Что делает maestro-coach

Два режима. Первый включается, когда другой скилл задал вам вопрос, а вы застряли: «подожди, что?», «не понял», «какой вариант лучше?». maestro-coach ставит развилку на паузу и пересказывает её с нуля, короткими фразами, по одной аналогии на вариант. Жаргон появляется только потом — связность, стоимость миграции, радиус поражения. Дальше одна рекомендация под ограничения репозитория и повторный вопрос: выбираете всё равно вы. Если решение принимает кто-то другой, вопрос уходит в maestro-questionnaire.

Второй режим — когда приносите материал: id решения, урок, рабочую заметку или бандл. Скилл читает запись (maestro decision show <id>, maestro bundle show <id>), а если речь о коде, сначала прогоняет maestro recipe show how и maestro recipe show why. Объясняет общий принцип, примером служит код вашего репозитория. Сначала самое короткое полное объяснение, глубина — по запросу.

Когда слов не хватает, в ход идут рисунки: mermaid для потока, серия диаграмм для трёх и больше частей, после двух неудачных попыток — один HTML-объяснитель на концепт. Скилл read-only: в проекте он ничего не меняет.

Какие задачи решает

  • разобрать развилку, на которой завис другой скилл
  • объяснить выбор без жаргона, на бытовых аналогиях
  • прочитать запись решения и разобрать отклонённый вариант
  • заменить простыню текста пошаговой диаграммой
  • передать вопрос тому, кто на самом деле решает

Примеры запросов агенту

  • Я не понял вопрос про миграцию, объясни как пятилетнему и скажи, что выбрать
  • Разбери maestro decision show <id> и объясни концепт, который за ним стоит
  • Нарисуй это mermaid-диаграммой, по одной части за раз

Как установить maestro-coach

1Через Skills CLI (Vercel)

npx skills add ReinaMacCredy/maestro --skill maestro-coach -a claude-code

2Вручную: положить файлы

~/.claude/skills/maestro-coach/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/maestro-coach/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о maestro-coach

Как установить maestro-coach в Claude Code?

Выполните npx skills add ReinaMacCredy/maestro --skill maestro-coach -a claude-code. Файл скилла появится по пути ~/.claude/skills/maestro-coach/SKILL.md.

Что делает maestro-coach?

Помогает человеку выбрать и понять: пересказывает развилку простыми словами, называет инженерные понятия за вариантами и даёт одну рекомендацию. Второй режим — объяснение концепта по записи решения, уроку или бандлу.

Чем режим развилки отличается от режима обучения?

Развилка нужна, когда вы не поняли вопрос от другого скилла и ответить пока не можете. Обучение — когда вы сами приносите id решения, урок или бандл и хотите разобраться в идее за ними.

Исходный текст

SKILL.md · MIT
---
name: maestro-coach
description: Decision support and grounded teaching for the human. Invoke when the user signals a message did not land ("wait, what?", "I don't understand", "explain it like I'm five", "which is better?", "I'm not sure") about a question or fork they have been asked, or when they hand over a locked decision, a lesson, or a bundle and want to learn the concept behind it. Also triggers on Vietnamese phrasings such as giải thích chi tiết, giải thích rõ hơn, rõ hơn, tôi không hiểu, cái nào tốt hơn.
review-date: 2026-11-28
---
<!-- maestro-skill-version: dev -->

# maestro-coach

Help the human decide and learn. Never decide for them, never drift into
lecture. Read-only; any tier may use it.

Folds rules from pstack's teach (Lauren Tan, MIT; notice in THIRD_PARTY.md).

## Fork mode

Any skill has put a question to the user and the user signals confusion.

1. Pause the fork; do not press for an answer. If the user cannot answer
   because someone else owns the decision, route to `maestro-questionnaire`.
2. Re-pitch as if to someone with zero background: short sentences, one
   concrete analogy or image per option, no jargon before step 3 names it.
   Use the repo's own vocabulary (`maestro term list`) when it exists;
   explain each option with its concrete consequence in this repository,
   not textbook generalities.
3. Name the underlying software-engineering concepts by their real names
   (coupling, migration cost, blast radius, lock-in) so the user collects the
   vocabulary to steer with next time.
4. Give one recommendation and the reason it fits this repo's constraints.
5. Re-ask the original fork. The user still decides; a coach that answers
   its own question has failed.

## Grounded-teach mode

The user hands over a decision id, a lesson, a work note, or a bundle.

1. Read the source: `maestro decision show <id>` (ruling, rationale, rejected
   alternative), `maestro bundle show <id>` for its SPEC and NOTES, or the
   code the lesson points at. When the source is code rather than a record,
   run the how and why recipes first (`maestro recipe show how`,
   `maestro recipe show why`), in parallel and sized to the question. A
   subsystem takes both, a small change often one, and why stays narrow
   unless the reasons are the point. Keep why's confidence language intact;
   its hedges are findings, not style.
2. Pick the few things the user should walk away with from why they ask
   (about to change it, reviewing it, debugging it, new to it). Read that
   from the conversation; never quiz it out of them. Skip what they plainly
   know and put the depth where their question is.
3. Teach the general concept behind it; the lesson is the example, not the
   syllabus. ("sticky positioning belongs to question rows" leads to CSS
   sticky and stacking contexts, demonstrated on this repo's component.)
   For each part, say the problem it solves and how it actually works. A list
   of functions and constants is reference, not teaching.
4. Work through the actual repository code, never invented examples.
5. Give the smallest complete answer first, a sentence or two, then stop.
   Add layers when they ask. Offer to go deeper or move on, and follow their
   lead. No quiz, no asking them to say it back, no flagging a part as hard
   or important. When you would pause, stop and let them respond. With no
   live human, deliver it whole and put the offer at the end.

The reply is the explanation itself, never a report about what you did.
Write it through `maestro recipe show unslop`. State the concrete mechanism,
not a metaphor or a preview of what is coming, and print no framing labels.

Either mode: draw when a picture lands faster than words, and build it up one
part at a time. For three or more moving parts, draw a short series in which
each diagram redraws the last and adds one part. A single all-at-once diagram
is a reference, not teaching. A mermaid diagram fits a flow or a structure
whose labels carry the meaning. When a plain-prose explanation has failed to
land twice, escalate the medium, not the volume. Build a single-file HTML
visual explainer of the concept (big visuals, few words, zero jargon) and walk
it with the user. It builds up the same way, one part per view, and it is the
medium for a spatial idea (layout, overlap, before and after). One concept per
explainer; it teaches, it never argues for an option.

One concept per session, depth over coverage. Full-topic syllabi are a
different engagement, not this skill.

© ReinaMacCredy · MIT · ReinaMacCredy/maestro

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
deep-research 5dive-ai Скилл deep-research для Claude Code проводит многоэтапное исследование с проверкой источников и оценкой уверенности. Сравнивает варианты, проверяет факты и анализирует рынок при высокой цене ошибки. CX Codex +1 268установок tooluniverse-clinical-risk-scoring mims-harvard Скилл tooluniverse-clinical-risk-scoring для Claude Code, Codex, Cursor и других агентов считает валидированные клинические шкалы риска по данным конкретного пациента. CX Codex +1 125установок maestro xenitV1 Скилл maestro превращает агента в архитектора: ведёт проект по циклу «план — действие — проверка» и хранит память между сессиями. CX Codex +1 604установок maestro-e2e raphaelbarbosaqwerty Скилл maestro-e2e для написания и отладки E2E-тестов на Maestro: логины, регистрация, навигация, диалоги разрешений. Работает с iOS, Android, Flutter, React Native и вебом. CX Codex +1 543установок analyze-project lllllllama Скилл analyze-project читает репозиторий с обучением моделей и выдаёт карту структуры, точек входа и подозрительных мест. Ничего не меняет и не запускает тяжёлые задачи. CX Codex +1 363 500установок Animation Principles - Teaching Others dylantarre Скилл Animation Principles - Teaching Others для Claude Code, который помогает объяснять 12 принципов анимации ученикам и коллегам. Разбирает типичные ошибки новичков и даёт готовые формулировки для каждого принципа. CX Codex +1 570установок

Из того же набора10

Весь набор →
verify-maestro Скилл verify-maestro проверяет правки в репозитории Maestro в изолированном окружении: ставит сборку во временный HOME, прогоняет сценарии CLI и сохраняет лог для отчёта. CX Codex +1 ★ 238звёзд репо maestro-questionnaire Скилл maestro-questionnaire превращает нерешённый вопрос в Markdown-опросник для человека, у которого есть нужные ответы. Подходит для сбора информации асинхронно или на встрече. CX Codex +1 ★ 238звёзд репо maestro-bundle Скилл maestro-bundle управляет жизненным циклом связок SPEC, NOTES и VERIFY в фреймворке Maestro и передаёт контекст между сессиями агентов. CX Codex +1 ★ 238звёзд репо maestro-verify Скилл maestro-verify сверяет проверки с критериями приёмки, фиксирует вердикт и помогает закрыть рабочий пакет. Нужен перед передачей результата или закрытием задачи. CX Codex +1 ★ 238звёзд репо maestro-design Скилл maestro-design для разрешения блокирующих вопросов перед началом разработки: выбор архитектуры, моделирование, прототипирование и фиксация решений. CX Codex +1 ★ 238звёзд репо maestro-graph Скилл maestro-graph для Claude Code и Codex, который проводит задачу по заранее написанному графу: спускает агентов на каждый узел, собирает их результаты и переходит к следующему шагу. CX Codex +1 ★ 238звёзд репо maestro-work Скилл maestro-work для Claude Code задаёт общий порядок работы плейбуков: бриф, правила для исполнителя и формат передачи результата. Он включается при делегировании задачи и ведении её записи в Maestro. CX Codex +1 ★ 238звёзд репо maestro-council Скилл maestro-council проводит совет по решению, которое дорого откатывать: изолированные участники, проверка общей посылки, перекрёстный допрос и один обязательный вердикт. CX Codex +1 ★ 238звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой