benchmark-sandbox

Runs vercel-plugin eval scenarios in ephemeral Vercel Sandboxes with build, verify, and deploy phases.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/dsgalkar/dnyaneshwar_portfolio --skill benchmark-sandbox-dsgalkar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: benchmark-sandbox
Source: https://github.com/dsgalkar/dnyaneshwar_portfolio/tree/main/.agents/plugins/vercel/.claude/skills/benchmark-sandbox
Command: npx skills add https://github.com/dsgalkar/dnyaneshwar_portfolio --skill benchmark-sandbox-dsgalkar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @vercel/sandbox, @anthropic-ai/claude-code, agent-browser, vercel.

What problem does it solve? Running plugin benchmark evals locally in WezTerm panes limits parallelism, requires manual verification, and leaves no permanent deploy URLs. This Skill moves eval scenarios into remote Vercel Sandboxes (ephemeral Firecracker microVMs) so benchmarks run in parallel with automated browser verification, deployment, and structured scoring. ## Core Features & Use Cases - 3-Phase Eval Pipeline: Phase 1 builds the app with Claude Code, Phase 2 uses agent-browser to walk through user stories and fix failures, Phase 3 links to the vercel-labs team and runs vercel deploy with up to 3 build-error retries. - Skill Coverage Tracking: Extracts claimed/seen skill artifacts across all phases and produces coverage reports comparing expected vs. actual skill injections. - Haiku Structured Scoring: Each phase is scored via claude -p --json-schema --model haiku, returning structured JSON for build completeness, per-story pass/fail, and deploy success. - Use Case: Generate a JSON file of app scenarios (slug, prompt, expectedSkills, userStories), then run the eval runner to get per-scenario result.json files, public sandbox URLs, permanent *.vercel.app deploy URLs, and a markdown coverage report. ## Quick Start Run the benchmark-sandbox eval with a scenarios JSON file using bun run .claude/skills/benchmark-sandbox/run-eval.ts --scenarios-file /tmp/my-scenarios.json.

Frequently Asked Questions about benchmark-sandbox

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

FAQPage Schema
How do I run vercel-plugin eval scenarios in Vercel Sandboxes?

Run bun run .claude/skills/benchmark-sandbox/run-eval.ts with an optional --scenarios-file pointing to a JSON array of scenarios. Each scenario needs a slug, prompt, expectedSkills array, and exactly three user stories.

What is the difference between benchmark-sandbox and benchmark-agents?

benchmark-agents runs evals in local macOS WezTerm panes with manual verification, while benchmark-sandbox uses remote Vercel Sandboxes with up to 10 parallel microVMs, automated agent-browser verification, automated deploys, and haiku structured scoring.

Which Vercel Sandbox SDK version works with this eval runner?

Use @vercel/sandbox version 1.8.0. The v2 beta's named sandbox endpoint returns 404 for the vercel-labs team, so the v2 SDK is incompatible with this setup.

Why do sandbox eval artifacts disappear before extraction?

Sandbox filesystems are ephemeral and the session-end-cleanup hook deletes the seen-skills claim directories when a session ends. Extract artifacts before the session completes or rely on poll history data captured during the run.

Can I keep sandboxes alive after an eval run finishes?

Yes, pass --keep-alive with --keep-hours N to the run-eval.ts script. The runner uses sandbox.extendTimeout() to keep microVMs running with their public https://sb-XXX.vercel.run URLs for the specified duration.

How does structured scoring work in the sandbox eval pipeline?

After each phase, a separate claude -p --json-schema --model haiku pass runs inside the sandbox and returns structured JSON. The actual schema data is in parsed.structured_output of the response, not the top-level object.