skills.rest
nholder88
nholder88COMMUNITY
Explore all skills by this author →
WebsiteGitHub

requirements-clarification

Convert vague requirements into Given/When/Then acceptance criteria and specifications.

2|Updated Mar 1, 2026
Search Tags:#specification#requirements#acceptance-criteria#given-when-then#clarify#pbi
One-click install
npx skills add https://github.com/nholder88/ai-agent-workflows --skill requirements-clarification-nholder88
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: requirements-clarification
Source: https://github.com/nholder88/ai-agent-workflows/tree/main/skills/requirements-clarification
Command: npx skills add https://github.com/nholder88/ai-agent-workflows --skill requirements-clarification-nholder88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn vague feature requests, user stories, backlog items, or PBIs into precise specifications with functional AC (Given/When/Then), technical AC, test criteria, implementation steps, and explicit boundaries.

Core Features & Use Cases

  • Structured spec generation: produces a complete specification with acceptance criteria, tests, and scope boundaries from vague inputs.
  • Cross-team clarity: helps product, design, and engineering align on what to build and what is out of scope.
  • Reusable templates: applies standard formats for PBI clarification, user-story refinement, and spec writing from vague requirements.

Quick Start

Paste a vague backlog item and I will generate a precise spec with Given/When/Then criteria, technical criteria, test criteria, and explicit boundaries.

Frequently Asked Questions about requirements-clarification

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

FAQPage Schema
How do I turn vague user stories into precise, testable acceptance criteria?▼

You can clarify vague user stories by generating precise specifications using Given/When/Then acceptance criteria, technical criteria, test criteria, and explicit out-of-scope boundaries.

What is the best way to write specifications with Given/When/Then for backlog items?▼

Writing specifications with Given/When/Then for backlog items involves transforming vague feature requests into structured formats that include functional acceptance criteria, technical constraints, and test scenarios.

How do I define out-of-scope boundaries for cross-team feature requests?▼

Defining out-of-scope boundaries for cross-team feature requests requires carving explicit limitations within the specification, ensuring product, design, and engineering teams align on what is excluded from the build.

Can I generate technical and test criteria from a vague PBI description?▼

Yes, you can generate technical and test criteria from a vague Product Backlog Item (PBI) by processing the rough input to produce a formal specification complete with implementation steps and testable conditions.

When do I need to formalize requirements into structured specifications?▼

You need to formalize requirements into structured specifications when a backlog item or feature request lacks clarity, requiring functional and technical acceptance criteria to prevent cross-team misalignment during development.

How to structure implementation steps and test scenarios from rough requirements?▼

Structuring implementation steps and test scenarios from rough requirements involves applying standard templates to extract functional Given/When/Then criteria, technical parameters, and explicit boundaries for development execution.

Related Skills

Explore More Product & Management Skills→
kelleysd-appskelleysd-apps
1

sdd-specification

Create detailed feature specifications with user stories and acceptance criteria.

Community
Basic
SentioLabsSentioLabs
1

spec-to-backlog

Converts Confluence specifications into linked Epic and Jira tickets for backlog creation.

Official
Advanced
addxaiaddxai
42

uat-story-writer

Generate user story documents with Gherkin acceptance criteria for UAT scenarios.

Official
Intermediate
daishimandaishiman
6

backlog-management

Automate backlog creation, refinement, estimation, and prioritization with DEEP principles.

Community
Intermediate