prompt-prep

Refines raw task descriptions into structured prompts through codebase reconnaissance and user interviews.

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/ulebule/claude-skills --skill prompt-prep-ulebule
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-prep
Source: https://github.com/ulebule/claude-skills/tree/main/plugins/prompt-prep/skills/prompt-prep
Command: npx skills add https://github.com/ulebule/claude-skills --skill prompt-prep-ulebule

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Raw task descriptions are full of blind spots: unstated conventions, hidden constraints, and edge cases the user never thought to mention. This Skill surfaces those unknowns before any work begins, so the final prompt reflects the real task instead of the half-remembered one. ## Core Features & Use Cases - Blindspot pass: Explores the codebase or domain first to find existing modules, conflicting constraints, and edge cases the raw prompt silently ignores. - Structured interview: Asks up to five prioritized questions, preferring recognition-style options over open questions, and skips anything resolvable from the code. - Calibrated prompt output: Produces a ready-to-paste prompt with context, goal, references, constraints, explicit degrees of freedom, a plan-first instruction, and verification criteria. - Use Case: You type /prompt-prep add caching to the API. The Skill scans the repo, finds an existing cache layer and a migration constraint, asks two scoping questions, and returns a refined prompt that pins the decisions and leaves the rest to the model. ## Quick Start Invoke /prompt-prep followed by your raw task description to get a refined, ready-to-paste prompt.

Frequently Asked Questions about prompt-prep

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

FAQPage Schema
How do I improve a vague prompt before giving it to an AI coding assistant?

Run /prompt-prep with your raw task description. It first explores the codebase for hidden constraints and prior implementations, then asks a few targeted questions, and finally produces a refined prompt with context, decisions, and verification criteria.

What is the blindspot pass in prompt preparation?

The blindspot pass is an exploration step where the assistant searches the codebase or domain for existing modules, conflicting constraints, and edge cases the raw task description ignores. Findings are reported as a short list before any interview questions are asked.

Can I skip the interview when refining a prompt?

Yes, use the --quick flag to skip the interview entirely. The Skill still runs the blindspot pass and converts the would-be questions into explicit stated assumptions inside the final prompt.

When should I not over-specify a prompt?

Over-specification causes rigid adherence even when pivoting mid-task would help. Only pin down decisions you actually verified during reconnaissance and the interview; for everything else, explicitly grant the model freedom to decide and flag its choices.

Does prompt-prep execute the refined prompt automatically?

Only if you pass the --run flag. By default it hands off the refined prompt in a code block and offers to run it in the current session or recommends pasting it into a fresh session for large tasks.