requirement-qa

Convert vague project ideas into structured markdown requirement documents.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/YuluoY/nimis --skill requirement-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirement-qa
Source: https://github.com/YuluoY/nimis/tree/main/skills-en/requirement-qa
Command: npx skills add https://github.com/YuluoY/nimis --skill requirement-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Many users have vague or incomplete project ideas but cannot articulate full requirements; this Skill converts those fuzzy inputs into structured, reviewable requirement documents so work can proceed without repeated clarification overhead.

Core Features & Use Cases

  • Incremental output + review loop: Produces document fragments, asks targeted questions, and updates files in place until confirmed.
  • Modular artifacts: Writes and maintains docs/01-requirement/ files (project-profile, feature-scope, business-rules, non-functional, tech-constraints) to feed downstream spec and implementation skills.
  • Structured clarification: Offers 2–5 options per question with a single recommended choice, annotates inferred assumptions, and logs QA sessions for auditability.

Quick Start

Provide a short project prompt like "I want to build an online course platform" and ask the agent to draft the project-profile.md in docs/01-requirement/.

Frequently Asked Questions about requirement-qa

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

FAQPage Schema
How do I turn vague project ideas into structured requirement documents?

To turn vague project ideas into structured requirement documents, you provide a short prompt and the agent drafts modular markdown files like project-profile.md under docs/01-requirement/. It incrementally updates these files through a review loop until all details are confirmed.

How does structured requirement clarification work for ambiguous feature scoping?

Structured requirement clarification works by generating 2-5 multiple-choice options for each ambiguity in your feature scoping, recommending one choice, and annotating inferred assumptions. This interactive QA process continues until you approve the generated requirement artifacts.

What is the best way to document inferred assumptions during user interviews?

The best way to document inferred assumptions during user interviews is to annotate them directly within the generated markdown files. The agent logs all QA sessions to docs/qa/ for auditability, ensuring every inferred assumption is reviewable and traceable.

Can I use this requirement QA process for bug fixes and refactors?

Yes, you can use this requirement QA process for bug fixes and refactors. It applies during discovery and requirement clarification for new projects, features, or technical debt, producing modular artifacts like business-rules.md and tech-constraints.md.

What files do I need to generate for downstream spec writing?

For downstream spec writing, you need to generate modular markdown files under docs/01-requirement/, including project-profile, feature-scope, business-rules, non-functional, and tech-constraints documents to feed directly into implementation skills.

How to handle incomplete project requirements without repeated clarification overhead?

To handle incomplete project requirements without repeated clarification overhead, the agent asks targeted questions with predefined options and persists session logs. This structured approach eliminates continuous back-and-forth by finalizing reviewable documents in incremental steps.