Requirements Clarity
Before you write any code for vague feature requests, this skill runs an interactive clarification process that scores requirements from 0 to 100 and won't let you proceed until you hit 90 or above. It asks focused questions across functional scope, technical constraints, and business context, then generates a structured PRD in your docs folder with acceptance criteria and execution phases. The rubric is sensible: 30 points for functional clarity, 25 for technical specifics, 25 for implementation completeness, 20 for business context. It's designed for those moments when someone says "add a dashboard" and you know that's nowhere near enough information to start building. Saves you from discovering critical assumptions three days into development.
- skills.sh installs
- 1K
- GitHub stars
- 2.7K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add softaworks/agent-toolkit --skill requirements-clarity --agent claude-codeInstalls into .claude/skills of the current project.
Files
Requirements Clarity Skill
Description
Automatically transforms vague requirements into actionable PRDs through systematic clarification with a 100-point scoring system.
Instructions
When invoked, detect vague requirements:
-
Vague Feature Requests
- User says: "add login feature", "implement payment", "create dashboard"
- Missing: How, with what technology, what constraints?
-
Missing Technical Context
- No technology stack mentioned
- No integration points identified
- No performance/security constraints
-
Incomplete Specifications
- No acceptance criteria
- No success metrics
- No edge cases considered
- No error handling mentioned
-
Ambiguous Scope
- Unclear boundaries ("user management" - what exactly?)
- No distinction between MVP and future enhancements
- Missing "what's NOT included"
Do NOT activate when:
- Specific file paths mentioned (e.g., "auth.go:45")
- Code snippets included
- Existing functions/classes referenced
- Bug fixes with clear reproduction steps
Core Principles
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/softaworks/agent-toolkit
- Categories
- Code Review & Quality, AI & Agent Building
- First seen
- Jun 3, 2026
More from softaworks/agent-toolkit
All 43- Jira854
- Draw Io838
- Mui824
- Design System Starter823
- Backend To Frontend Handoff Docs821
- Frontend To Backend Requirements820
- Excalidraw815
- Perplexity802
- Web To Markdown780
- Datadog Cli738
- Mermaid Diagrams5.2K
- Humanizer4.5K
- Database Schema Designer4.4K
- Qa Test Planner4.4K
- Writing Clearly And Concisely4.4K
- C4 Architecture4.3K
- Skill Judge4.3K
- Agent Md Refactor4.3K
- Crafting Effective Readmes4.2K
- Session Handoff4.2K
- Commit Work4.2K
- React Dev4.2K
- Marp Slide4.2K
- React Useeffect4.1K
Recommended
More Code Review & Quality
nnsight-remote-interpretabilityorchestra-research/ai-research-skillsProvides guidance for interpreting and manipulating neural network internals using nnsight with optional NDIF remote execution. Use when needing to run interpre1Kskills.sh installsnemo-evaluator-sdkorchestra-research/ai-research-skillsEvaluates LLMs across 100+ benchmarks from 18+ harnesses (MMLU, HumanEval, GSM8K, safety, VLM) with multi-backend execution. Use when needing scalable evaluatio1Kskills.sh installs
press-release-writinginference-sh/skillsPress release writing in AP style with inverted pyramid structure. Covers formatting, datelines, quotes, boilerplates, and fact-checking. Use for: product launc1Kskills.sh installstalking-head-productioninference-sh/skillsTalking head video production with AI avatars, lipsync, and voiceover. Recommended: P-Video-Avatar (fastest, cheapest, built-in TTS). Also covers OmniHuman, Pix1Kskills.sh installs
tailwind-capacitorcap-go/capgo-skillsGuide to using Tailwind CSS in Capacitor mobile apps. Covers mobile-first design, touch targets, safe areas, dark mode, and performance optimization. Use this s1Kskills.sh installs
applying-sldsforcedotcom/sf-skillsApply SLDS-compliant UI using the correct blueprints, styling hooks, utility classes, and icons. Use when building any UI that needs SLDS, choosing between Ligh1Kskills.sh installs