blacksmith-testbox

Run tests, builds, and migrations on a dedicated remote testbox.

9|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/gwenwindflower/dotfiles --skill blacksmith-testbox-gwenwindflower
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blacksmith-testbox
Source: https://github.com/gwenwindflower/dotfiles/tree/main/dot_agents/exact_skills/blacksmith-testbox
Command: npx skills add https://github.com/gwenwindflower/dotfiles --skill blacksmith-testbox-gwenwindflower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates safe, repeatable CI validation by running tests, builds, migrations, or commands that require real CI secrets or services in a dedicated testbox.

Core Features & Use Cases

  • Warmup and provision a CI-ready environment for local validation.
  • Dispatch CI workflows and run repository commands from the repo root to ensure parity with CI.
  • Manage and reuse a testbox session for multiple runs while protecting secrets.

Quick Start

Warm up a testbox with blacksmith testbox warmup ci-testbox.yml, save the ID, then run your tests with blacksmith testbox run --id <ID> "<command>"

Frequently Asked Questions about blacksmith-testbox

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

FAQPage Schema
How do I run tests with CI secrets locally without exposing them?

To run tests with CI secrets locally, you can automate safe, repeatable CI validation by provisioning a dedicated testbox. This isolated environment executes commands requiring real CI secrets or services while protecting them during local validation.

What is the best way to achieve CI environment parity for local builds and migrations?

Achieving CI environment parity involves dispatching CI workflows and running repository commands from the repo root within a warmed-up testbox. This ensures your local builds, migrations, and tests execute under conditions matching your CI.

How do I set up and reuse a testbox session for multiple CI runs?

To set up and reuse a testbox session, warm up the environment using a configuration file, save the generated ID, then execute subsequent commands with that ID. This preserves the session for multiple runs while maintaining secret protection.

Can I sync local code changes to a remote testbox for continuous validation?

Yes, you can sync local code changes to a remote testbox. The process provides delta-sync between local modifications and the testbox, preserving your repo root execution context for accurate, continuous code validation across repositories.

Does blacksmith-testbox require specific dependencies for isolated CI workflows?

No specific dependencies are required to run isolated CI workflows. The Skill operates independently to warm up remote testboxes, dispatch CI workflows, and manage repository commands without needing additional component installations.

When should I use a dedicated testbox instead of running tests directly in my local environment?

Use a dedicated testbox when your code validation workflows require real CI secrets or active external services. It is especially necessary for unit, integration, and deployment checks demanding strict parity with CI environments and secure secret access.