prompt-refinement

Refine vague user requests into structured task specifications for orchestration.

7|1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/josix/agent-flow --skill prompt-refinement-josix
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prompt-refinement
Source: https://github.com/josix/agent-flow/tree/main/skills/prompt-refinement
Command: npx skills add https://github.com/josix/agent-flow --skill prompt-refinement-josix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps resolve unclear or under-specified user requests by transforming them into a structured, executable specification suitable for multi-agent orchestration.

Core Features & Use Cases

  • Ambiguity detection: Identifies missing scope, targets, success criteria, and conflicting interpretations that would derail downstream planning.
  • Clarification-first refinement: Requests a single focused answer with concrete options when ambiguity is high or risky.
  • Template-based task shaping: Converts resolved intent into a goal/description/actions format with atomic, ordered steps and inferred verification criteria.
  • Orchestration routing: Helps decide whether a prompt should pass through unchanged or be refined for orchestration based on complexity and scope.

Quick Start

Use the prompt-refinement skill to refine your request so it becomes a clear goal with an action plan and measurable success criteria for agents to execute.

Frequently Asked Questions about prompt-refinement

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

FAQPage Schema
How do I turn a vague request into a clear task specification for multi-agent orchestration?▼

To turn a vague request into a clear task specification, you refine it by detecting ambiguities, requesting clarifications, and shaping the intent into a goal with ordered atomic actions and inferred verification criteria.

What is the best way to handle ambiguous goals and missing scope before planning an agent orchestration?▼

Handling ambiguous goals before agent orchestration requires identifying missing success criteria and requesting a single focused answer with concrete options to establish safe default assumptions for the downstream plan.

How do I structure a refined prompt into orchestration-ready atomic actions?▼

Structuring a refined prompt into orchestration-ready atomic actions involves converting resolved intent into a goal and description format, producing ordered atomic steps with inferred verification criteria for execution.

Does multi-agent orchestration require task refinement for every prompt?▼

Multi-agent orchestration does not require task refinement for every prompt; routing decisions evaluate complexity and scope to determine whether a prompt passes through unchanged or undergoes refinement.

What happens when conflicting interpretations are detected during prompt refinement?▼

When conflicting interpretations are detected during prompt refinement, the process issues clarification-first requests to resolve high-risk ambiguities before finalizing the task specification.

Can I use task specification templates for multi-agent orchestration without explicit success criteria?▼

Using task specification templates without explicit success criteria prompts the refinement process to apply safe default assumptions, ensuring the multi-agent orchestration plan remains executable.