speckit-refine

Identify feature spec gaps and generate /speckit.clarify prompts.

1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/tjespers/claude-skills --skill speckit-refine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-refine
Source: https://github.com/tjespers/claude-skills/tree/main/speckit-refine
Command: npx skills add https://github.com/tjespers/claude-skills --skill speckit-refine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and surface gaps in feature specs, and shape precise input for /speckit.clarify to reduce ambiguity and speed alignment.

Core Features & Use Cases

  • Phase-driven refinement: Guides discovery and prioritization across Phase 0–Phase 3 to surface concrete clarifications.
  • Context-aware prompts: Generates targeted inputs that align clarifications with existing spec content and plan artifacts.
  • Flexible hand-off: Produces a ready-to-submit /speckit.clarify draft or sequenced prompts for staged refinement.

Quick Start

Summarize the current spec gaps and generate a focused /speckit.clarify prompt to address the top refinement priorities.

Frequently Asked Questions about speckit-refine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify gaps in a feature spec to reduce ambiguity?

To refine a feature spec, use a phase-driven workflow that guides discovery across Phase 0 to Phase 3, prioritizing concrete clarifications. It produces a ready-to-submit clarification draft or sequenced prompts for staged refinement to accelerate alignment.

What is the best way to generate clarifying questions for product planning phases?

Context-aware prompts generate targeted inputs that align clarifications with existing spec content and plan artifacts. This method surfaces concrete clarifications across phases and shapes precise input for structured alignment.

Does spec refinement work for phase-based planning workflows?

Spec refinement applies to plan-driven workflows across Phase 0 to Phase 3. It guides discovery and prioritization within these phases to surface concrete clarifications and dependencies requiring resolution.

Can I create a ready-to-run clarification draft from an existing feature spec?

Yes, flexible hand-off produces a ready-to-submit clarification draft directly from an existing feature spec. It summarizes current spec gaps and generates a focused prompt to address top refinement priorities.

Why does my feature spec still have ambiguities after initial planning?

Feature specs retain ambiguities when thinnest areas and dependencies remain unresolved after initial planning. Phase-driven refinement identifies these gaps and generates targeted clarification inputs to reduce ambiguity.