benchmark-sandbox

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

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 ephemeral Vercel Sandboxes (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: Tracks skill injections across all three phases via hook claim directories and poll history, then compares claimed skills against expected skills per scenario. - Structured Haiku Scoring: Each phase is scored by a separate claude -p --json-schema --model haiku pass returning structured JSON for build completeness, per-story pass/fail, and deploy success. - Use Case: Generate a JSON file of app scenarios with user stories, run run-eval.ts with --scenarios-file, and receive a markdown report with skill coverage, verification results, and permanent *.vercel.app deploy URLs. ## Quick Start Run the eval pipeline by executing bun run .claude/skills/benchmark-sandbox/run-eval.ts with a scenarios JSON file after linking the project with npx vercel link --scope vercel-labs.

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 benchmark scenarios in sandboxes?

Run bun run .claude/skills/benchmark-sandbox/run-eval.ts with --scenarios-file pointing to a JSON file of scenarios. Each scenario needs a slug, prompt, expectedSkills array, and exactly three user stories. Use --concurrency to control parallel sandboxes up to 10.

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 to *.vercel.app URLs, and haiku structured JSON scoring per phase.

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 v2 is incompatible. Snapshots, port exposure via sandbox.domain(3000), and extendTimeout all work on v1.8.0.

Why do sandbox eval artifacts disappear before extraction?

Sandbox filesystems are ephemeral and the session-end-cleanup hook deletes /tmp/vercel-plugin-*-seen-skills.d/ 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 Vercel Sandboxes alive after an eval run?

Yes, pass --keep-alive with --keep-hours N to run-eval.ts. The runner calls sandbox.extendTimeout() to extend the sandbox lifetime, and port 3000 remains publicly reachable at its https://sb-XXX.vercel.run URL for the specified duration.

Why should scenario prompts avoid naming specific technologies?

User-story-focused prompts let the plugin detect patterns from actual code rather than tech name-dropping, producing more realistic skill-injection coverage. Prompts should describe real-world apps and end with instructions to link the vercel-labs team and start the dev server on port 3000.