prompt-tuner

Validate prompt outputs against a golden dataset with OpenAI or Gemini.

18|2|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/Onlyaguest/ViviStableSkills --skill prompt-tuner-onlyaguest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prompt-tuner
Source: https://github.com/Onlyaguest/ViviStableSkills/tree/main/prompt-tuner
Command: npx skills add https://github.com/Onlyaguest/ViviStableSkills --skill prompt-tuner-onlyaguest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, python-dotenv, pyyaml.

What problem does it solve?

This skill automates prompt regression testing and tuning by validating outputs against a golden dataset.

Core Features & Use Cases

  • Local structure checks with --check to validate setup without API calls.
  • Full regression runs against OpenAI or Gemini using a configured prompt.txt and cases.yaml.
  • Versioned changes tracked in prompt.txt and CHANGELOG.md for auditable updates.
  • Use cases include prompt optimization, regression testing, and TDD-style prompt development.

Quick Start

Run python3 tuner.py --check to verify the local structure, then run python3 tuner.py to execute full regression tests against your configured provider.

Frequently Asked Questions about prompt-tuner

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

FAQPage Schema
How do I run prompt regression testing against a golden dataset?▼

Prompt regression testing validates outputs against a golden dataset by running full regression tests against OpenAI or Gemini, requiring a configured prompt.txt and cases.yaml to ensure repeatable improvements.

What is prompt tuning and how does versioning work?▼

Prompt tuning optimizes instructions through regression tests, using versioned changes tracked in prompt.txt and CHANGELOG.md to provide auditable updates for repeatable LLM output improvements.

Can I validate my prompt regression setup without making API calls?▼

You can validate your prompt regression setup without API calls by running the local structure check command, which verifies the configuration of prompt.txt and cases.yaml before executing provider-driven regressions.

Does prompt regression testing work with both OpenAI and Gemini providers?▼

Prompt regression testing works with both OpenAI and Gemini providers, requiring environment-configured API keys to execute full regression runs against the selected model provider.

How do I get started with TDD-style prompt development for LLMs?▼

TDD-style prompt development starts by defining test cases in cases.yaml and an initial prompt.txt, then running local structure checks before executing full regressions to validate output consistency.

Why do I need a golden dataset for LLM prompt optimization?▼

A golden dataset is needed for LLM prompt optimization to provide a stable validation baseline, allowing regression tests to detect output degradations and ensure prompt edits result in auditable improvements.