workflow-requirements-interview

Extract testable requirements from vague requests via structured questioning.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/akourmaz/translate2 --skill workflow-requirements-interview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-requirements-interview
Source: https://github.com/akourmaz/translate2/tree/main/.agents/skills/workflow-requirements-interview
Command: npx skills add https://github.com/akourmaz/translate2 --skill workflow-requirements-interview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams convert vague or conflicting requests into clear, testable requirements by guiding structured questioning and documenting outcomes.

Core Features & Use Cases

  • Phase-driven interview protocol: Core Understanding, Scope Definition, Functional Details, Non-Functional Requirements, Edge Case Discovery, and Documentation.
  • Formal documentation generation: Produces a Requirements.md capturing FRs, NFRs, acceptance criteria, out-of-scope items, and open questions.
  • Use cases: Ideal for ambiguous requests, complex features, or projects with unclear success criteria.

Quick Start

Run the interview protocol to clarify an ambiguous request and generate a complete Requirements.md.

Frequently Asked Questions about workflow-requirements-interview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract clear requirements from vague feature requests?

To extract clear requirements from vague feature requests, use a structured questioning protocol that guides the conversation through scope definition, functional details, and edge case discovery to produce testable specifications.

What is the best way to document acceptance criteria and edge cases for ambiguous projects?

Documenting acceptance criteria and edge cases for ambiguous projects is best handled by running a phase-driven interview protocol that clarifies undefined success criteria and outputs a formal Requirements.md file.

How do you interview stakeholders to identify non-functional requirements?

You interview stakeholders to identify non-functional requirements by applying a structured questioning workflow that progresses from core understanding to scope definition, explicitly capturing NFRs during the dedicated clarification phase.

Can I use a structured interview to resolve conflicting interpretations of a complex feature?

Yes, you can use a structured requirements interview to resolve conflicting interpretations of a complex feature by systematically questioning multi-interpretation scenarios and documenting the clarified outcomes as formal functional requirements.

What steps are involved in generating a Requirements.md from an undefined project scope?

Generating a Requirements.md from an undefined project scope involves running a phase-driven interview protocol covering core understanding, functional details, edge case discovery, and documentation to produce formal FRs, NFRs, and open questions.

When should I use a structured requirements clarification workflow?

You should use a structured requirements clarification workflow when facing ambiguous requests, multi-interpretation scenarios, or complex features with undefined success criteria that need conversion into testable documentation.