prompt-refinementlisted
Install: claude install-skill josix/agent-flow
# Prompt Refinement
## Overview
Prompt refinement transforms ambiguous or incomplete user requests into clear, structured task specifications suitable for multi-agent orchestration. This skill bridges natural language input and the precise specifications required by downstream agents.
### Purpose
Ensure tasks entering the orchestration pipeline have:
- **Clear Objectives**: A single, well-defined goal that can be verified
- **Actionable Steps**: Concrete actions that agents can execute
- **Measurable Outcomes**: Success criteria that verification agents can check
- **Appropriate Scope**: Boundaries that prevent scope creep
### When to Use This Skill
Apply prompt refinement when:
- User input contains ambiguous terms ("fix it", "make it better")
- The request lacks specific targets (files, components, systems)
- Multiple interpretations of the request are possible
- Pre-processing is required for `/orchestrate` or `/plan` commands
### Key Principles
1. **Ask First, Act Second**: When genuinely ambiguous, clarify before proceeding
2. **One Question at a Time**: Never overwhelm users with multiple clarification requests
3. **Provide Options**: Give concrete choices to speed up clarification
4. **Default Gracefully**: Make reasonable assumptions when users don't respond
5. **Preserve Intent**: Refinement should clarify, not change the user's goal
---
## Refinement Template
### Standard Format
```
**Goal**: <one-sentence objective stating what will be accomplished>
*