One-click install
npx skills add https://github.com/MiDeNiMeeD/Bulls-Cows --skill shaping-requirements-midenimeed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shaping-requirements
Source: https://github.com/MiDeNiMeeD/Bulls-Cows/tree/main/.claude/skills/shaping-requirements
Command: npx skills add https://github.com/MiDeNiMeeD/Bulls-Cows --skill shaping-requirements-midenimeed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defining new or modified full-stack features often leads to incomplete, ambiguous requirements that cause development rework, cross-team misalignment, and missed edge cases. This skill eliminates those unknowns by guiding you through a structured, layer-by-layer questioning process to capture every functional detail needed for successful implementation.

Core Features & Use Cases

  • Codebase-First Research: Automatically explores existing frontend, backend, data, and integration layers before asking questions to avoid redundant clarifications.
  • Structured Guided Questioning: Asks one targeted question at a time with actionable options and recommendations, covering UI behavior, API contracts, data models, business rules, permissions, and edge cases.
  • Standardized Documentation: Structures finalized requirements into coherent, testable markdown files saved to the docs/requirements folder, tailored to simple, medium, or complex feature scopes.
  • Use Case: For example, if you want to add a real-time match history feature to the Bulls and Cows PvP game, this skill will guide you through clarifying UI elements, required API endpoints, database schema changes, and scoring business rules before any development work begins.

Quick Start

Use the shaping-requirements skill to define the functional requirements for adding a public match lobby feature to the Bulls and Cows game.

Frequently Asked Questions about shaping-requirements

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

FAQPage Schema
How do I write full-stack feature requirements that cover UI, API, and data layers?

To write full-stack feature requirements, use a guided questioning process to capture functional details across UI behavior, API contracts, data models, business rules, and permissions, producing structured, testable markdown documents free of implementation ambiguity.

What is the best way to gather acceptance criteria for a new software feature?

Gathering acceptance criteria is best achieved through structured, layer-by-layer guided questioning that targets edge cases and business logic, ensuring coherent end-to-end functional specifications before development work begins.

How do I prevent cross-team misalignment when defining feature modifications?

Prevent cross-team misalignment by generating standardized, testable requirement documents through codebase-first research and targeted questions, eliminating incomplete specifications that cause development rework.

Does guided questioning work for defining requirements to remove existing features?

Yes, guided questioning works for feature removal, modification, and new feature definition scenarios, systematically clarifying necessary changes across UI, API, data, business logic, and permission layers for full-stack applications.

Can I generate testable feature specifications without making implementation assumptions?

You can generate testable feature specifications without implementation assumptions by finalizing structured requirement markdown files tailored to simple, medium, or complex scopes, saved directly to the docs/requirements folder.

Why do my full-stack development plans keep missing edge cases and database schema changes?

Full-stack development plans miss edge cases and database schema changes due to incomplete requirements; applying automated codebase research and one-at-a-time targeted questions captures every functional detail needed for successful implementation.