bootstrap-realtime-eval

Scaffolds new realtime eval folders with harness selection, starter data, and validation runs.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill bootstrap-realtime-eval-kiranimmadi2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bootstrap-realtime-eval
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/openai-cookbook/examples/evals/realtime_evals/skills/bootstrap-realtime-eval
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill bootstrap-realtime-eval-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Setting up a new realtime eval in the openai-cookbook repository requires choosing the correct harness, creating prompt, tools, and data files, writing a README, and validating everything with smoke and full eval runs, which is tedious and error-prone to do by hand. ## Core Features & Use Cases - Harness Selection Guidance: Helps choose between the crawl (single-turn text-to-TTS), walk (audio replay or generated audio), and run (multi-turn simulation with tool mocks) harnesses based on the evaluation goal. - Automated Scaffolding: Runs a scaffold script to generate the eval folder with system prompt, tools.json, starter datasets, and a README containing run commands and data contracts. - Realistic Starter Data: Authors use-case-grounded starter rows or simulations instead of generic placeholders, then validates with smoke evals, full evals, and pytest. - Use Case: A developer wants to evaluate a customer-support voice agent's tool-calling behavior; the skill asks for the scenario, recommends the crawl harness, scaffolds the folder, writes three realistic starter rows, and verifies everything runs. ## Quick Start Ask the assistant to bootstrap a new realtime eval for your scenario, providing the eval name, goal, system prompt, tools, and data source so it can pick a harness and scaffold the folder.

Frequently Asked Questions about bootstrap-realtime-eval

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

FAQPage Schema
How do I create a new realtime eval in the openai-cookbook repo?

Provide the eval name, goal, system prompt, tools, and data source, and the skill scaffolds a folder under examples/evals/realtime_evals using the shared crawl, walk, or run harness. It then validates the result with smoke and full eval runs plus pytest.

Which realtime eval harness should I use: crawl, walk, or run?

Use crawl for single-turn text-to-TTS iteration, walk for replaying saved audio or generating audio with noise or telephony characteristics, and run for multi-turn simulations with tool mocks and conversation-level grading. Crawl is the default for simple text rows or unspecified synthetic audio.

Can I generate synthetic audio for a realtime eval?

Yes, synthetic audio defaults to the crawl harness text-to-TTS path unless you need replay-specific characteristics like noise, telephony artifacts, or speaker traits, in which case the walk harness with walk_harness/generate_audio.py is used.

What data columns does a crawl or walk realtime eval require?

Crawl requires example_id and user_text columns, with optional gt_tool_call and gt_tool_call_arg for tool-call grading. Walk additionally requires audio_path when audio already exists, otherwise audio is generated from text rows.

Why does my scaffolded realtime eval fail validation?

Failures usually come from missing OPENAI_API_KEY, absent ffmpeg for audio steps, or malformed starter data. The skill runs a smoke eval first, stops on failure to fix the blocker, and only proceeds to the full eval and pytest after the smoke run succeeds.