clarification-analyst
A rigorous analysis skill that interrogates requirements and specs to uncover ambiguities and missing edge cases.
Install
mkdir -p .claude/skills/clarification-analyst && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10186" && unzip -o skill.zip -d .claude/skills/clarification-analyst && rm skill.zipInstalls to .claude/skills/clarification-analyst
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Helps interrogate Product Requirements (PRD), Technical Specifications, and Implementation Plans to find ambiguities, missing edge cases, and hidden assumptions.Key capabilities
- →Interrogate PRDs and technical specs
- →Identify ambiguous terminology
- →Surface edge cases and negative conditions
- →Validate hidden dependencies
- →Generate clarification reports
How it works
It systematically interrogates documents to find gaps, then uses an iterative 'grill' approach to resolve ambiguities with concrete options.
Inputs & outputs
When to use clarification-analyst
- →Review PRDs for missing requirements
- →Identify edge cases in technical specs
- →Uncover hidden project assumptions
About clarification-analyst
Systematically evaluates Product Requirements (PRD), technical specifications, and implementation plans. It acts as an analyst to highlight gaps, inconsistencies, and unspoken assumptions before the implementation phase begins.
Helps interrogate Product Requirements (PRD), Technical Specifications, and Implementation Plans to find ambiguities, missing edge cases, and hidden assumptions.
When not to use it
- →When the user wants code written immediately
- →When the user wants architecture designed without clarification
Limitations
- →Cannot design architecture or write code until documents are updated
- →Requires sequential, one-at-a-time questioning
How it compares
It forces the user to define metrics and edge cases before implementation, rather than assuming clarity.
Compared to similar skills
clarification-analyst side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| clarification-analyst (this skill) | 0 | 1mo | No flags | Intermediate |
| premortem | 9 | 7mo | No flags | Intermediate |
| edge-cases | 0 | 6mo | No flags | Intermediate |
| grill-me | 0 | 1mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by GulajavaMinistudio
View all by GulajavaMinistudio →You might also like
premortem
parcadei
Identify failure modes before they occur using structured risk analysis
edge-cases
rohunj
Analyze a PRD for edge cases, failure modes, and scenarios that might be missed. Use after creating a PRD to strengthen it. Triggers on: analyze edge cases, find edge cases, what could go wrong, edge case analysis.
grill-me
onsenturk
Adversarial Socratic interrogation of an idea, design, plan, or PR. You challenge the user''s assumptions, probe edge cases, and stress-test their reasoning before they commit. Use when the user says "grill me", "challenge this", "poke holes", "play devil''s advocate", "stress-test this", or wants t
using-serena-for-exploration
seanGSISG
Use when exploring codebases with Serena MCP tools for architectural understanding and pattern discovery - guides efficient symbolic exploration workflow minimizing token usage through targeted symbol reads, overview tools, and progressive narrowing
cursor-explorer-mcp
sepiabrown
Use for token-expensive operations requiring multi-file analysis - codebase exploration, broad searches, architecture understanding, tracing flows, finding implementations across files. Uses MCP cursor-agent server (company pays) with clean async interface. Do NOT use for single-file analysis, explaining code already in immediate context, or pure reasoning tasks.
fact-check
leonardomso
Verify technical accuracy of JavaScript concept pages by checking code examples, MDN/ECMAScript compliance, and external resources to prevent misinformation