agent-interface-design
Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and…
Interview the user one question at a time to resolve remaining ambiguity before implementation. Use when planning or brainstorming is done but unknowns remain, or when the user asks to be interviewed about a task or spec.
$ npx -y skills add Neeeophytee/finding-unknowns-skills --skill interview-me --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/interview-meContext preview
The summary Claude sees to decide when to auto-load this skill.
Interview the user one question at a time to resolve remaining ambiguity before implementation. Use when planning or brainstorming is done but unknowns remain, or when the user asks to be interviewed about a task or spec.
name: interview-me description: Interview the user one question at a time to resolve remaining ambiguity before implementation. Use when planning or brainstorming is done but unknowns remain, or when the user asks to be interviewed about a task or spec.
Brainstorming is over and there are still gaps between the user's map and the territory. Close them by asking, one question at a time, starting with the questions whose answers would change the most.
1. Read everything already established: the request, any spec, any prototypes, relevant code. Do not ask about things that are already answered. 2. Build a private list of open ambiguities and sort by blast radius:
3. Ask exactly one question per turn. For each: give the context that makes it matter, offer 2-3 concrete options with your recommendation, and accept "you decide" as an answer you then own. 4. Every few questions, checkpoint: restate what has been decided so far in one tight list, so drift dies early. 5. Stop when the remaining unknowns are cheaper to discover during implementation than to ask about now, and say that out loud. End with the final decision list, ready to paste into a plan.
14 installable skills that help your coding agent find what you don't know — before it gets expensive to fix. The map is not the territory. Your prompt is a map; the codebase and the real world are the territory.
Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and…
Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach. Use when a plan…
Surface the user's unknown unknowns before work starts. Use when the user is entering an unfamiliar codebase area, an unfamiliar…
Generate several genuinely different throwaway variations (designs, approaches, drafts) for the user to react to. Use when the…
After a working session, produce a report on what changed plus a quiz the user must pass before merging. Use when the user asks…
Audit the instructions an agent already carries — CLAUDE.md, AGENTS.md, skills, tool descriptions — for contradictions,…