gaia-test-run

Automate test execution and classify infrastructure flakes by tag, story, or file.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-framework --skill gaia-test-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-test-run
Source: https://github.com/gaiastudio-ai/gaia-framework/tree/main/plugins/gaia/skills/gaia-test-run
Command: npx skills add https://github.com/gaiastudio-ai/gaia-framework --skill gaia-test-run

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, grep, glob, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the execution of tests in any environment, providing detailed verdicts and classification of infrastructure flakes.

Core Features & Use Cases

  • Test Execution Automation: Execute tests against the configured environment for a specific tier.
  • Targeting Options: Supports targeting by tag, story, or file.
  • Infrastructure Flake Classification: Classifies infrastructure flakes and emits a structured verdict.
  • Use Case: Ideal for continuous integration and deployment pipelines, where automated test execution and infrastructure flake detection are crucial.

Quick Start

Run the gaia-test-run skill with the desired tier, tag, story, or file. For example: /gaia-test-run --tier 1 --tag "unit" --file "test_unit.py"

Frequently Asked Questions about gaia-test-run

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

FAQPage Schema
How do I automate test execution and classify infrastructure flakes in a CI pipeline?

To automate test execution and classify infrastructure flakes in a CI pipeline, use a runner that executes targeted tests and emits structured verdicts. This provides detailed pass/fail classification for your continuous integration environment.

How do I run a specific subset of automated tests by tag, story, or file?

Run a specific subset of automated tests by targeting them with tag, story, or file parameters. This filters the test execution to only the specified criteria, streamlining the validation process for your configured environment.

Do I need bash, grep, and glob to run automated test execution workflows?

Yes, bash, grep, and glob tools are required to run these automated test execution workflows. These dependencies enable the test runner to operate, locate files, and execute commands across any environment.

What is an infrastructure flake classification in test automation?

An infrastructure flake classification in test automation is a structured verdict distinguishing legitimate test failures from environment instability. It identifies whether a test failed due to code issues or continuous integration infrastructure problems.

What is the best way to execute tests across different deployment tiers?

The best way to execute tests across different deployment tiers is using a test runner with tier-specific targeting. This automates test execution against a configured environment for a specific tier, ensuring accurate validation.

Why are detailed verdicts important for continuous integration test execution?

Detailed verdicts are important for continuous integration test execution because they provide structured pass/fail outcomes and infrastructure flake classification. This enables automated deployment pipelines to accurately determine if a build should proceed.