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

maestro-questionnaire — скилл для Claude Code

Скилл maestro-questionnaire превращает нерешённый вопрос в Markdown-опросник для человека, у которого есть нужные ответы. Подходит для сбора информации асинхронно или на встрече.

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

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

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

Сначала агент спрашивает, кому предназначен опросник и какие решения или факты нужно получить. Затем составляет вопросы по пробелу между тем, что знает адресат, и тем, что нужно пользователю. Вопросы идут от самых важных; файл включает контекст, инструкции по заполнению и поле для ответа под каждым вопросом.

В активном бандле Maestro файл сохраняется в .maestro/bundle/<bundle-id>/QUESTIONNAIRE-<slug>.md, а ожидание ответов фиксируется в заметке о работе и в NOTES.md. Без активного бандла опросник появляется в текущей папке. Скилл не меняет код.

После получения ответов он записывает их как черновики решений и блокирует решения в Maestro. Для этого процесса нужны идентификаторы работы и бандла, если он активен; без них нельзя сформировать соответствующие команды и путь.

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

  • Собрать вопросы для решения, которое пользователь не может принять сам
  • Уточнить у адресата факты, которых не хватает для выбора
  • Подготовить Markdown-опросник для заполнения до встречи
  • Зафиксировать ответы как решения в Maestro

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

  • Подготовь опросник для коллеги, который знает требования к запуску, чтобы я мог выбрать нужную нагрузку.
  • Составь вопросы для заказчика: какие решения по проекту мне нужно получить до встречи?
  • Оформи опросник для активного бандла и укажи, какие ответы нужны для следующего действия.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о maestro-questionnaire

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

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

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

Он выясняет, кому адресован опросник и какие ответы нужны пользователю, а затем создаёт Markdown-документ с вопросами для этого человека.

Где сохраняется опросник в активном бандле Maestro?

В .maestro/bundle/<bundle-id>/QUESTIONNAIRE-<slug>.md. Скилл также записывает ожидание ответов в заметке о работе и задаёт возврат ответов как следующее действие бандла.

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

SKILL.md · MIT
---
name: maestro-questionnaire
description: Turn a decision the user cannot fully answer into a Markdown questionnaire for the one person who can - filled in async, or together over a meeting. Also triggers on Vietnamese phrasings such as phỏng vấn đi, phỏng vấn tôi, interview tôi.
review-date: 2026-11-28
---
<!-- maestro-skill-version: dev -->
<!-- adapted from Matt Pocock's to-questionnaire -->

# maestro-questionnaire

Turn something the user cannot answer alone into a **questionnaire**: a
Markdown document they hand to one person to fill in async, or fill out
together over a meeting. The recipient holds knowledge the user lacks; the
questionnaire pulls it out of them. Read-only toward code; any tier may use it.

**Grill the send, not the subject.** Interview the user only about the
_send_, which they can always answer: who it goes to, and what they need
back. The questions in the document then target the **gap** between what the
recipient knows and what the user needs.

1. **Who is it going to?** Ask, in one exchange, the recipient's role,
   expertise, and relationship to the user. This fixes the questionnaire's
   tone and how much context it must carry. Done when you know who the
   recipient is and what they know that the user does not.

2. **What do you need back?** Ask, in one exchange, the specific decisions
   or facts the user cannot resolve alone and needs from this person. Done
   when you have a concrete list of what the user must walk away able to do
   or decide.

3. **Write the questionnaire.** Draft questions aimed at the gap from steps
   1 and 2, following the Document structure below. When an active bundle
   owns the decision, write it to
   `.maestro/bundle/<bundle-id>/QUESTIONNAIRE-<slug>.md`, record the wait as
   `maestro work note <id> "blocked: questionnaire <slug> sent to <role>"`,
   and set the bundle's NOTES.md Next Action to the return of the answers;
   otherwise write `questionnaire-<slug>.md` in the current directory. Report
   the path. Done when the file exists and every item the user named in step
   2 is covered by a question.

When the answers come back, they are settled forks: record each as
`maestro decision draft "<answer>" --rationale "<why, per <recipient>>" --work <id>`
then `maestro decision lock <id>`, and clear the Next Action. The filled
questionnaire is the evidence the decision cites.

## Document structure

Frame the document as a **discovery questionnaire**: the user lacks context,
the recipient holds it. Order questions most-important-first, since async
means you may only get one pass, and group them under `##` headings by theme
once there are more than a handful. Write it using the template below.

<questionnaire-template>

# <Questionnaire title>

**Purpose:** why this questionnaire exists and the decision riding on it.

**From:** <the user> **To:** <the recipient> **How your answers will be
used:** <where they go>

## Context

One paragraph orienting a recipient who was not in the user's head. Enough to
answer well, not a page.

## How to answer

Deadline and rough effort. Partial answers and "I don't know" are useful;
flag anything you are unsure of rather than skipping it.

## <Theme heading>

One `##` section per theme. Under each, its questions, most-important-first.
Every question is one idea, never compound, with an answer stub directly
beneath, and a one-line _why this matters_ only where the question could be
misread or invite a throwaway answer.

<question-example>
### What load is the system expected to handle at launch?

_Why this matters: it decides whether we provision for burst traffic now or
defer it._

>
</question-example>

## Anything else?

A closing catch-all: anything we did not ask that we should know?

</questionnaire-template>

© ReinaMacCredy · MIT · ReinaMacCredy/maestro

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

Каталог скиллов SKILL.md →
to-questionnaire Matt Pocock Скилл to-questionnaire для Claude Code превращает вопрос, на который не хватает знаний, в Markdown-анкету. Запускается вручную, чтобы собрать ответы коллеги синхронно или асинхронно. CX Codex +1 498 319установок sumsub-create-questionnaire sumsub Скилл sumsub-create-questionnaire собирает определение KYC-анкеты Sumsub из короткого описания, отправляет его в API и возвращает id для привязки к уровням. CX Codex +1 1 400установок claude-skill-app-onboarding-questionnaire reason-machines Скилл claude-skill-app-onboarding-questionnaire разбирает код вашего приложения и собирает онбординг из экранов-вопросов: тексты, макеты и готовый код на нативном фреймворке. CX Codex +1 593установок maestro xenitV1 Скилл maestro превращает агента в архитектора: ведёт проект по циклу «план — действие — проверка» и хранит память между сессиями. CX Codex +1 604установок maestro-e2e raphaelbarbosaqwerty Скилл maestro-e2e для написания и отладки E2E-тестов на Maestro: логины, регистрация, навигация, диалоги разрешений. Работает с iOS, Android, Flutter, React Native и вебом. CX Codex +1 543установок find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок

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

Весь набор →
verify-maestro Скилл verify-maestro проверяет правки в репозитории Maestro в изолированном окружении: ставит сборку во временный HOME, прогоняет сценарии CLI и сохраняет лог для отчёта. CX Codex +1 ★ 238звёзд репо maestro-coach Скилл maestro-coach для Claude и Codex, который разбирает непонятный вопрос по шагам и объясняет концепт за решением на реальном коде вашего репозитория. 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звёзд репо

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

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