structured-interview
Skill2 starsChanged 2 months agoMITView on GitHub
Interview the user about a plan, design or decision until every open branch is resolved. Use when a request is ambiguous, when scope is unclear, before writing a spec or estimate, when the user asks to be challenged or stress-tested, or when you are about to build something and are not certain what \"done\" means.
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 27
Never ask the user for something you can find out.
- Distinctive: line 29
Do not block the whole round on one lookup.
- Distinctive: line 48
Do not turn this into a form.
- Distinctive: line 56
When a decision was hard, non-obvious, or is likely to be questioned in three months, note it as a decision with its reasoning so the next …
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<!-- Generated from SKILL.md by scripts/build-harnesses.mjs. Do not edit by hand; run `npm run build`. --><!-- Source: skills/deliver/structured-interview/SKILL.md -->Interview the user until you and they share the same picture of what is being built. Treat the work as a decision tree: every decision opens the decisions that hang off it.
Work in rounds. The frontier is every decision whose prerequisites are already settled, so you can ask it now without guessing at an answer you have not heard yet. Ask the whole frontier in one round. Then stop and wait.
Format every question like this:
Q1 - <short title>
<the question, with the options you see and the trade-off between them>
Recommended: <your answer, and the one-line reason>Always give a recommendation. An interview that only asks costs the user energy; an interview that recommends lets them agree, disagree, or correct you, which is three times faster. Being wrong in a recommendation is useful, because the correction tells you more than a blank answer would.
Each round reshapes the tree. Settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. If a question's answer depends on another question that is still open in this round, it belongs to a later round.
Facts are yours, decisions are theirs
Never ask the user for something you can find out. If a question needs a fact from the environment, go and get it: read the repo, query the environment, check the documentation, run the CLI. Look it up rather than asking.
Do not block the whole round on one lookup. An in-flight investigation is just an unsettled prerequisite: the questions downstream of it wait, and you ask the rest of the frontier now.
The judgement calls are the user's. Put each one to them and wait. Do not decide on their behalf and mention it afterwards.
What must be settled
The interview is not done because the functional behaviour is clear. On the Microsoft stack, the decisions that sink projects are rarely functional. Before you call the frontier empty, confirm each of these is either settled or explicitly deferred with the user's agreement:
- Surface. Which thing is actually being built on, and why that one rather than the neighbouring option.
- Operator. Who owns this once it is live, and whether they can maintain what you are proposing.
- Identity. Who the agent acts as, and what it can reach when it does.
- Licensing and cost. What this consumes, who pays, and whether the user population is licensed for it.
- Environments and ALM. Where it is built, how it gets to production, and who can ship.
- Data. Where the data lives, where it may travel, and what must not leave.
- Governance. What has to be approved, and by whom, before this is allowed to exist.
- Done. What observable thing proves it works.
See references/dimensions.md for the specific question to ask under each, and the answers that should worry you.
Do not turn this into a form. Fold these in as branches of the tree when they become relevant. If one is genuinely irrelevant, say so and move on.
Finishing
The session ends when the frontier is empty: every branch visited and nothing left silently assumed.
Then write back a short summary of what was decided, in the user's own vocabulary, and ask them to confirm it. Do not start building until they do. If they correct the summary, that correction is a new round, not a formality.
When a decision was hard, non-obvious, or is likely to be questioned in three months, note it as a decision with its reasoning so the next person does not relitigate it.
Other versions1 project uses a version of this.
Word for word · 1
- RagnarPitla/microsoft-agent-skills★ 0100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository43 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .cursor/rules/ask-ragnar.mdcCursor rule
- .cursor/rules/assess-change-blast-radius.mdcCursor rule
- .cursor/rules/choose-agent-platform.mdcCursor rule
- .cursor/rules/copilot-studio-auth-patterns.mdcCursor rule
- .cursor/rules/copilot-studio-knowledge-grounding.mdcCursor rule
- .cursor/rules/copilot-studio-production-patterns.mdcCursor rule
- .cursor/rules/de-slop.mdcCursor rule
- .cursor/rules/discovery.mdcCursor rule
- .cursor/rules/evaluate-agent-quality.mdcCursor rule
- .cursor/rules/explain-concept.mdcCursor rule
- .cursor/rules/govern-agent-lifecycle.mdcCursor rule
- .cursor/rules/ground-agents-in-work-context.mdcCursor rule
- .cursor/rules/migrate-agent-to-skills.mdcCursor rule
- .cursor/rules/monitor-agent-telemetry.mdcCursor rule
- .cursor/rules/plan-agent-capacity-and-cost.mdcCursor rule
- .cursor/rules/power-platform-alm-connection-refs.mdcCursor rule
- .cursor/rules/respond-to-agent-incidents.mdcCursor rule
- .cursor/rules/review-copilot-studio-agent.mdcCursor rule
- .cursor/rules/structured-interview.mdcCursor rule
- .cursor/rules/what-should-i-build.mdcCursor rule
- .cursor/rules/write-a-skill.mdcCursor rule
- ask-ragnarSkill
- assess-change-blast-radiusSkill
- choose-agent-platformSkill
- copilot-studio-auth-patternsSkill
- copilot-studio-knowledge-groundingSkill
- copilot-studio-production-patternsSkill
- de-slopSkill
- discoverySkill
- evaluate-agent-qualitySkill
- explain-conceptSkill
- govern-agent-lifecycleSkill
- ground-agents-in-work-contextSkill
- migrate-agent-to-skillsSkill
- monitor-agent-telemetrySkill
- plan-agent-capacity-and-costSkill
- power-platform-alm-connection-refsSkill
- respond-to-agent-incidentsSkill
- review-copilot-studio-agentSkill
- what-should-i-buildSkill
- write-a-skillSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

