synthesize-agent-benchmark

Generates validated sample and formal JSONL benchmark datasets for AI agents after capability exploration.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill synthesize-agent-benchmark-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthesize-agent-benchmark
Source: https://github.com/CHENHUI-X/toolbox/tree/main/codex-skill/codex/synthesize-agent-benchmark
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill synthesize-agent-benchmark-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building offline evaluation datasets for AI agents often produces inconsistent, fabricated, or non-representative test cases. This Skill explores an agent's real prompts, tools, business rules, and code first, builds a capability map and mutually exclusive scenario plan, then generates traceable, self-consistent JSONL benchmark data only after user confirmation. ## Core Features & Use Cases - Capability and Scenario Exploration: Reads agent prompts, tool definitions, business rules, and code to build a capability map with evidence-backed, mutually exclusive scenarios before any data generation. - Two-Stage Confirmed Generation: Produces a small sample JSONL set for user review first, then generates the formal dataset only after explicit approval, with rejected cases written to a separate rejected.jsonl. - Validation and Coverage Tooling: Ships scripts to inspect agent bundles, validate capability maps, check JSONL structure and cross-field consistency, and report scenario coverage against the capability map. - Use Case: Point it at a tool-calling or RAG agent directory, confirm the discovered capabilities and scenarios in Chinese, and receive a validated offline evaluation dataset for regression testing or synthetic multi-turn dialogue. ## Quick Start Explore the agent in ./agent_bundle, summarize its capabilities and concrete scenarios in Chinese, and wait for my confirmation before generating any sample JSONL data.

Frequently Asked Questions about synthesize-agent-benchmark

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

FAQPage Schema
How do I generate evaluation data for an AI agent?

Provide the agent's directory containing prompts, tool definitions, and business rules. The skill explores the code to build a capability map, proposes concrete scenarios for your confirmation, then generates a sample JSONL set and, after your review, the formal dataset.

What agent frameworks does benchmark synthesis support?

It supports tool-calling agents, RAG agents, workflow or state-machine agents, routing and multi-agent systems, pure generation agents, and hybrids. Each framework has its own traceability chain linking facts, inputs, processing paths, evidence, and expected answers.

Can I generate benchmark JSONL without confirming scenarios first?

No. The workflow requires explicit user confirmation after capability and scenario exploration, and again after sample review before formal generation. This prevents fabricating scenarios or gold labels that the agent's actual rules cannot support.

How is generated benchmark data validated?

Bundled scripts validate JSONL structure, required fields, unique IDs, history alternation, and cross-field consistency, plus coverage against the confirmed capability map. Failed cases go to a separate rejected.jsonl with Chinese failure reasons; business semantics still need manual review.

What are the limitations of synthetic agent benchmark data?

Generic scripts only check structure and coverage, not business correctness. Cases whose gold labels cannot be determined from existing rules are marked pending user confirmation rather than guessed, and any dependency change requires re-validation of affected cases.