jwynia avatar

Requirements Analysis

Catches you when you start with "I want to build X" instead of understanding the actual problem. Works through five diagnostic states from no problem statement to validated requirements, asking pointed questions at each level: who suffers without this, what are real constraints versus assumptions, what's the walking skeleton version. The interventions are practical, like the jobs-to-be-done self-interview and constraint inventory templates. Honest about the solo developer trap of inventing imaginary users instead of facing your own needs. If you tend to jump straight to implementation or accumulate infinite backlogs, this forces the clarifying work before you write code. Hands off to system design once requirements are actually testable.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
6
skills.sh installs
2.3K
GitHub stars
182
last updated
Aug 21, 2026

Install

$ npx -y skills add jwynia/agent-skills --skill requirements-analysis --agent claude-code

Installs into .claude/skills of the current project.

Files

Requirements Analysis: From Vague Intent to Validated Needs

You diagnose requirements-level problems in software projects. Your role is to help solo developers distinguish stated wants from underlying problems, discover real constraints, and avoid premature solution thinking.

Core Principle

Requirements are hypotheses about what will solve a problem. The goal is not to document requirements but to discover whether they address the actual problem.

The States

State RA0: No Problem Statement

Symptoms:

  • Starting with "I want to build X" (solution, not problem)
  • Can't articulate who has what problem
  • "Everyone needs this" reasoning
  • Feature list without problem grounding
  • Copying existing solutions without understanding why they exist

Key Questions:

  • What happens if this doesn't exist? Who suffers?
  • What are people (or you) doing today instead?
  • What triggered you thinking about this now?
  • If you're the user, what specific frustration led here?

Sponsors

Details

Repository
github.com/jwynia/agent-skills
Categories
Documentation, AI & Agent Building, Debugging, Sales & Marketing

More from jwynia/agent-skills

All 118
1refoundai avatarretention-engagementrefoundai/lenny-skillsHelp users identify the drivers of long-term retention and implement behavioral mechanics that keep customers coming back. This guide focuses on measuring the s2.3Kskills.sh installs
2apollographql avatarapollo-connectorsapollographql/skillsGuide for integrating REST APIs into GraphQL supergraphs using Apollo Connectors with @source and @connect directives. Use this skill when the user: (1) mention2.3Kskills.sh installs
3sergiodxa avatarfrontend-testing-best-practicessergiodxa/agent-skillsTesting best practices for the frontend. Emphasizes E2E tests over unit tests, minimal mocking, and testing behavior over implementation details. Use when writi2.2Kskills.sh installs
4tencentcloudbase avatarauth-wechat-miniprogramtencentcloudbase/skillsCloudBase WeChat Mini Program native authentication guide. This skill should be used when users need mini program identity handling, OPENID/UNIONID access, or `2.2Kskills.sh installs
5anthropics avatarzoom-mcpanthropics/knowledge-work-pluginsGuidance for the bundled Zoom MCP connectors. Use after routing to an MCP workflow when planning or troubleshooting tool-based access to meetings, recordings, m2.2Kskills.sh installs
6wsimmonds avatarnextjs-app-router-fundamentalswsimmonds/claude-nextjs-skillsGuide for working with Next.js App Router (Next.js 13+). Use when migrating from Pages Router to App Router, creating layouts, implementing routing, handling me2.2Kskills.sh installs