Can I skip the clarification process if I already have a spec?

Yes. The skill is designed not to activate when specific file paths, code snippets, or clear reproduction steps for bug fixes are provided.

How does this skill improve code quality?

By forcing a 'Why?' and 'Simpler?' check, it prevents over-engineering (YAGNI) and ensures that the implementation follows the KISS principle, leading to cleaner and more maintainable code.

What triggers the Requirements Clarity skill?

It activates when it detects vague feature requests, missing technology stacks, or incomplete specifications that lack success metrics or edge cases.

Where are the generated PRD files saved?

The skill automatically creates a markdown file in the './docs/prds/' directory of your repository, using a kebab-case filename based on the feature name.

How does the clarity scoring system work?

The skill evaluates requirements across four categories: Functional Clarity, Technical Specificity, Implementation Completeness, and Business Context, assigning points up to 100. Development only begins once a score of 90 is achieved.

Requirements Clarity & PRD Generator

Name: Requirements Clarity & PRD Generator
Author: softaworks

bysoftaworks

•

347

•

Productivity & Workflow

Transforms vague feature requests into actionable Product Requirements Documents (PRDs) through systematic, score-based clarification dialogue.

The Requirements Clarity skill for Claude Code acts as a bridge between high-level ideas and executable code by enforcing a rigorous definition phase. It uses a 100-point scoring system to evaluate functional clarity, technical specificity, and business value, ensuring that no complex feature is implemented without a clear roadmap. By guiding the user through targeted questioning rounds and applying principles like KISS and YAGNI, the skill eliminates ambiguity and automatically generates structured documentation including architecture decisions, risk assessments, and phased execution plans.

Key Features

01Automated detection of vague requests and missing technical context

02Interactive gap analysis across functional, technical, and business dimensions

03Phased execution planning with checklist-ready acceptance criteria

04Systematic 100-point quality rubric to measure requirement readiness

05347 GitHub stars

06Structured PRD generation with versioning and markdown output

Use Cases

01Converting a one-sentence user request into a comprehensive technical specification

02Defining boundaries and edge cases for complex features requiring cross-team coordination

03Standardizing project documentation for new feature development within a repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add softaworks/agent-toolkit requirements-clarity

For use in Claude.ai and ChatGPT

Download Skill