interview
Skill187 starsChanged 5 months agoMITView on GitHub
Clarify and stress-test an engineering idea before roadmap or specification. Use for a product, feature, or technical change whose problem, outcome, scope, or key assumptions are unsettled: "interview {slug}", "idea brief", "stress test this idea", "/sdd:interview {slug}", "бриф ідеї", "розбери цю ідею", "погрилити ідею". Reuses existing context, adapts questions to uncertainty, checks decision-changing facts, and requests independent critique when risk warrants it. Returns a short brief with decisions, evidence, unknowns, and a justified next step. Does not implement code, design the architecture, or write specify's detailed requirements.
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
- 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
- hiddenjobs/job-search-mcp★ 25same 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 repository22 other files it gives its agents.
- apiSkill
- clarifySkill
- classify-sizeSkill
- configSkill
- data-modelSkill
- decide-adrSkill
- designSkill
- design-systemSkill
- fixSkill
- glossarySkill
- implementSkill
- plan-testsSkill
- reviewSkill
- roadmapSkill
- scaffoldSkill
- screensSkill
- sequencesSkill
- shipSkill
- specifySkill
- surveySkill
- tasksSkill
- ux-flowsSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 4 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 80 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 54
Ask one substantive question at a time, adapting to the answer.
- Distinctive: line 62
Never turn a hypothetical failure signal into an observed incident.
- Very specific: line 80
Check decision-changing facts: Follow references/research.md: local evidence first, primary external sources when needed.
- Very specific: line 111
Run the five-item structural self-check per ../_shared/self-check.md, re-reading the saved brief (or emitted conversation artifact when …
- Distinctive: line 115
All eight exact template headings are present with nonempty content.
- Distinctive: line 116
No template instruction comments or unfilled template placeholders remain.
- Very specific: line 135
Only ready outcomes hand off to specify/roadmap.
“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
Skill: interview
Turn an unsettled engineering idea into a traceable decision: what problem to address, for whom, within which constraints, and what evidence is still needed. One interviewer owns the conversation; optional helpers research or critique a bounded question, never interview the user.
Brief prose follows artifact_language; headings/tokens stay stable per
../_shared/artifact-language.md.
Owner and inputs
The idea owner supplies intent and tradeoffs. Read their message, supplied ticket/links, any
existing docs/idea-brief.md, and relevant project instructions/map. Use the current conversation
as input: never ask the person to repeat an answer already given. A slug is optional; reuse or
propose one without spending a question unless identity is ambiguous.
Primary scope: product, feature, technical change. An already actionable bug belongs to fix;
an already settled feature can go to specify. For a non-engineering idea, explain the scope and
offer a general discussion; do not force it through engineering checks or overwrite a project brief.
Write and interaction gates
- Locate the Git root once, read-only. Outside a repo: write nothing, including settings.
- Plan Mode: write nothing; keep the proposed brief in the conversation until writing is allowed.
- Headless / no human response channel: stop before any write or helper dispatch. State what needs an answer. Pre-filled examples and a simulated person's choices are not actual user answers.
- An existing brief is read first. Same idea → update only changed sections. Different idea or uncertain identity → ask how it relates; do not merge or replace it silently.
- Settings are read at entry; creation is deferred to the final authorized write point below.
Depth, questions, and evidence
Resolve the question ceiling from explicit --depth=easy|medium|hard, else saved
interview_depth, else medium. No opening depth-selection question. The adaptive interview
exception and ceilings live in ../_shared/interview-depth.md.
State the ceiling and the current reason for research/critique in one short line. Stop early
when the decision is clear; depth never forces research or a quota of questions.
Ask one substantive question at a time, adapting to the answer. Use choices for decisions
and open text for facts/experience; recommend a decision only when its basis is clear. The
interview-specific exception in ../_shared/ask-style.md overrides its
generic long-menu requirements. Use the host's actual question channel per
../_shared/tool-adapters.md. Research tools cannot answer for the owner.
Evidence classes: owner-reported, source-verified, assumption, unknown. Agreement with a recommendation is a decision, not independent evidence for its factual premises. Never turn a hypothetical failure signal into an observed incident. Keep sources and limits visible.
Protocol
- Gather context. Apply the gates above. Preserve the raw idea verbatim. Classify product /
feature / technical change. Read supplied material, the existing brief, instructions, and a
relevant architecture map. Use scoped code reading to answer a named question; do not run a
full
surveyor scan unrelated areas. List known facts and consequential unknowns. - Choose the next useful question. Owner intent/tradeoff → ask. Discoverable fact → inspect
or research. Unknown requiring new observations → name an experiment/data source. Prioritize
answers that can change direction, scope, or whether to proceed. Probe concrete problems,
affected actors, observable outcomes, constraints, non-goals, and existing workarounds.
Write as you go (
../_shared/write-and-commit.md): when the gates allow writes, after the first real owner answer copytemplates/idea-brief.mdtodocs/idea-brief.md(§1 = raw words,status: Draft), then write each section as soon as its content settles. Same-idea existing brief → patch the changed section in place; a different or uncertain idea is never written over before the owner says how it relates. No-write mode → the gates above win, nothing lands. - Check decision-changing facts. Follow
references/research.md: local evidence first, primary external sources when needed; usesdd:researcherin explicitfact-checkmode for a bounded gap. Inspect its evidence before relying on it. Return to step 2 only for a new decision or contradiction, not to repeat an answered question. - Stress-test the direction. Select fitting lenses from
references/probing-frames.md. Include existing contracts, reversibility, operational ownership, and how success/failure will be observed. Consequential access/data/public-contract changes, hard-to-reverse commitments, or an explicit stress-test request →sdd:devils-advocatein explicitinterviewmode, at most three grounded findings. The helper sees the raw idea, accepted decisions, evidence and unknowns, not a persuasive summary. Resolve findings with the owner when they change intent or accepted risk. - Choose the next action. Summarize the direction, strongest evidence, weakest assumption,
and tradeoff. Offer a simpler/reuse/no-change alternative when it is credible; never fabricate
three options. Record whether the owner accepted the recommendation. Outcomes are
ready-for-specify,ready-for-roadmap,needs-evidence,reframe, orstop. A blocking unknown or unconfirmed consequential choice prevents either ready outcome. An exhausted question/research budget preserves the blocker; it never implies acceptance. User says "summary" → stop questions and report the actual incomplete state. - Persist and hand off. In a writable repo with real user answers, fill
templates/idea-brief.mdwithout expanding it into a spec. Preserve eight headings and exactly four frontmatter keys;depthis the resolved ceiling,statusstaysDraft(readiness is in §7). Ensure the settings file at this write point using../_shared/settings-file.md: create if absent, never overwrite values; onlyconfigchanges settings. Then finish the sections not yet on disk, run the checks below, and only after they pass commit per../_shared/write-and-commit.md: one commitinterview: <slug> idea-brief.md(the.gitignorepatch rides in it). Outside a repo / in Plan Mode, return the brief in the conversation, without settings, file writes, or a commit. Emit the utility stage-handoff block per../_shared/handoff.md: What I did, Review, Run next.
Verification and Definition of Done
Run the five-item structural self-check per
../_shared/self-check.md, re-reading the saved brief (or emitted
conversation artifact when writes are prohibited):
- All eight exact template headings are present with nonempty content.
- No template instruction comments or unfilled template placeholders remain.
- Exactly
status/owner/updated_at/depth:Draft, identified owner (or explicitly unassigned), today's date, resolved easy/medium/hard ceiling; no invented keys. - §1 matches the actual raw user words verbatim; later changes did not replace the baseline.
- Repo write → file exists at the Git root's
docs/idea-brief.md; no-write mode → brief is in the conversation and no brief/settings/.gitignore changes were made.
Explicit "None identified" is valid; do not invent a risk or open question to fill a section. Report the structural result as N/5, separately from the evidence/readiness judgment below.
Also verify: raw words unchanged; material assertions have an evidence class and origin; accepted decisions are distinguished from proposals; sources were actually inspected; every blocking unknown has consequence + verification action + owner (or explicitly unassigned); the readiness outcome agrees with blockers and user decisions. Technology names are allowed in quotes, evidence, and existing/owner-required constraints, not as unagreed design choices. Fix + re-check at most twice; report unresolved problems rather than a clean verdict.
Report structural and evidence/readiness results separately. A complete interview may
legitimately end needs-evidence, reframe, or stop; it is not necessarily ready to specify.
Only ready outcomes hand off to specify/roadmap; the others name the next evidence action,
reframing question, or reason to stop. specify consumes the brief using
../specify/references/brief-reuse.md.
Worked dialogue and interrupted-run behavior →
references/annotated-pass.md.
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.

