test-sandbox

Provision isolated sandbox environments to test Specflow init, upgrade, and check flows.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/mkrlabs/specflow --skill test-sandbox-mkrlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-sandbox
Source: https://github.com/mkrlabs/specflow/tree/main/.claude/skills/test-sandbox
Command: npx skills add https://github.com/mkrlabs/specflow --skill test-sandbox-mkrlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires deno, npm, git, and includes scripts (resource) components.

What problem does it solve?

Spin up isolated sandbox environments under sandbox/ to test Specflow UX against real-world project shapes without risking the main codebase.

Core Features & Use Cases

  • Bootstraps Vite React-TS or empty greenfield projects inside sandbox/ (sandbox is gitignored) to let you validate UX against real project layouts.
  • Runs Specflow against the current source tree via deno to test init / upgrade / check flows without installing the binary.
  • Provides utilities to compare harness outputs across eight AI harnesses and inspect results, all within idempotent scripts.

Quick Start

Run bootstrap-vite.sh with a name to create a sandbox, then run run-init.sh with a harness to execute Specflow against the current source.

Frequently Asked Questions about test-sandbox

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

FAQPage Schema
How do I test Specflow workflows against real-world project shapes without affecting my main codebase?

You can test Specflow workflows safely by provisioning isolated sandbox environments using idempotent bootstrap scripts. The sandbox directory is gitignored at the repository root, ensuring your main codebase remains unaffected.

What AI harnesses can I use to compare Specflow UX testing outputs?

You can compare Specflow UX testing outputs across eight AI harnesses: claude, cursor, codex, gemini, windsurf, copilot, opencode, and antigravity. The sandbox provides utilities to inspect results across these platforms.

Do I need Deno installed to run Specflow sandbox tests against the current source tree?

Yes, Deno is required because the sandbox executes Specflow against the current source tree using Deno-based execution. This approach allows you to test init, upgrade, and check flows without installing the binary.

What is the best way to validate Specflow init and upgrade flows in a Vite React-TS project?

The best way to validate Specflow init and upgrade flows is by bootstrapping a Vite React-TS project inside the sandbox directory. You then run the init script with your chosen harness to execute Specflow against the current source.

Can I use Specflow sandbox testing for greenfield projects with no existing code?

Yes, the sandbox bootstrap scripts can provision either a Vite React-TS project or an empty greenfield project. This allows you to validate UX workflows against real project layouts starting from scratch.

Why are my Specflow sandbox tests modifying files in my main repository root?

Specflow sandbox tests should not modify your main repository because the sandbox directory is gitignored at the repository root. If files are changing, verify the bootstrap scripts are correctly isolating the sandbox environment.