prompt-optimizer

Rewrite vague user requests into agent-ready specifications with acceptance criteria.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/TDMorales/skill_set_library --skill prompt-optimizer-tdmorales
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-optimizer
Source: https://github.com/TDMorales/skill_set_library/tree/main/skills/.experimental/prompt-optimizer
Command: npx skills add https://github.com/TDMorales/skill_set_library --skill prompt-optimizer-tdmorales

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill transforms unclear or underspecified user requests into detailed, actionable specifications that AI agents can execute without ambiguity.

Core Features & Use Cases

  • Clarifies Ambiguity: Conversationally gathers necessary context to resolve vague user prompts.
  • Generates Structured Specs: Produces either a "Creation Spec" for building new features or a "Task Spec" for non-creation work.
  • Use Case: A user says, "I want to add a new user profile section." This Skill will ask clarifying questions about data fields, UI elements, and existing patterns to generate a complete spec for building that section.

Quick Start

Use the prompt-optimizer skill to rewrite the user's request into an agent-ready specification.

Frequently Asked Questions about prompt-optimizer

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

FAQPage Schema
How do I turn vague user requests into clear specs for AI agents?

To turn vague requests into clear specs, you need to conversationally gather context and define acceptance criteria. This process rewrites ambiguous prompts into structured markdown files that any LLM-based agent can execute deterministically without guessing scope.

What is the best way to write prompt specifications for code generation tasks?

Writing prompt specifications for code generation requires defining clear scope and context. You can generate either a Creation Spec for new features or a Task Spec for refactoring, ensuring the AI agent receives implementation-ready instructions.

How do I clarify ambiguous task definitions before sending them to an LLM agent?

To clarify ambiguous task definitions, you should ask targeted questions about data fields, UI elements, and existing patterns. Resolving these underspecified details upfront prevents AI agents from making incorrect assumptions during code generation.

Can I use prompt engineering to generate specs for both new features and refactoring work?

Yes, prompt engineering can generate specs for both new features and refactoring work. It creates Creation Specs for building new components and Task Specs for optimization, ensuring both workflows produce detailed, implementation-ready markdown files.

Why does my AI agent produce inconsistent results from underspecified prompts?

AI agents produce inconsistent results from underspecified prompts because they lack clear scope and acceptance criteria. By rewriting vague asks into agent-ready specifications, you eliminate ambiguity and ensure deterministic task execution across LLM-based workflows.

Does prompt-optimizer work without external dependencies for task definition?

Prompt-optimizer works without external dependencies for task definition. It operates independently to rewrite vague asks into structured markdown specifications, requiring no additional libraries to clarify context and scope for your AI agent.