test-setup

Scaffold engine-specific test directories and CI workflows for Godot, Unity, or Unreal projects.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill test-setup-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-setup
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/test-setup
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill test-setup-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of missing or inconsistent automated testing and CI/CD for an engine-based project, so teams can’t reliably validate changes or block regressions before merge.

Core Features & Use Cases

  • Engine-aware test infrastructure scaffolding: Detects the configured engine from .claude/docs/technical-preferences.md and only creates the appropriate engine-specific runner artifacts.
  • Standard project layout for confidence gates: Creates tests/ with unit/, integration/, smoke/, and evidence/ to support automated, cross-system, and manual QA evidence workflows.
  • CI/CD wiring for repeatable verification: Generates .github/workflows/tests.yml so tests run on every push/PR and uploads results/artifacts appropriate to the engine.
  • Safe, non-destructive regeneration: Supports a force argument to regenerate when needed while still refusing to overwrite any files that already exist.

Quick Start

Run /test-setup with your project’s engine configured to scaffold tests/ and the CI workflow file.

Frequently Asked Questions about test-setup

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

FAQPage Schema
How do I set up automated testing and CI for my Unity or Godot project?

To set up automated testing and CI for Unity or Godot, you can scaffold engine-specific test directories and a GitHub Actions workflow that runs unit, integration, and smoke tests on every push and pull request. This detects your engine configuration and generates the appropriate runner artifacts.

What's the best way to structure test directories for game engine projects?

The best way to structure test directories for game engine projects is to create a standard layout with unit, integration, smoke, and evidence subdirectories. This supports automated tests, cross-system validation, and manual QA evidence workflows to catch regressions early.

Does this test scaffolding tool work with Unreal Engine?

Yes, this test scaffolding tool works with Unreal Engine, as well as Godot and Unity. It reads your engine configuration to detect the specified engine and only creates the appropriate engine-specific runner artifacts for your project.

How do I generate a GitHub Actions workflow to run tests on push and PR?

To generate a GitHub Actions workflow that runs tests on push and PR, you can use a guided setup that wires a `.github/workflows/tests.yml` file to your repository. This workflow executes your test suites and uploads results or artifacts appropriate to your engine.

Will scaffolding tests overwrite my existing CI files and test runners?

Scaffolding tests will not overwrite your existing CI files and test runners. The setup process detects existing test and CI state, asks for approval before file creation, and only creates missing files, refusing to overwrite existing ones even when using the force argument.

What is the difference between unit, integration, and smoke testing in CI?

The difference between unit, integration, and smoke testing in CI is scope: unit tests validate individual components, integration tests check cross-system functionality, and smoke tests verify critical basic functionality. Scaffolding these directories ensures repeatable verification across all levels.