requirements

Formalizes raw tasks into operator-approved requirements documents with testable acceptance criteria.

9|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/eventbalancer/agent-quorum --skill requirements-eventbalancer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirements
Source: https://github.com/eventbalancer/agent-quorum/tree/main/.agents/skills/requirements
Command: npx skills add https://github.com/eventbalancer/agent-quorum --skill requirements-eventbalancer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Raw ideas and informal requests lack the structure needed for reliable planning and implementation. This Skill turns an unformalized task, problem, or investigation context into a formal, operator-approved requirements document that fixes what must be true when the work is done, without prescribing how to build it. ## Core Features & Use Cases - Structured intake and reconnaissance: Classifies the request type, harvests existing investigation context, and grounds every claim in code, docs, or config with file:line evidence. - Operator-driven fork resolution: Resolves scope, behavior, priority, and compatibility decisions through structured question rounds, recording each outcome in a decision log. - Validated document contract: Produces a self-contained Markdown document with functional requirements, non-functional requirements, acceptance criteria, risks, and defaults, saved under .agents/requirements/. - Use Case: After debugging a CLI defect, invoke the Skill with no arguments to harvest the investigation context, clarify scope with the operator, and produce an approved requirements document ready for solution handoff. ## Quick Start Ask the agent to formalize your raw task or harvested investigation context into an approved requirements document using the requirements skill.

Frequently Asked Questions about requirements

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

FAQPage Schema
How do I turn a rough idea into a formal requirements document?

Invoke the requirements skill with your raw task text, or with no arguments to harvest existing investigation context. The skill runs bounded reconnaissance, drafts a structured document, resolves open decisions with you, and saves the approved result under .agents/requirements/.

How to write testable functional requirements for a software task?

Write each requirement as an outcome-level statement an observer can judge pass or fail without knowing the implementation. The skill enforces this by rejecting solution language, requiring Must/Should/Could priorities, and mapping every Must requirement to an acceptance criterion.

Can the requirements skill work from a GitHub issue?

Yes. When the task originates from a GitHub issue URL or number, the skill records the org/repo#n reference in the Issue field and moves the item to In Progress on the linked ProjectV2 board using the gh CLI before drafting.

What happens if the operator is unavailable during requirements drafting?

The skill saves the document with Status: draft and records unresolved forks in the Open items section with an owner and reason. Approval and handoff to solution-handoff only occur after explicit operator sign-off.

When should a task be split into multiple requirements documents?

Split when the scope spans unrelated surfaces, such as independent CLI, API, and config changes with no shared acceptance criteria. The skill proposes the split so each document remains self-contained and independently approvable.