Diagnose requirements problems and guide discovery of real needs and constraints
The requirements-analysis skill helps identify and diagnose requirements-level problems in software projects before implementation begins. It focuses on uncovering the real problems that need solving rather than jumping directly to solutions or feature lists. By treating requirements as hypotheses rather than fixed truths, the skill guides users toward understanding who is affected by a problem, why the problem exists, and whether proposed requirements actually address underlying needs. This approach helps reduce the risk of building solutions that fail to solve meaningful problems.
The skill provides structured diagnostic guidance through several requirement analysis states. It helps users move from having no clear problem statement, to avoiding solution-first thinking, to refining vague needs into testable requirements, and to identifying hidden constraints and assumptions. It uses targeted questions and interventions such as Jobs-to-be-Done self-interviews, problem archaeology, function extraction, acceptance scenario writing, testability checks, constraint inventories, and assumption mapping. These techniques are designed to improve clarity, reveal overlooked dependencies, and distinguish real constraints from preferences.
This skill is useful for solo developers, software project founders, and anyone defining requirements for a new product, feature, or initiative. Common use cases include validating product ideas, clarifying user problems, evaluating proposed features, identifying project risks, and discovering hidden assumptions before development starts. It is particularly valuable in early-stage planning and discovery activities where requirements are uncertain or poorly defined.
Provide your project idea, feature concept, requirements, or problem statement. The skill analyzes the information, identifies the current requirements state, and guides discovery through targeted questions and exercises.
Yes. One of its primary functions is helping users move from solution-focused thinking to understanding the underlying problem, user needs, and motivations.
No. The skill focuses on requirements discovery and analysis rather than implementation technologies.
Yes. The skill includes techniques such as acceptance scenario writing, specificity exercises, and testability checks to transform vague needs into clearer, verifiable requirements.
The skill relies on the information provided by the user and focuses on diagnosing requirements issues. It does not define implementation details or guarantee that assumptions are correct without validation.
Quick Setup:
.claude/skills/Repository
jwynia/agent-skills