clarify-spec

Generates structured JSON task definitions from vague instructions via clarifying questions.

38|5|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/Svenja-dev/claude-code-skills --skill clarify-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify-spec
Source: https://github.com/Svenja-dev/claude-code-skills/tree/main/clarify-spec
Command: npx skills add https://github.com/Svenja-dev/claude-code-skills --skill clarify-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill reduces repeated back-and-forth by automatically initiating clarifying questions when a user provides vague instructions, ensuring a precise task definition before any code is written.

Core Features & Use Cases

  • Automatic vagueness detection and proactive questioning before execution
  • Context gathering from project files and CLAUDE.md/AGENTS.md to inform questions
  • Generation of a structured JSON payload for downstream agents, enabling deterministic prompt-architect prompts
  • Clear escalation paths and escape hatches to proceed when appropriate

Quick Start

Start by installing this skill in your ~/.claude/skills directory. When a vague instruction is detected, Claude will respond with 2–4 targeted clarifying questions before performing any coding work. If the user wants to skip clarifications, use the escape hatches such as "Mach einfach" or "Entscheide selbst" to proceed with best-guess execution.

Frequently Asked Questions about clarify-spec

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

FAQPage Schema
How do I automate clarifying questions for vague prompt requests?

The skill detects vague instructions automatically and prompts 2-4 clarifying questions before writing code. It analyzes project context and relevant files to narrow the scope and define the task precisely.

What is a structured JSON payload for prompt engineering?

A structured JSON payload for prompt engineering defines a clarified task using fields like goal, scope, success criteria, and constraints. It enables deterministic prompt-architect prompts for downstream agents.

How do I stop repeated back-and-forth when assigning coding tasks?

Stop repeated back-and-forth by initiating clarifying questions before code execution. Analyzing context from project files like CLAUDE.md ensures all requirements are gathered upfront for precise outcomes.

Can I skip clarifying questions if I want immediate code execution?

Yes, you can skip clarifications using escape hatches like phrases stating to just do it or decide independently. This proceeds with best-guess execution based on the initial instructions.

Does this clarification tool gather context from project files?

Yes, context gathering reads project files and configuration files like CLAUDE.md and AGENTS.md. This gathered context informs the targeted questions to accurately narrow the task scope.

What are the limitations of automated request clarification?

Automated request clarification relies on available project context to formulate questions. If context is missing, questions may not fully capture the scope, requiring manual input or using escape hatches for best-guess execution.