agentleFS
Soe-RehSoe-Reh/soes-skills/skills/interview/SKILL.md

interview

Skill1 starsChanged 4 days agoMITView on GitHub

Use when the user has a product idea, feature, or side project that is not built yet, or says "interview me", "grill me", "help me think this through", "I have an idea", "is this worth building", or "poke holes in this" before any spec or code exists.

101 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

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

  • 0

    Common

    Most of the 86 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
  1. Distinctive:

    Ask only questions whose answer changes what gets built.

    line 9
  2. Very specific:

    Read the repo, CLAUDE.md and .plans/.

    line 13
  3. Distinctive:

    Buyer vs users: if they differ, recruit one real buyer.

    line 29
  4. Very specific:

    Write <cwd>/.plans/<topic>-interview.md once, every heading kept ("None" if empty).

    line 51

“Common” is measured: kept by at least 6 in 10 of the 86 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

Ask only questions whose answer changes what gets built. No code. Output: one notes file a coding agent can build from.

1. Look before you ask

Read the repo, CLAUDE.md and .plans/; never ask what a file answers. Open any named link and give a 3-line verdict, or say what blocked you. Restate the idea in 2 lines.

2. Round 1: their situation

Open questions, no pre-filled answers:

  1. Today: what they do now and where it breaks.
  2. Success: one number, by when, judged by whom.
  3. Buyer: who pays, how much, first named users.
  4. Capacity: who builds, hours a week, what already overlaps.

Vague answer: push once with an example, then move on.

3. Test the premise first

  • Window: metric can't read out by the deadline? Add a proxy.
  • Evidence: "said they'd pay" < workaround < paid. Get the next rung.
  • Buyer vs users: if they differ, recruit one real buyer.
  • Readable: both arms log it; traffic can detect the lift.
  • Harm: health, legal, money inputs go to a human; shared links get per-person tokens.
  • Repeat chore: make it one tap.

Weak premise: say so, say what would change your mind, offer a reframe. Never weaken the user's goal: a proxy stays secondary, a dropped goal goes in Decisions.

4. Rounds 2-3: decisions

2-4 questions a round, 2-4 concrete options each, your recommendation first with a one-line reason. Hunt late surprises: weeks-long approvals, look-alike states, data changing while saved. Size scope to the builder's hours. End each round with only what changed plus vetoable defaults. Stop when nothing open would change v1.

5. When the user hands it back

User saysYou do
"you decide" on onePick; log made by interviewer
"you decide" on allOne round of one-way doors only (money, data, auth); decide the rest
"skip it" / "write it"At most 1-2 one-way doors, then write
A full planRun step 3, ask only the gaps

6. Save the notes

Write <cwd>/.plans/<topic>-interview.md once, every heading kept ("None" if empty).

# <Topic>: interview notes
Date: <YYYY-MM-DD> | Status: ready to build

## One-liner
## Problem and today's workaround
## Users and buyer
## Success
- Primary (user's own bar): <metric, threshold, by when, judged by whom>
- Secondary or proxy: <optional>
- Test: <arms, population, smallest detectable lift, pass/fail>
## Constraints
## Premise checks
- <check>: <result, or test with pass/fail and date>
## V1 scope
## Out of scope
## Build
- Data: <entities, key fields>
- Routes: <route: purpose, who sees it>
- Logic: <signatures, one worked example>
- States: | State | Trigger | User sees |
- Guards: <inputs routed to a human, outputs rejected>
- Events: <logged for the metric>
- Acceptance tests: <given/when/then per screen and guard>
- Plan: <weeks back from deadline, ordered cut list>
## Gotchas
## Decisions
| Decision | Chosen | Why | Made by (user / interviewer) |
## Open questions
- <question>: <blocks what>, <who answers>

7. Hand off

Reply with path, one-liner, biggest risk, first step. Offer once: "Run the spec skill on these notes next?"

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.