agentleFS
OHOKAYYEAHOHOKAYYEAH/claude-skills/skills/interview/SKILL.md

interview

Skill1 starsChanged 33 days agoMITView on GitHub

Interrogate the user's intent before executing an ambiguous or under-specified task — ask the sharp clarifying questions, then restate your understanding and lock it before proceeding. Fire when the user explicitly asks to be interviewed / "ask me questions first" / "make sure you understand before you build", or when an orchestrator chains this to capture intent (e.g. /create-skill). This is the deliberate, thorough counterpart to the single-sharp-question default (e.g. /work step 1) — when invoked, multiple questions are wanted. Do NOT fire proactively on every fuzzy task. NOT /recommend (that commits to a pick, or to what's next); NOT /spec (freezes settled intent onto the ticket — chain it after this when a build follows).

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 10 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

  • qa-amanSkill

    teach-me

    Teach a topic, video, article, codebase change, spec, or transcript until the user demonstrably understands it, using staged instruction, a running checklist doc, and quizzes. Use whenever the user says "teach me", "explain this in detail", "help me understand X", "/teach-me", "walk me through this", "I want to learn X", "understand this deeply", or pastes a YouTube URL, article, paper, PR, or spec and asks to understand it rather than summarize it. Also use when the user wants study notes or raw material from a source they are learning. Do NOT use for a quick factual lookup, a summary request, or when the user just wants the answer.

    Also in 8 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

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:

    Keep the restatement tight.

    line 33
  2. Distinctive:

    One pass of real questions, then lock: Don't drip-feed an endless interrogation.

    line 44
  3. Distinctive:

    Only on an explicit ask or an orchestrator's chain.

    line 46

“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

You've invoked the interview. You've loaded context you sense is not fully clear, and you want it interrogated before execution — not guessed at, not charged ahead on a plausible reading. The whole value is catching a misunderstanding now, while it's a question, instead of after it's shipped code.

This is the deliberate opposite of the "ask ONE sharp question and move on" default. Here, asking several real questions is the point. But thoroughness is not the same as volume — see signal discipline below.

The move

1. Scope what you're interrogating

The task/context is whatever's in the conversation, narrowed by any focus in $ARGUMENTS. If genuinely nothing is on the table to interrogate, say so and ask the user what they want scoped — don't invent a task to interview about.

2. Answer your own questions first

Before you ask the user anything, resolve what you can resolve yourself — read the code, check the conventions, look at sibling files, consult memory. Come prepared. A question you could have answered by reading a file is not a question for the user; asking it wastes their attention and reads as lazy. The questions that survive this filter are the ones that genuinely change what you'd do and that only the user can answer (intent, priorities, taste, business constraints, which-of-these-readings-did-you-mean).

3. Ask the surviving questions — structured, with your own take

Batch the open questions and ask them via the AskUserQuestion tool in a single pass:

  • Multiple-choice where the decision space is discrete; free-form ("Other" is always available) where it's open.
  • Every question carries your recommendation as the first option, marked "(Recommended)", with the why. The user's standing preference: "here are options, I'd pick X because Y" beats "here are options, you decide." Commit to a call in each one; they'll push back if they disagree.
  • Cap at the tool's 4-questions-per-call. If more than four are genuinely open, ask the highest-leverage four first; a second round is cheaper than a wall of questions.
  • Phrase each question so a busy user can answer it in one glance — concrete, specific, no preamble.

4. Lock intent — restate, then confirm

Once the answers are in, synthesize them back into a short, plain restatement of what you now understand:

  • What the user wants, the scope, the key constraints, and what you're about to do as a result.
  • Surface any assumption you're still carrying that they didn't explicitly confirm ("I'm assuming X — say the word if not").
  • Then explicitly hand them the gate: confirm and I proceed, or correct me. This is the intent-lock — the forcing function that makes the interview worth more than just charging ahead.

Keep the restatement tight. It's a confirmation, not a document.

5. Proceed (or hand back)

On confirmation, execute — don't re-ask. If you were chained by an orchestrator (e.g. /create-skill), the confirmed intent is what you hand back so the caller continues; don't treat the interview as a place to start building yourself unless that's your job.

Why the confirm-gate is a legitimate pause (not a chaining bug)

Interviewing inherently needs human input — the AskUserQuestion call and the final confirm both wait on the user. That's correct behavior, not the halt-bug that fork-wrappers exist to fix (an inner skill ending the turn with a terminal report). The AskUserQuestion result returns and execution continues; the final confirm is a real user-decision gate, the same kind /work allows. So this skill is not a context: fork skill — a fork can't talk to the user, which is the entire job. When chained, the orchestrator simply resumes after the user confirms.

Guardrails

  • Signal discipline — don't manufacture questions to look thorough. Same ethos as a good code review: real findings only, no manufactured nits. A short interview on a nearly-clear task is the right outcome; padding it with questions you could answer yourself is the failure mode. If two or three questions cover it, ask two or three.
  • Recommend, don't just enumerate. A question with no recommendation pushes the cognitive load back onto the user — the thing this is supposed to relieve.
  • One pass of real questions, then lock. Don't drip-feed an endless interrogation. Front-load the questions that matter, restate, confirm, go.
  • No charging ahead. The point is to not execute before intent is locked. If you find yourself reaching for Edit/Write before the confirm gate, stop — that's the behavior this skill exists to prevent.
  • Only on an explicit ask or an orchestrator's chain. For an ordinarily fuzzy task, ask one sharp question instead.

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.