agentleFS
ajittaajitta/know-your-unknowns/skills/interview/SKILL.md

interview

Skill2 starsChanged 16 days agoMITView on GitHub

The interview — before deciding, the model asks the user, in rounds of at most four, what it cannot know or judge about their situation: open questions first, then options for each decision, biggest blast radius first; ends with a decision table and a ready prompt. Any domain. Use on "interview me", "ask me questions before implementing", "ask me before you decide", or when requirements are incomplete and the work has not started. Clear to both sides: no skill or method.

94 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use fetch-library-docs, contributor and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Rehan-Ul-HaqSkill

    fetch-library-docs

    Fetches official documentation for external libraries and frameworks (React, Next.js, Prisma, FastAPI, Express, Tailwind, MongoDB, etc.) with 60-90% token savings via content-type filtering. Use this skill when implementing features using library APIs, debugging library-specific errors, troubleshooting configuration issues, installing or setting up frameworks, integrating third-party packages, upgrading between library versions, or looking up correct API patterns and best practices. Triggers automatically during coding work - fetch docs before writing library code to get correct patterns, not after guessing wrong.

    Also in 4 projects that use this

  • NimbleBrainIncSkill

    contributor

    Get started contributing to NimbleBrain open source — find an integration to build, set up your environment, propose an idea, or check on your work. Use when onboarding as a contributor. Triggers include "I'm a new contributor", "what should I build", "show me open issues", "file an issue".

    Also in 3 projects that use this

  • mjunaidcaSkill

    browsing-with-playwright

    Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction. NOT when only fetching static content (use curl/wget instead).

    Also in 4 projects that use this

  • trebaudSkill

    find-unknowns

    Workflow for surfacing a task's unknowns before, during, and after implementation — blind spot pass, brainstorm/prototype, interview, references, implementation plan, deviation notes, quiz. Use when starting work in an unfamiliar domain or codebase, when a task feels underspecified, when the user says "find my unknowns", "blindspot pass", "what am I missing", "help me scope this", or when a long task came back wrong.

    Also in 3 projects that use this

  • donatassimkusSkill

    offer

    Offer design, pricing strategy, and business model architecture. Invoke when asked about making an offer better, pricing a product or service, naming an offer, raising prices, generating fast cash, increasing lifetime value, finding the right customer, qualifying buyers, or designing a business model where customers pay for their own acquisition. Use when someone says their offer isn't converting, they need to charge more, they want to add bonuses or guarantees, or they need a money model for their business.

    Also in 3 projects that use this

  • galsapirSkill

    long-horizon

    Transform a user's draft prompt into a long-horizon coding-agent task prompt. Use when the user asks to make a prompt long-horizon, turn something into a long-running agent task, add long-horizon scaffolding, or invokes "$long-horizon" or "/long-horizon". Appends framing for running far without unnecessary stops, using subagents for scoped background work, and maintaining implementation-notes.html with decisions, deviations, tradeoffs, and open questions.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 80 edited versions we read keep these.

  • 3

    Distinctive

    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
  1. Distinctive:

    When requirements are incomplete, you interview the user before anything is decided: the answers sit with the user, and a decision made …

    line 18
  2. Distinctive:

    When the user wants a deep interview (e.g.

    line 52
  3. Distinctive:

    When every item is decided or left undecided by the user and no why follow-up from step 4c is pending, or when the user ends the interview, …

    line 56

“Common” is measured: kept by at least 6 in 10 of the 80 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Interview — Before-Deciding Interview

This skill serves what you do not know and the user does: before deciding, it asks what you cannot know or judge about the user's situation.

When you and the user both seem to understand the request, do it without this method: if its result carries weight (it ships, is sent or is hard to undo), first read back in 2–3 lines the request as you understand it, the assumptions you are making and what outcome counts as done, as the whole reply, and do it once the user confirms; a self-evident request (fix a typo) needs no read-back. When the read-back exposes a mismatch, route by who does not know: the user → the teach-me skill; you → the interview skill; neither of you → the blindspot skill. A misread weighty request costs the work built on it; a read-back costs one exchange.

When requirements are incomplete, you interview the user before anything is decided: the answers sit with the user, and a decision made without them is a guess about their situation.

Question Priority (blast radius: what a wrong decision breaks; the order never changes)

  1. Structure: answers that change the shape of the whole work (the architecture of a system, the format of an event, the design of a study)
  2. Harm: answers that could cause loss or harm that cannot be undone (data loss or a security problem, money spent, legal exposure, people affected)
  3. Compatibility: fit with what already exists and depends on it (external APIs and existing code, commitments, other people's plans, rules in force)
  4. Cost: ongoing cost and performance (operating cost, time, budget, effort)
  5. Taste: taste and minor details (last)

Procedure

  1. Find the gaps.

    a. Investigate the conversation and the available material (documents, data, a codebase) before listing gaps. From the text the user gave with the request or after the skill name and conversation context, list the gaps only the user can fill: decisions that are theirs, and facts about their situation you cannot know or judge from here (constraints, the people involved, local rules, priorities). Leave out any gap the conversation or material already answers. With no request text, use the spec under discussion; with no spec under discussion either, ask once what to interview about.

    b. When the user has not yet said what they are sure of and what they are assuming, make that the first question of round 1; a list of what is still open does not say it. Settled items are not asked again, and stated assumptions become questions of their own.

  2. Ask the round.

    a. Ask max 4 questions per round, in priority order within every round (the Question Priority above). Each question asks one thing, in one sentence ending in a question mark. Every question in the reply counts toward the 4: a second question mark inside an item ("Also: …?"), one inside an option or a reason, a request for a fact (a file path, a date, a headcount), and a request that the user check something elsewhere; move a fifth to the next round. When the question tool takes fewer questions or options, split the round across calls; the round still totals at most four.

    b. Round 1 asks open questions, without options, about what you cannot know or judge about the user's situation: the facts, constraints, people and priorities behind the gaps from step 1, one thing per question. Options written before you know the situation carry your guesses into the questions; the user's own words show what the decisions turn on.

    c. From round 2 on, ask option questions for the decisions: each question asks for one decision, with 2–4 options, and each option carries a short consequence (tradeoff) note. A why follow-up from step 4c stays open, without options.

    d. Attach a one-line reason why it matters to every question, follow-ups and requests for facts included.

  3. Collect the answers before updating the spec in step 4.
  4. After the answers:

    a. On answers, restate the decisions as an updated spec summary.

    b. When unsettled items remain (items the user has neither decided nor chosen to leave undecided), propose the next round.

    c. Ladder once on the load-bearing answers: a structure or harm answer that came without a reason gets one "why" follow-up at the top of the next round ("what would break for you if it went the other way?"), asked open with its why-it-matters line and no options, so the reason is the user's own. Follow-ups count toward the round's 4 questions. When no unsettled items remain, the follow-ups make up the next round on their own. The reason, not the choice, is what lets a later deviation be judged — the reason fills the decision table's rationale column.

  5. When the user wants a deep interview (e.g. "40-question level"), repeat rounds in the same order: structure → harm → compatibility → cost → taste.

Final Deliverables

When every item is decided or left undecided by the user and no why follow-up from step 4c is pending, or when the user ends the interview, present two things:

  1. Decision table with the columns blast radius (structure / harm / compatibility / cost / taste), question, decision, rationale, left undecided.
  2. Ready-to-use prompt for the work: a complete instruction with all decisions applied. In the prompt:

    • Mark skipped questions "(unanswered — use your judgment)". A question that was asked but not answered is a skipped question: its options and any reason for it stay out of the fixed decisions.
    • Declare the structure and harm decisions fixed.
    • Close with "start with a short plan, then do the work".
    • Include: "Where the plan leaves a choice open or the work conflicts with a fixed decision, pick the conservative option and log the deviation in the deviation log (IMPLEMENTATION_NOTES.md for code work, otherwise the file the user names or DEVIATIONS.md beside the deliverable)."

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.