requirements-grill

Run a six-layer requirements workflow from Vision to Engineering Specs with user approval.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/COCOSiL-inc/COCOSiL_Analysis_V2 --skill requirements-grill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirements-grill
Source: https://github.com/COCOSiL-inc/COCOSiL_Analysis_V2/tree/main/.claude/skills/requirements-grill
Command: npx skills add https://github.com/COCOSiL-inc/COCOSiL_Analysis_V2 --skill requirements-grill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

requirements-grill helps you reduce ambiguity in product thinking by extracting clear, testable requirements through a disciplined one-question-at-a-time process that outputs structured docs.

Core Features & Use Cases

  • 6-layer requirements workflow: Step through Vision → Outcome → Capability → Feature → Eval → EngSpec and write results into docs/requirements/<product>/.
  • Grill-me questioning with defaults: Prompts are staged so the skill asks for user-confirmed answers while providing recommended candidates to keep progress moving.
  • Session persistence and resume: Store conversation state in session files so you can pause and continue later, even across new chats.
  • Safety and quality gates: Apply a WriteoutGate (Preview → Label Audit → Approval) so the user explicitly approves what gets written.
  • Optional web escalation: When versions, model choices, eval methods, or benchmarks need freshness, the skill can request Web verification and label web-derived values.

Quick Start

Start a new grill by asking: requirements-grill, product requirements for <product>, start from Vision, then write out when I approve.

Frequently Asked Questions about requirements-grill

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

FAQPage Schema
How do I turn ambiguous product ideas into structured documentation?

Structured product documentation is generated by running a six-layer grill workflow across Vision, Outcomes, Capabilities, Features, Evals, and Engineering Specs. It asks one question at a time with recommended answers to reduce ambiguity and extract testable requirements.

Can I pause a product requirements session and resume it later in a new chat?

You can pause and resume product requirements sessions later, even across new chats, because the workflow stores conversation state in session files. This session persistence ensures your progress through the six-layer grill is never lost.

How do I ensure my requirements documentation is safely written without errors?

A three-stage WriteoutGate ensures requirements documentation is safely written by applying Preview, Label Audit, and Approval stages. The system only writes outputs to the docs directory after you explicitly review and approve the content.

Does the requirements extraction process support web search for time-sensitive fields?

The requirements extraction process supports optional web search escalation for time-sensitive fields like versions, model choices, eval methods, or benchmarks. It requests web verification when freshness is needed and labels web-derived values.

What is the best way to define product vision and outcomes step by step?

The best way to define product vision and outcomes step by step is through a grill workflow that prompts you one question at a time with recommended candidate answers. This staged approach keeps progress moving through the six documentation layers.