smithery/neversight

spec-clarify

Identify underspecified areas in a feature spec by asking up to 5 targeted clarification questions and encoding answers into the spec. Use when user says "/spec-clarify", "clarify the spec", or after /spec-specify to reduce ambiguity before /spec-plan.

Installation

$ npx skills add smithery/neversight --skill spec-clarify

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/neversight · top by installs.

npx skills add smithery/neversight

Browse all from smithery/neversight

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,083 B
  • docs SUMMARY.md 272 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Spec-Clarify

Reduce ambiguity in specifications through targeted questioning.

Prerequisites: Feature spec must exist (run /spec-specify first).

Workflow

  1. Initialize - Run .specify/scripts/bash/check-prerequisites.sh --json --paths-only
  2. Load spec - Read spec.md
  3. Scan ambiguity - Analyze coverage taxonomy
  4. Generate questions - Max 5, prioritized by impact
  5. Question loop - Present ONE at a time with recommendation
  6. Integrate answers - Update spec after each answer
  7. Report - Output summary and next steps

Ambiguity Taxonomy

Categories to scan (mark Clear/Partial/Missing):

Category Check For
Functional Scope User goals, out-of-scope, personas
Data Model Entities, relationships, constraints
UX Flow Journeys, error states, accessibility
Non-Functional Performance, security, observability
Integration External APIs, formats, versioning
Edge Cases Negative scenarios, rate limits

Question Format

Multiple Choice:

**Recommended:** Option A - <reasoning>

| Option | Description |
|--------|-------------|
| A | Option A |
| B | Option B |
| Short | Custom answer (<=5 words) |

Short Answer:

**Suggested:** <answer> - <reasoning>
Format: <=5 words. Say "yes" or provide your own.

Integration Rules

After each answer:

  1. Add ## Clarifications section if missing
  2. Add ### Session YYYY-MM-DD subheading
  3. Append: - Q: <question> → A: <answer>
  4. Update relevant spec section
  5. Save immediately

Constraints

  • Max 5 questions asked
  • Max 10 questions total across session
  • Respect "done", "stop", "proceed" signals

Next Steps

After /spec-clarify:

  • /spec-plan - Create technical plan