test-setup

Scaffold engine-specific test infrastructure and GitHub Actions workflows for Godot, Unity, and Unreal projects.

Updated May 13, 2026
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill test-setup-francisvarga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-setup
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/test-setup
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill test-setup-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents game projects from shipping without a reliable automated testing foundation by scaffolding an engine-aware test framework layout and a CI workflow that runs tests on every change.

Core Features & Use Cases

  • Engine detection & validation: Reads the configured engine from .claude/docs/technical-preferences.md and refuses to run until the engine is set.
  • Idempotent scaffolding: Creates only missing directories/files, reports what already exists, and supports a force mode to regenerate planning without overwriting existing paths.
  • CI/CD wiring across engines: Generates a .github/workflows/tests.yml tailored for Godot, Unity, or Unreal, including the right runner assumptions (e.g., Unity license secret or UE self-hosted runner).
  • Test plan and smoke seed: Produces tests/ README documentation, standard unit/integration/smoke/evidence structure, and a smoke/critical-paths.md seed for /smoke-check.

Quick Start

Run /test-setup and confirm the plan approval so the Skill can create the tests/ structure and the .github/workflows/tests.yml workflow for your configured engine.

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/CD for a game engine project?

To set up automated testing and CI/CD for a game engine project, you can scaffold engine-aware test frameworks and a GitHub Actions workflow that runs repeatable unit, integration, and smoke tests on every push.

Does this test scaffolding support Godot, Unity, and Unreal Engine?

Yes, the test scaffolding supports Godot, Unity, and Unreal Engine by generating engine-specific runner configurations and CI/CD workflows tailored to each engine's unique requirements, such as Unity license secrets or Unreal self-hosted runners.

How do I create a GitHub Actions workflow to run game engine unit tests?

Creating a GitHub Actions workflow for game engine unit tests involves generating a tailored tests.yml file that includes the correct runner assumptions and environment setup for your configured engine, triggering tests automatically on every repository push.

Will generating test scaffolding overwrite my existing test files?

Generating test scaffolding will not overwrite existing test files because the process is idempotent, creating only missing directories and files while reporting what already exists, with an optional force mode to regenerate planning without altering current paths.

What do I need to configure before scaffolding engine tests and CI?

Before scaffolding engine tests and CI, you need to configure your target game engine in the technical preferences document, as the scaffolding process reads this configuration and will not run until the engine is explicitly set.

What is the best way to structure smoke tests for a game project?

The best way to structure smoke tests for a game project is to use a standardized directory layout that includes a dedicated smoke testing folder seeded with a critical paths document, ensuring repeatable validation of core gameplay flows.