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.