Improves specification quality through completeness checks, clarity verification, and structured feedback. Use when specifications lack detail, have ambiguities, or need quality improvement.
Analyzes specifications for ambiguities and gaps, then generates targeted clarification questions to improve completeness.
npx claudepluginhub bacchus-labs/wranglerThis skill inherits all available tools. When active, it can use any tool Claude has access to.
For each category with Partial or Missing status, add a candidate question opportunity unless:
Generate (internally) a prioritized queue of candidate clarification questions (maximum 5). Apply these constraints:
Add your questions to a new section at the bottom of the spec titled "Open Questions for Clarification".
Update the specification file with:
## Open Questions for Clarification
### Question 1: [Category - Brief Topic]
**Question**: [Clear, specific question]
**Options** (if multiple choice):
- A: [Option description]
- B: [Option description]
- C: [Option description]
**Impact**: [Why this matters for implementation]
---
### Question 2: [Category - Brief Topic]
**Question**: [Clear, specific question (answer in <=5 words)]
**Impact**: [Why this matters]
---
[... up to 5 questions total]
writing-specifications - Create initial specrefining-specifications - Detect and resolve ambiguitywriting-plans - Create detailed implementation planAfter spec creation: Run refinement to catch gaps before planning Before implementation: Ensure all decisions are clear After feedback: Incorporate stakeholder input and re-check for gaps
User: "Review the auth spec for gaps" You: Scan taxonomy, identify missing error handling approach, unclear session timeout, ambiguous "secure" requirement, generate 3-5 questions
User: "Is this spec ready for planning?" You: Check completeness across taxonomy, identify missing acceptance criteria, unclear performance requirements, add questions section
User: "We got feedback on the spec, check for new gaps" You: Re-scan with new information, identify areas still ambiguous, prioritize remaining questions
A good refinement session:
✅ Identifies genuine ambiguities that would cause implementation confusion ✅ Asks questions that materially impact design decisions ✅ Prioritizes high-impact uncertainties ✅ Limits questions to 5 most critical ✅ Makes questions easy to answer (multiple choice or short phrase) ✅ Focuses on what can't be deferred to planning phase
writing-specifications - Create specifications (use before refinement)validating-roadmaps - Check consistency across multiple specs (use for projects with many specs)writing-plans - Create implementation plans (use after refinement)