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.