Agent skill
interview
This skill conducts discovery conversations to understand user intent and agree on approach before taking action. It should be used when the user explicitly calls /interview, asks for recommendations, needs brainstorming, wants to clarify, or when the request could be misunderstood. Prevents building the wrong thing by uncovering WHY behind WHAT.
Install this agent skill to your Project
npx add-skill https://github.com/alijilani-dev/Claude/tree/main/skills/collection/skills/interview
SKILL.md
Interview Skill
Prevent building the wrong thing. Discover user's intent (WHY), validate assumptions, and agree on approach (WHAT) before taking action.
What This Skill Does
- Discovers INTENT behind surface requests (WHY they want it)
- Surfaces and validates AI's assumptions before acting
- Explores solution options informed by intent
- Reaches mutual agreement on both problem and solution
- Works for any context: software, documents, brainstorming, automation
What This Skill Does NOT Do
- Follow rigid scripts
- Skip to implementation without understanding
- Accept surface requests without exploring intent
- Make assumptions without validating them
Core Problem This Skill Solves
AI builds the wrong thing because it:
- Takes surface requests literally without understanding intent
- Makes hidden assumptions it never validates
- Proceeds without confirming alignment
This skill ensures:
- Intent (WHY) is discovered, not just request (WHAT)
- Assumptions are surfaced and validated
- Both problem and solution are agreed before proceeding
The WHY + WHAT Model
Surface WHAT → Discover WHY → Surface Assumptions →
Informed WHAT → Agree on Both → Proceed
| Phase | Purpose | Example |
|---|---|---|
| Surface WHAT | Capture initial request | "Add dark mode" |
| Discover WHY | Uncover intent/problem | "Eye strain for night workers" |
| Surface Assumptions | Expose AI's hidden assumptions | "Assuming web app, not mobile" |
| Informed WHAT | Solution options based on WHY | "Dark mode + auto-brightness + schedule" |
| Agree on Both | Confirm problem AND solution | "Solving eye strain via dark mode with auto-switch" |
When to Trigger
| Trigger | Example |
|---|---|
| Explicit invocation | /interview, "let's clarify" |
| Request could be misunderstood | Ambiguous, complex, or multi-part requests |
| Recommendations needed | "What should I use for..." |
| Brainstorming | "Help me think through..." |
| High-stakes work | Where wrong output wastes significant effort |
Don't over-trigger: Simple, clear requests don't need full discovery.
Discovery Flow
Before Starting
Gather available context before asking questions:
| Source | Gather |
|---|---|
| Conversation | User's stated request, prior context |
| Available Context | Information already shared in session |
| Skill References | Question patterns from references/ |
1. Surface WHAT
Capture the initial request clearly.
"Let me make sure I understand - you're asking for [X]?"
2. Discover WHY
This is the critical step most AI skips.
Go beyond WHAT to understand WHY:
| Ask | To Discover |
|---|---|
| "What problem does this solve?" | The real need |
| "Why now?" | Urgency and context |
| "What happens if we don't do this?" | Stakes and priority |
| "Who benefits and how?" | Users and value |
| "What led to this request?" | Background and triggers |
Techniques for WHY:
Laddering - Dig into abstract goals:
"Dark mode" → "Why?" → "Eye strain" → "Why an issue?" → "Night shift workers"
5 Whys - Uncover root need:
"Export feature" → Why? → "Share reports" → Why? → "Stakeholder reviews" → Root need
Structuring Clarifications:
When presenting multiple questions, distinguish must-know from nice-to-know:
## Required Clarifications
1. [Critical question - blocks progress]
2. [Critical question - affects core approach]
## Optional Clarifications (if relevant)
3. [Nice-to-know - can assume reasonable default]
Note: Keep to 1-4 questions per round. Build on answers.
3. Surface Assumptions
This prevents "builds wrong thing."
AI always makes assumptions. Surface them explicitly:
"I'm assuming:
- This is for [platform/context]
- Users are [type]
- We need to support [X] but not [Y]
- [Other assumption]
Are these correct?"
Common hidden assumptions:
- Technology/platform
- User expertise level
- Scale/performance needs
- Integration requirements
- What's in vs out of scope
4. Informed WHAT
Now that WHY is clear, explore WHAT options:
"Given that you need [WHY], we could:
1. [Option A] - [trade-off]
2. [Option B] - [trade-off]
3. [Option C] - [trade-off]
Which fits your intent best?"
Key: Options should address the WHY, not just the surface WHAT.
5. Agree on Both
Confirm understanding of BOTH problem and solution:
## Understanding
**Problem (WHY)**: [What we're solving and why it matters]
**Solution (WHAT)**: [What we'll build/do]
**Key decisions**:
- [Decision 1]
- [Decision 2]
**Not included**: [Explicit scope boundaries]
Does this capture it correctly?
Only proceed after explicit confirmation.
Depth Check
How do you know understanding is deep enough?
Surface Understanding (NOT enough)
- Can repeat what user asked for
- Know the immediate request
- Haven't explored why
Deep Understanding (ENOUGH)
- Know WHY they want it, not just WHAT
- Know what problem it solves
- Assumptions are surfaced and validated
- Know who benefits and how
- Know what's explicitly out of scope
- Could explain it to someone else accurately
- User confirmed understanding is correct
Test: If you proceeded now and built something, would user say "yes, that's what I meant" or "no, you misunderstood"?
Assumption Categories
Surface assumptions in these areas:
| Category | Example Assumptions |
|---|---|
| Context | Platform, environment, existing systems |
| Users | Who they are, expertise level, needs |
| Scale | Volume, performance requirements |
| Scope | What's included vs excluded |
| Quality | Standards, constraints, requirements |
| Timeline | Urgency, phases, dependencies |
Anti-Patterns
| Anti-Pattern | What Happens | Fix |
|---|---|---|
| Skip WHY | Build wrong solution | Always ask why before how |
| Hidden assumptions | Surprise misalignment | Surface and validate explicitly |
| Accept surface request | Miss real need | Dig deeper with laddering/5 whys |
| Proceed without confirm | Waste effort | Get explicit "yes, proceed" |
| Over-question simple requests | Annoy user | Match depth to complexity |
Tool Adaptation
Use whatever tools are available:
| Goal | Approach |
|---|---|
| Ask questions | Interactive tools if available, otherwise conversation |
| Research context | Web search if needed and available |
| Present options | Structured choices if available |
The skill describes WHAT to do. The agent uses available tools.
Output: Understanding Summary
Match formality to situation:
Quick (simple requests):
Got it: [WHAT] to solve [WHY]
Proceeding with [approach]. Confirm?
Standard (most cases):
## Understanding
**Problem (WHY)**: [Intent and problem being solved]
**Solution (WHAT)**: [What we'll do]
**Key points**: [Important details]
**Not included**: [Scope boundaries]
Ready to proceed?
Detailed (complex work):
See references/summary-templates.md
Quick Reference
1. Surface WHAT → "You're asking for X?"
2. Discover WHY → "What problem does this solve?"
3. Surface assumptions → "I'm assuming A, B, C - correct?"
4. Informed WHAT → "Given WHY, we could do X, Y, or Z"
5. Confirm both → "So we're solving [WHY] by doing [WHAT]?"
6. Proceed → Only after explicit confirmation
Reference Files
| File | Purpose |
|---|---|
references/question-patterns.md |
Techniques for discovering WHY and surfacing assumptions |
references/anti-patterns.md |
Common mistakes that lead to building wrong thing |
references/summary-templates.md |
Output formats for different situations |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
docker-rocker
Production-grade Docker containerization for FastAPI, Pytest, SQLModel, and Pydantic projects. This skill should be used when users ask to dockerize FastAPI applications, create multi-stage Docker builds, optimize Docker images for Python APIs, set up CI/CD Docker pipelines, or deploy containerized Python web APIs with maximum performance and minimal image size.
fastapi-helper
FastAPI development assistant for building modern Python web APIs. Provides guidance on routing, request/response handling, dependency injection, authentication, middleware, WebSockets, testing, and Pydantic models. Use when: (1) Creating FastAPI applications or endpoints, (2) Implementing CRUD operations, (3) Setting up authentication/authorization, (4) Working with request parameters (path, query, body, headers, cookies, forms, files), (5) Configuring middleware or CORS, (6) Implementing WebSocket connections, (7) Writing tests for FastAPI apps, (8) Defining Pydantic models for validation.
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
internal-comms
A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).
cover-letter-generator
Generate tailored AI-focused cover letters using the PSI (Problem-Solution-Impact) methodology. Use when: (1) User wants to create cover letters for AI/ML job applications, (2) User provides a resume and wants LinkedIn job matching, (3) User asks for personalized cover letters based on job postings, (4) User mentions applying for AI Engineer, ML Engineer, or similar technical roles. Integrates market intelligence, LinkedIn research via Playwright, and professional writing standards.
skill-validator
Validates skills against production-level criteria with 9-category scoring. This skill should be used when reviewing, auditing, or improving skills to ensure quality standards. Evaluates structure, content, user interaction, documentation, domain standards, technical robustness, maintainability, zero-shot implementation, and reusability. Returns actionable validation report with scores and improvement recommendations.
Didn't find tool you were looking for?