test-setup

Scaffold engine-aware test directories and GitHub Actions CI workflows.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill test-setup-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-setup
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/test-setup
Command: npx skills add https://github.com/imgamer/AILearn --skill test-setup-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of manually creating and wiring a project’s testing folder structure and CI workflow by generating a consistent, engine-aware test scaffold.

Core Features & Use Cases

  • Engine-aware scaffolding: Detects the configured engine (Godot, Unity, or Unreal) and creates the correct runner and supporting files.
  • Standardized test taxonomy: Sets up tests/unit/, tests/integration/, tests/smoke/, and tests/evidence/ with an engine-agnostic README for how to write and categorize tests.
  • CI/CD wiring: Generates a GitHub Actions workflow so tests run on every push and pull request.
  • Non-destructive updates: Never overwrites existing files; it only creates missing paths, with an optional force mode to rerun the plan without clobbering artifacts.

Quick Start

Run /test-setup after the engine is configured to generate the tests/ structure and the .github/workflows/tests.yml workflow.

Frequently Asked Questions about test-setup

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

FAQPage Schema
How do I scaffold automated testing infrastructure and CI workflows for a game engine project?

To scaffold automated testing infrastructure, this setup creates a standardized tests directory and a GitHub Actions CI workflow. It detects your engine, generates unit, integration, and smoke test folders, and wires CI to execute the appropriate engine test runner.

Does the test scaffold support Godot, Unity, and Unreal engine detection?

Yes, the test scaffold supports Godot, Unity, and Unreal engine detection. It creates the correct engine-aware test runner and supporting files, satisfying engine detection requirements while safely skipping or creating missing artifacts.

What's the best way to organize unit, integration, and smoke tests with a standardized taxonomy?

The best way to organize tests is using a standardized taxonomy that creates tests/unit/, tests/integration/, tests/smoke/, and tests/evidence/ directories. It includes an engine-agnostic README explaining how to write and categorize tests within these paths.

Can I regenerate the GitHub Actions workflow and tests directory without overwriting existing files?

Yes, you can safely regenerate the GitHub Actions workflow because updates are non-destructive. It never overwrites existing files and only creates missing paths, with an optional force mode to rerun the plan without clobbering your current artifacts.

When do I need to run the test setup pass for my game project?

You need to run the test setup pass after your engine is configured. This ensures the scaffolding correctly detects Godot, Unity, or Unreal to generate the proper tests/ structure and the .github/workflows/tests.yml workflow.

Why does the CI workflow not trigger on my newly scaffolded test directories?

The CI workflow triggers on every push and pull request, so if it does not trigger, ensure your tests/ structure and .github/workflows/tests.yml were generated after engine configuration. Missing engine artifacts can cause the setup to skip wiring the test runner.