interview-framework
This skill should be used when a Ralph phase must identify critical user decisions, run a layered grill, persist partial answers, obtain explicit approval, or resume an interrupted phase interview before delegating artifact work.
Install / Use
npx skills add tzachbon/smart-ralph --skill interview-frameworkInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Education & ResearchSupported Platforms
Our assessment of interview-framework
interview-framework scores 87/100 on our quality scale, 247th of 421 Education & Research skills we index.
Its SKILL.md is 8.7 KB long, well organised into 14 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has 550 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so interview-framework is actively maintained.
- Our last check on 2026-10-11 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
interview-framework compared with similar skills
All 4 of these similar skills score higher than interview-framework; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| interview-framework (this skill)by tzachbon | 87 | 550 | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 117.6k | 9d ago | CLAUDE.md |
| last30days-skillby mvanhorn | 100 | 68.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.9k | 8d ago | CLAUDE.md |
| x402by browser-use | 100 | 121.0k | 4d ago | SKILL.md |
Frequently asked questions
- How do I install interview-framework?
- Run
npx skills add tzachbon/smart-ralph --skill interview-framework. The install tabs above show the steps for each supported agent. - Which AI agents does interview-framework work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is interview-framework safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is interview-framework still maintained?
- The repository was last updated about 2 months ago, so interview-framework is actively maintained.
Skill content
View source on GitHubname: interview-framework description: This skill should be used when a Ralph phase must identify critical user decisions, run a layered grill, persist partial answers, obtain explicit approval, or resume an interrupted phase interview before delegating artifact work. version: 0.3.0 user-invocable: false
Interview Framework
Treat every normal-mode interview governed by this framework as a grill. Run the approval-gated interview for start, triage, research, requirements, design, and tasks. Treat this skill and its references as the single source of truth for interview behavior. Phase commands supply exploration territory and artifact context; they do not redefine the algorithm.
Quick mode bypasses interview questions only. It still requires current discovery, contract loading, bypass receipts, delegation checks, and artifact-agent load parity.
Entry Contract
Before each new or resumed interview:
- Complete the applicable skill discovery pass from
${CLAUDE_PLUGIN_ROOT}/references/normal-mode-gates.md. - Reload this entire
SKILL.md,references/algorithm.md,references/domain-modeling.md, every selected skill body, and every selected skill resource required for the current work. Loadreferences/examples.mdonly when an example is needed. - Record the load manifest with
phase_gate.py record-skill-load. - Begin or resume the interview with the matching phase, interview ID, discovery revision, and context digest.
Block when this skill or the core algorithm reference cannot be loaded. Warn and continue when a domain skill fails to load. Put unresolved material conflicts in the first critical frontier.
Critical Decision Test
Grill only a decision that meets both conditions:
- The answer cannot be established by inspecting the project, prior artifacts, configuration, or selected skill contracts.
- Different answers would materially change scope, observable behavior, architecture, risk acceptance, delivery sequencing, or the acceptance standard.
Inspect facts with read-only tools or an Explore agent. Exclude setup choices, administrative preferences, status questions, facts the repository can answer, and low-impact polish. Treat a prescribed task action in a loaded domain skill as reference material during preload; do not execute it until the phase has approval and delegation begins.
Before building the tree, read the goal, state, .progress.md, prior phase artifacts, the configured .index/index.md, and the applicable CONTEXT.md reached through CONTEXT-MAP.md when present. Open only relevant indexed entries. Inspect code, configuration, tests, and existing specs for every discoverable fact. Run independent read-only lookups in parallel; a pending fact blocks only the nodes that depend on it.
- Fact: discoverable from project evidence. Resolve it through inspection; never ask the user.
- Decision: a consequential preference, priority, boundary, or tradeoff only the user can settle. Put it on the design tree.
Build the Design Tree and Traverse the Layered Frontier
Build a design tree from the phase territory. Each node contains a stable decision ID, dependencies, known evidence, viable options, recommendation, tradeoffs, and material consequences. Track nodes as open, investigating, resolved, or explicitly out of scope. The frontier contains every open critical decision whose prerequisites are resolved.
Ask the whole currently unblocked critical frontier. Use as many AskUserQuestion calls as needed, with at most four questions per call. Batch independent decisions together.
Before every AskUserQuestion call, call open-frontier for every decision ID in that batch.
After each response:
- Call deterministic
classify-replyon the whole reply before applying any part of it. - Persist every answered decision immediately with
record-answer. - Preserve unanswered pending decisions when the response is partial.
- Recompute the frontier from new answers and inspected facts.
- Ask the next unblocked frontier until no critical node remains open.
Ask the whole current frontier in one round. Number each question (Q1, Q2, and so on). Use AskUserQuestion for the round when the tool is available. If AskUserQuestion is unavailable, render the same numbered round in the response and wait for the answers.
Turn an Other response into a specific dependent question in the next frontier. Never use a generic follow-up. Add branches exposed by concrete answers or contradictions, and remove branches that evidence resolves.
Each question must:
- Give 2-4 viable options.
- Put the recommended option first and label it
(Recommended)unless the options are symmetric. - State the recommendation rationale and the material tradeoff in the question or option description.
- Avoid straw-man alternatives and unnecessary flexibility.
Give a recommended answer with a short rationale. Provide 2-4 meaningful options. Require that the design-tree frontier is empty before final confirmation. Continue only when the user confirms the resulting shared understanding through the explicit approval choice.
See references/algorithm.md for the complete state machine.
Domain Language
Apply references/domain-modeling.md during every grill. Challenge terms that conflict with the applicable CONTEXT.md, replace fuzzy or overloaded words with a proposed canonical term, and use boundary or edge-case scenarios to test the model. Record resolved domain terms promptly. Keep implementation details out of CONTEXT.md. This interview framework does not create ADRs; design.md remains the specification's technical-decision record.
Reply Semantics
Classify the entire reply before applying it.
Substantive reply
Apply text that answers one or more active decisions. Persist answered decisions and keep the rest open. A substantive answer can include control words without losing its decision content.
Control-only reply
These replies do not answer any active decision by themselves:
apply the changescontinueproceedgo ahead
Keep the active frontier open and ask it again. Do not infer defaults or approval from a control-only reply.
Bare skip
Treat bare skip, after an active question, as authorization to default the remaining phase interview. Call skip with explicit defaults and assumptions; this moves to awaiting_confirmation, not a delegable terminal state. Continue to final approval and confirm decision ID skip-confirmation. A sentence that contains skip plus substantive decision text is a substantive reply, not bare skip.
Final Approval
When the critical frontier is exhausted or skipped:
- Present the decision brief: resolved decisions, recommended approach, tradeoffs, defaults, assumptions, and material conflicts.
- Call
await-confirmationwith a stable confirmation decision ID and the proposed approach. - Ask one explicit approval question through
AskUserQuestion:Approve and delegate (Recommended)Revise decisionsCancel
- Accept only an explicit approval selection. Control-only replies do not approve.
- On approval, call
confirm --source approve-and-delegate, runcheck-delegation, and delegate immediately in the same response. Do not ask another question or stop between approval and delegation.
When the user requests revisions, call one revise transition with every affected --decision-id before updating answers. Recompute any dependent frontier, return to final approval using the same confirmation ID, and keep the same interview record until the brief is approved again.
Artifact Approval
Artifact review is a separate approval gate after delegation. apply the changes during artifact review means revise the artifact using the supplied feedback, redisplay the walkthrough, and remain in artifact approval. It never approves the artifact or advances the phase.
Persistence
Use phase_gate.py transitions after each state change. Append every completed frontier round to .progress.md without treating that Markdown as enforcement state:
### <Phase> Grill - Round <N>
- Facts resolved: <fact and evidence>
- Decisions: <decision-id> -> <answer>
- Out of scope: <explicitly excluded branch or none>
- Domain language: <canonical term and definition or none>
- Frontier after round: <remaining unblocked decisions or empty>
For triage, store enforcement state in the epic .epic-state.json. For spec phases, use .ralph-state.json.
References
references/algorithm.md- Critical-frontier state machine and reply handling.references/domain-modeling.md- Required context discovery, language challenges, scenarios, and glossary updates.references/examples.md- Optional examples for frontier, partial-answer, skip, approval, and artifact revision cases.
Related Skills
taste-skill
117.6kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
last30days-skill
68.8kAI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
Claude-Code-Game-Studios
39.9kTurn Claude Code into a full game dev studio — 49 AI agents, 75 workflow skills, and a complete coordination system mirroring real studio hierarchy.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
