Agent skill

Maestro Questionnaire

by ReinaMacCredy in ReinaMacCredy/maestro

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.

MITAuto-check passedMobile

Install Maestro Questionnaire

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ReinaMacCredy/maestro maestro-questionnaire --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ReinaMacCredy/maestro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/plugins/skills/maestro-questionnaire .claude/skills/maestro-questionnaire && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
maestro-questionnaire
GitHub stars
233
Token cost
~946 tokens
SKILL.md length
525 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 3 steps: Who is it going to? Ask, in one… → What do you need back? Ask, in one… → Write the questionnaire. Draft questions…
  • Vietnamese phrasings such as phỏng vấn đi
  • SKILL.md covers Document structure, Context, How to answer and Anything else?
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Maestro Questionnaire is an agent skill from ReinaMacCredy/maestro. 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.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Mobile testing and debugging. The repository describes itself as: Local-first coordination for human and agent work: durable work, decisions, dispatches, evidence, and prompt-first methods, powered by TypeScript and Bun. The licence is MIT.

When your agent uses it

  • Vietnamese phrasings such as phỏng vấn đi
  • Tasks that involve Mobile testing and debugging

Example prompts

  • “/maestro-questionnaire”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Who is it going to? Ask, in one exchange, the recipient's role,
  2. What do you need back? Ask, in one exchange, the specific decisions
  3. Write the questionnaire. Draft questions aimed at the gap from steps

What it can do on your machine

Read from SKILL.md and the folder at commit 2412403. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Maestro Questionnaire loads about 946 tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 525 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~946

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ReinaMacCredy/maestro at commit 2412403, republished under its MIT licence (© ReinaMacCredy). 525 words, ~946 tokens.

Download SKILL.mdSave it as .claude/skills/maestro-questionnaire/SKILL.md (or your agent's skills folder).
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.

Show full SKILL.md (207 more words)Show less

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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in src/plugins/skills/maestro-questionnaire of ReinaMacCredy/maestro.

Open the folder on GitHubat commit 2412403

Compare with similar skills

Maestro Questionnaire next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Maestro Questionnaire compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maestro Questionnaire this skillReinaMacCredy/maestro233—~946Automated safety check: PassMIT
Phone HarnessShawnPana/phone-harness3.2k—~7.7kAutomated safety check: PassMIT
Maa Issue Log AnalysisMaaAssistantArknights/MaaAssistantArknights24k—~4kAutomated safety check: PassAGPL-3.0
Mobile QAtloncorp/tlon-apps107—~2.4kAutomated safety check: PassMIT
Store Listing Screenshotstherxmv/Telegram-Themer119—~2.5kAutomated safety check: PassNone
Androidyang1ming/android-harness176—~259Automated safety check: PassMIT

Similar skills

  • Phone Harness

    ShawnPana/phone-harness

    Control the user's phone - an iPhone through the Mac's iPhone Mirroring window, an Android over adb, a rented cloud Android, or a cloud iPhone over HTTPS: open apps, tap, type, swipe, read the screen.

    3.2k GitHub stars~7.7k tokensUpdated today
    MobileAuto-check passed
  • Maa Issue Log Analysis

    MaaAssistantArknights/MaaAssistantArknights

    分析 MaaAssistantArknights 上游仓库公开 Issue(https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/...

    24k GitHub stars~4k tokensUpdated today
    MobileAuto-check passed
  • Mobile QA

    tloncorp/tlon-apps

    Run a mobile QA checklist on a physical Android device over adb for tlon-apps, then triage what fails into fixes.

    107 GitHub stars~2.4k tokensUpdated yesterday
    MobileAuto-check passed
  • Store Listing Screenshots

    therxmv/Telegram-Themer

    Generate TelegramThemer's Play Store listing images — capture the 8 required app screenshots on a running emulator/device by driving the real UI with adb, then composite them into the final…

    119 GitHub stars~2.5k tokensUpdated 1 mo ago
    MobileAuto-check passed
  • Android

    yang1ming/android-harness

    Direct Android device control through ADB. An agent skill from yang1ming/android-harness.

    176 GitHub stars~259 tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Dongle Crash Analysis

    haumacher/phoneblock

    Decode and analyze an ESP32 dongle crash report (uploaded .coredump).

    367 GitHub stars~1.9k tokensUpdated 8 days ago
    MobileAuto-check: notes

More from ReinaMacCredy/maestro

All 11 skills in this repo
  • Maestro Improve

    ReinaMacCredy/maestro

    Turn filed lessons into the smallest doctrine edit. An agent skill from ReinaMacCredy/maestro.

    233 GitHub stars~1.9k tokensUpdated 13 days ago
    Auto-check passed
  • Maestro Council

    ReinaMacCredy/maestro

    Lead-only council for a hard-to-reverse fork - a neutral brief, sealed independent seats, one premise verifier on unanimity, bounded verifiers, one cross-examination round, a draft-verdict audit…

    233 GitHub stars~2.9k tokensUpdated 13 days ago
    Auto-check passed
  • Maestro Design

    ReinaMacCredy/maestro

    Resolve material unknowns blocking the next authorized slice, using research, grilling, prototypes, models, or wayfinding.

    233 GitHub stars~2.1k tokensUpdated 13 days ago
    Auto-check passed
  • Maestro Graph

    ReinaMacCredy/maestro

    Drive a pre-known multi-agent path as a maestro graph - run it by name or from a file you just wrote, pull each agent node with graph next, spawn it as a sub-agent under its maestro-<profile…

    233 GitHub stars~2.1k tokensUpdated 13 days ago
    Auto-check passed
  • Maestro Verify

    ReinaMacCredy/maestro

    Verify and close - cross-check coverage, run the VERIFY table, deliver the verdict, harvest durable lessons into decisions, close the bundle, and never claim remote state from local evidence.

    233 GitHub stars~1.9k tokensUpdated 13 days ago
    Auto-check passed
  • Maestro Work

    ReinaMacCredy/maestro

    Implement or fix one authorized unit with minimal edits and sufficient evidence.

    233 GitHub stars~2.6k tokensUpdated 13 days ago
    Auto-check passed

Categories

Questions about Maestro Questionnaire

What does Maestro Questionnaire do?

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. Maestro Questionnaire is an agent skill from ReinaMacCredy/maestro. 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.

When should I use Maestro Questionnaire?

Maestro Questionnaire fits situations like: vietnamese phrasings such as phỏng vấn đi; tasks that involve Mobile testing and debugging.

How do I install Maestro Questionnaire in Claude Code?

Run `npx skills add ReinaMacCredy/maestro --skill maestro-questionnaire -a claude-code`. Or copy the skill folder (src/plugins/skills/maestro-questionnaire in ReinaMacCredy/maestro) into .claude/skills/maestro-questionnaire in your project. Claude Code loads it when a task matches its description.

How do I install Maestro Questionnaire in Codex?

Run `npx skills add ReinaMacCredy/maestro --skill maestro-questionnaire -a codex`. Or copy the skill folder (src/plugins/skills/maestro-questionnaire in ReinaMacCredy/maestro) into .agents/skills/maestro-questionnaire in your project. Codex loads it when a task matches its description.

Can I use Maestro Questionnaire in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ReinaMacCredy/maestro --skill maestro-questionnaire -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/maestro-questionnaire, .gemini/skills/maestro-questionnaire, .github/skills/maestro-questionnaire and .opencode/skills/maestro-questionnaire in your project.

What does Maestro Questionnaire need to run?

SKILL.md names no scripts, command-line tools or credentials: Maestro Questionnaire is instructions for the agent only.

Does Maestro Questionnaire access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Maestro Questionnaire safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Maestro Questionnaire use?

Maestro Questionnaire is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Maestro Questionnaire use?

About 946 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Maestro Questionnaire?

Skills that share tags, products or a category with Maestro Questionnaire: Phone Harness (ShawnPana/phone-harness, 3.2k stars), Maa Issue Log Analysis (MaaAssistantArknights/MaaAssistantArknights, 24k stars), Mobile QA (tloncorp/tlon-apps, 107 stars) and Store Listing Screenshots (therxmv/Telegram-Themer, 119 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maestro Questionnaire?

ReinaMacCredy (a GitHub user) maintains it in ReinaMacCredy/maestro, which has 233 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 28, 2026.

Source: ReinaMacCredy/maestro on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.