prompt-design

Diagnose structural prompt failures and redesign prompts for reliable LLM outputs.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/Victoriakaey/build-reliable-agents --skill prompt-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-design
Source: https://github.com/Victoriakaey/build-reliable-agents/tree/main/skills/prompt-design
Command: npx skills add https://github.com/Victoriakaey/build-reliable-agents --skill prompt-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prompts often fail because of structural issues rather than wording: a node does multiple jobs, input organization primes the wrong reasoning pattern, the schema places verdicts before reasoning, or prompts accumulate conflicting rules over time. These structural failures produce inconsistent, unstable, or incorrect LLM outputs and increase debugging cost in production agent pipelines.

Core Features & Use Cases

  • Define a node's single primary job before writing any prompt and list explicit "must not" responsibilities to avoid mixed responsibilities.
  • Design input structure, system/user split, and output schema (reasoning-before-verdict, scores-derived-booleans, enum routing) to improve determinism and routing robustness.
  • Diagnose existing prompts with a stepwise audit (boundary check, input structure, system/user split, schema, rules, token budget, prompt decay) and produce concrete fixes and regression risk notes.
  • Use cases include designing critic/judge nodes, retrieval sufficiency checks, prompt-change management, and preventing prompt decay in long-lived agents.

Quick Start

Ask the assistant to audit the prompt and return a redesigned prompt that defines one clear job, flattens evidence for holistic reasoning, places reasoning before verdict, constrains routing fields to enums, and lists no more than five critical rules.

Frequently Asked Questions about prompt-design

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

FAQPage Schema
How do I fix inconsistent LLM outputs caused by prompt structure issues?

To fix inconsistent LLM outputs, audit prompts for structural failures like mixed node responsibilities or misplaced verdicts, then enforce a single primary job, reasoning-before-verdict schemas, and minimal rule sets to improve determinism.

How do I design a critic or judge node for an LLM agent pipeline?

Designing a critic node requires defining a single job, flattening evidence for holistic reasoning, and placing reasoning before the verdict. Constraining routing fields to enums and limiting rules to five improves routing robustness and output reliability.

What causes prompt decay in long-lived agents and how do I prevent it?

Prompt decay occurs when prompts accumulate conflicting rules over time in long-lived agents. Prevent it by auditing rule sets, constraining critical rules to five maximum, and managing token budget limits to maintain output determinism.

What is the best way to structure input and output schemas for reliable LLM routing?

The best way to structure schemas for reliable LLM routing is flattening evidence for holistic reasoning, placing reasoning before verdicts, deriving booleans from scores, and constraining routing fields to enums to improve routing robustness.

How do I audit an existing prompt for regression risk in production agents?

Auditing an existing prompt for regression risk involves a stepwise check of boundaries, input structure, system/user split, schema ordering, rules, and token budget to produce concrete fixes and identify regression risk notes.