Agent skill

Requirements Clarity

by pedronauck in pedronauck/skills

Clarify ambiguous requirements through focused dialogue before implementation.

No licenceAuto-check passedProduct & Project Management

Install Requirements Clarity

skills CLI
$ npx skills add pedronauck/skills --skill requirements-clarity -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pedronauck/skills requirements-clarity --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/curated/requirements-clarity .claude/skills/requirements-clarity && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
requirements-clarity
GitHub stars
634
Used in
2 other repos
Token cost
~2.3k tokens
SKILL.md length
530 words
Files
2
Skills in repo
65
Repo updated
First seen
Licence
None found

At a glance

Clarify ambiguous requirements through focused dialogue before implementation.

  • Works in 4 steps: Initial Requirement Analysis → Gap Analysis → Interactive Clarification → …
  • Requirements are unclear
  • SKILL.md covers Description, Instructions, Core Principles and Clarification Process, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Requirements Clarity is an agent skill from pedronauck/skills. Clarify ambiguous requirements through focused dialogue before implementation. Use when requirements are unclear, features are complex (2 days), or involve cross-team coordination. Ask two core questions - Why? (YAGNI check) and Simpler? (KISS check) - to ensure clarity before coding.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Product & Project Management, covering Requirements gathering and PRD writing. The repository describes itself as: My personal favorite skills.

When your agent uses it

  • Requirements are unclear
  • Features are complex (2 days)
  • Involve cross-team coordination

Example prompts

  • “/requirements-clarity”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Initial Requirement Analysis
  2. Gap Analysis
  3. Interactive Clarification
  4. PRD Generation

What it can do on your machine

Read from SKILL.md and the folder at commit 0422940. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Requirements Clarity loads about 2.3k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 530 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 530 words (~2,325 tokens).

“Automatically transforms vague requirements into actionable PRDs through systematic clarification with a 100-point scoring system.”

— opening of SKILL.md by pedronauck
name
requirements-clarity

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/curated/requirements-clarity of pedronauck/skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 0422940

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in pedronauck/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Requirements Clarity next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Requirements Clarity compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Requirements Clarity this skillpedronauck/skills6342 repos~2.3kAutomated safety check: PassNone
Ouroboros PM InterviewQ00/ouroboros6.2k—~5.7kAutomated safety check: PassMIT
User Alignment and Agent-Ready PRDstryproduck/produck-skills511—~5.3kAutomated safety check: PassApache-2.0
Creating Issuesopsmill/infrahub534—~1.2kAutomated safety check: PassApache-2.0
Grilling Ideasopsmill/infrahub534—~3.8kAutomated safety check: PassApache-2.0
Feature ForgeJeffallan/claude-skills12k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Runs a guided product-manager interview that classifies each question automatically and produces a Product Requirements Document.

    6.2k GitHub stars~5.7k tokensUpdated 4 days ago
    Product & Project ManagementAuto-check passed
  • User Alignment and Agent-Ready PRDs

    tryproduck/produck-skills

    Turns a vague feature request into a written spec with scope, phases, acceptance criteria and do-not-do limits that a coding agent can follow without guessing.

    511 GitHub stars~5.3k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Creating Issues

    opsmill/infrahub

    Turns a single feature idea, improvement, or bug into ONE well-structured GitHub issue.

    534 GitHub stars~1.2k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Grilling Ideas

    opsmill/infrahub

    Stress-tests a fuzzy or vague feature idea before any PRD, spec, or ticket is written.

    534 GitHub stars~3.8k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Feature Forge

    Jeffallan/claude-skills

    Runs a structured requirements interview to produce a feature specification with EARS requirements, acceptance criteria and an implementation checklist.

    12k GitHub stars~1.1k tokensUpdated 7 days ago
    Product & Project ManagementAuto-check passed
  • Tech Design

    open-octo/octo-agent

    Produce a complete backend technical design document from a PRD or feature description — understand, explore the codebase, grill on decisions, write, and self-review.

    125 GitHub stars~3.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 26 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 26 days ago
    Auto-check passed

Questions about Requirements Clarity

What does Requirements Clarity do?

Clarify ambiguous requirements through focused dialogue before implementation. Requirements Clarity is an agent skill from pedronauck/skills. Clarify ambiguous requirements through focused dialogue before implementation.

When should I use Requirements Clarity?

Requirements Clarity fits situations like: requirements are unclear; features are complex (2 days); involve cross-team coordination.

How do I install Requirements Clarity in Claude Code?

Run `npx skills add pedronauck/skills --skill requirements-clarity -a claude-code`. Or copy the skill folder (skills/curated/requirements-clarity in pedronauck/skills) into .claude/skills/requirements-clarity in your project. Claude Code loads it when a task matches its description.

How do I install Requirements Clarity in Codex?

Run `npx skills add pedronauck/skills --skill requirements-clarity -a codex`. Or copy the skill folder (skills/curated/requirements-clarity in pedronauck/skills) into .agents/skills/requirements-clarity in your project. Codex loads it when a task matches its description.

Can I use Requirements Clarity in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pedronauck/skills --skill requirements-clarity -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/requirements-clarity, .gemini/skills/requirements-clarity, .github/skills/requirements-clarity and .opencode/skills/requirements-clarity in your project.

What does Requirements Clarity need to run?

SKILL.md names no scripts, command-line tools or credentials: Requirements Clarity is instructions for the agent only.

Does Requirements Clarity access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Requirements Clarity safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Requirements Clarity use?

No licence was found for Requirements Clarity or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Requirements Clarity use?

About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Requirements Clarity?

Skills that share tags, products or a category with Requirements Clarity: Ouroboros PM Interview (Q00/ouroboros, 6.2k stars), User Alignment and Agent-Ready PRDs (tryproduck/produck-skills, 511 stars), Creating Issues (opsmill/infrahub, 534 stars) and Grilling Ideas (opsmill/infrahub, 534 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Requirements Clarity?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

Source: pedronauck/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.