prompt-forge

Clarify ambiguous user intent into a canonical prompt artifact in YAML.

6|1|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/JordanGunn/skills --skill prompt-forge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-forge
Source: https://github.com/JordanGunn/skills/tree/main/skills/prompt/forge
Command: npx skills add https://github.com/JordanGunn/skills --skill prompt-forge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Shape, refine, and stabilize human intent into a canonical prompt artifact without executing anything. Iteratively clarifies ambiguity and contradictions until the user explicitly confirms readiness.

Core Features & Use Cases

  • Iterative intent stabilization: loads existing artifacts or starts a fresh one, records assumptions, questions, and constraints, and writes to .prompt-forge/active.yaml.
  • Safety-first protocol: surfaces ambiguities, avoids execution, and requires explicit user confirmation to reach status: ready.
  • Use cases: preparing prompts for later execution via prompt-exec, building unambiguous instructions for complex tasks, and auditing intent for compliance.

Quick Start

Provide your initial intent and let the forge refine it into a ready-for-execution prompt.

Frequently Asked Questions about prompt-forge

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

FAQPage Schema
How do I refine ambiguous prompt intent into a clear instruction without executing it?

To refine ambiguous prompt intent without execution, an iterative clarification process stabilizes assumptions and constraints into a canonical artifact. It repeatedly questions ambiguities until explicit user confirmation marks the prompt as ready for downstream execution.

What is the best way to prepare a prompt for later execution via prompt-exec?

The best way to prepare a prompt for later execution is to iteratively clarify intent and record constraints into a canonical artifact. This safety-first protocol requires explicit user confirmation before transitioning the status to ready for execution.

How does iterative intent clarification handle contradictions in prompt instructions?

Iterative intent clarification handles contradictions by surfacing ambiguities and applying guardrails during the refinement session. It records assumptions and questions until contradictions are resolved, requiring explicit confirmation before finalizing the artifact.

Can I audit intent for compliance without triggering any automated actions?

Yes, you can audit intent for compliance without triggering automated actions by using a safety-first protocol that avoids execution entirely. It stabilizes human intent into a deterministic artifact and requires explicit confirmation before any status changes.

Do I need reference materials to build unambiguous instructions for complex tasks?

Yes, building unambiguous instructions for complex tasks requires access to reference materials listed in metadata. These references support the iterative questioning and clarification process needed to stabilize intent before writing the final artifact.

Why does prompt refinement require explicit user confirmation before reaching ready status?

Prompt refinement requires explicit user confirmation to enforce a safety-first protocol that prevents premature execution. This ensures all ambiguities are resolved and the canonical artifact accurately reflects stabilized intent before status transitions to ready.