interview
Skill2 starsChanged 11 days agoMITView on GitHub
Interview the user in depth (via the AskUserQuestion tool) to turn a rough idea, plan file, or feature request into a concrete spec — then capture the result one of three ways. Use when the user runs /interview, or asks you to "interview me about this plan/feature", "grill me on the details", "flesh this out into a spec", or "turn this into Linear issues". Not for casual clarifying questions — this is a deep, iterative interview.
94 other projects use a version of this.
Adopted by
Most recently taken up by
- chrisdesmondSML/chris-skillstheir own version, first seen Nov 8, 2026
- Firzus/agent-skillstheir own version, first seen Nov 8, 2026
- claude-code-hardened/claude-code-hardenedtheir own version, first seen Nov 8, 2026
- MMACABRE/SKILLStheir own version, first seen Nov 8, 2026
- yuri-xyz/skillstheir own version, first seen Nov 8, 2026
- codewhale-hq/codewhale-plugin-marketplacetheir own version, first seen Nov 8, 2026
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-HaqSkillfetch-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
NimbleBrainIncSkillcontributor
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
mjunaidcaSkillbrowsing-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-amanSkillteach-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
trebaudSkillfind-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
donatassimkusSkilloffer
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
Other versions94 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 94
- claude-code-best/claude-code★ 23ksame name
- Q00/ouroboros★ 6.3ksame name
- Hisn00w/ASu-skills★ 6.1ksame name
- boshu2/agentops★ 453same name
- genkovich/sdd★ 187same name
- jvm-skills/jvm-skills★ 140same name
- kv0906/pm-kit★ 138same name
- tobieapb/claude-interactive-documentation-workflow★ 105same name
- panaversity/claude-code-skills-lab★ 57same name
- roman01la/skills-agents★ 48same name
84 more not listed
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 repository27 other files it gives its agents.
- AGENTS.mdAGENTS.md
- cmux-agent-orchestratorSkill
- cmux-pr-qc-agentSkill
- cmuxSkill
- finchSkill
- peekSkill
- gmail-inbox-zero-triageSkill
- gmail-oib-zeroSkill
- whatsapp-triageSkill
- add-to-changelogSkill
- check-prSkill
- cli-reviewSkill
- coderabbit-requestSkill
- convex-domain-folderSkill
- e2e-remote-setupSkill
- greploopSkill
- update-docsSkill
- antigravity-cliSkill
- social-captureSkill
- check-model-usageSkill
- code-structureSkill
- evidence-driven-testingSkill
- issue-breakdownSkill
- linear-labelsSkill
- model-classifierSkill
- remotion-explainer-videoSkill
- skill-makerSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 2 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 80 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 18
Ask about anything that matters: technical implementation, UI/UX, data model, edge cases, failure modes, scope, concerns, tradeoffs, …
- Distinctive: line 19
Make the questions non-obvious: Don't ask what you could infer from the code or the request.
- Very specific: line 29
When interviewing about a feature or refactor (a description, a comment, a ticket), write the finished spec to ./plans/<spec-name>.md …
- Very specific: line 32
When the user wants issues created, after the interview use the linear-* skills to create:
“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.
Files
Interview
Interview the user thoroughly, then persist the result. The goal is to close the gap between what they have in their head and what's actually written down — surfacing decisions, tradeoffs, and edge cases they haven't thought about yet.
How to interview
- Use the AskUserQuestion tool for every question — never a wall of prose questions. Batch up to 4 at a time, with smart multiple-choice options plus room for free-text.
- Ask about anything that matters: technical implementation, UI/UX, data model, edge cases, failure modes, scope, concerns, tradeoffs, non-goals.
- Make the questions non-obvious. Don't ask what you could infer from the code or the request. Ask the things that would actually change the design.
- If you're in a git repo, read the relevant codebase first and ask questions grounded in it (existing patterns, conventions, where this fits).
- Keep going — interview continually, round after round, until the picture is genuinely complete. Don't stop early.
Modes — pick based on what the user asked for
1. Plan file (default)
/interview <plan-file> — read the given plan/spec file, interview to fill its gaps, then write the finished spec back to that same file.
2. Feature → plans/
When interviewing about a feature or refactor (a description, a comment, a ticket), write the finished spec to ./plans/<spec-name>.md (create the plans/ dir if needed). Ground the questions in the current codebase.
3. Feature → Linear
When the user wants issues created, after the interview use the linear-* skills to create:
- A Linear project capturing the what / why / how / key features.
- Issues under the repo's team (usually named similarly to the repo), each ≤ 3 points of effort — break anything larger down.
- Links between issues for blockers / dependencies.
- Project-level dependency links — before finishing, check the team's other projects and link the ones this new project depends on. Every new project should get ≥1 project dependency unless it's genuinely foundational (rare). These are project↔project relations (not issue relations): the Linear MCP and
linear-cli reldon't create them — useprojectRelationCreatevialinear-cli api mutate,type: "dependency", with the prerequisite anchoredendand the dependent anchoredstart({ projectId: <prereq>, anchorType: "end", relatedProjectId: <new project>, relatedAnchorType: "start" }). The reverse anchor order won't render in the Dependencies column.
Finish
State clearly where you wrote the spec (file path or Linear project/issue links) and give a short summary of the key decisions the interview locked in.
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.

