empirical-prompt-tuning

Iteratively refine agent-facing instructions using bias-free executor evaluation and two-sided metrics.

2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/tukuyomil032/Perch --skill empirical-prompt-tuning-tukuyomil032
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: empirical-prompt-tuning
Source: https://github.com/tukuyomil032/Perch/tree/main/.agents/skills/empirical-prompt-tuning
Command: npx skills add https://github.com/tukuyomil032/Perch --skill empirical-prompt-tuning-tukuyomil032

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of ensuring the clarity and effectiveness of agent-facing instructions, such as prompts and commands, by employing a systematic, iterative approach to refinement and evaluation.

Core Features & Use Cases

  • Bias-Free Evaluation: Utilizes a separate executor to evaluate the clarity and effectiveness of instructions without the bias of the original author.
  • Two-Sided Evaluation: Combines executor self-reports with objective metrics to assess the quality of instructions.
  • Iterative Refinement: Continuously improves instructions through a structured workflow that identifies unclear points and proposes fixes.

Quick Start

To evaluate and refine a prompt, use the empirical-prompt-tuning skill with the following command: empirical-prompt-tuning --prompt "Your prompt here" --scenarios "Scenario 1" "Scenario 2" --checklist "Item 1" "Item 2" ...

Frequently Asked Questions about empirical-prompt-tuning

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

FAQPage Schema
How do I iteratively refine agent-facing instructions to improve AI performance?▼

Iterative prompt refinement improves agent-facing instructions through a structured workflow involving bias-free executor evaluation, two-sided metrics, and continuous fixes. You provide the prompt, scenarios, and a checklist to evaluate clarity and effectiveness systematically.

What is bias-free evaluation in prompt tuning and how does it work?▼

Bias-free evaluation in prompt tuning uses a separate executor to assess instruction clarity without the original author's bias. It combines executor self-reports with objective instruction-side metrics to identify unclear points and propose targeted fixes.

Can I evaluate slash commands and CLAUDE.md files using iterative prompt refinement?▼

Yes, iterative prompt refinement applies to slash commands, CLAUDE.md files, skills, and code-gen prompts. It evaluates any agent-facing instructions requiring high clarity for automated tasks by using scenarios and checklists to measure effectiveness.

What's the best way to evaluate code-gen prompts for automated AI tasks?▼

The best way to evaluate code-gen prompts is combining two-sided self-reports with objective instruction-side metrics. A separate executor tests the instructions against defined scenarios and a checklist to identify gaps and drive iterative refinement.

Do I need specific dependencies to perform two-sided instruction evaluation?▼

No specific dependencies are required to perform two-sided instruction evaluation. The workflow operates independently using scripts and references to assess agent-facing instructions through executor self-reports and objective metrics.

Why does my AI agent follow instructions inconsistently across different scenarios?▼

AI agents follow instructions inconsistently when prompts lack clarity. Iterative prompt tuning addresses this by using a bias-free executor to test scenarios, measuring instruction-side metrics, and proposing structured fixes to eliminate ambiguity.