run-helix-tests

Automate submission and monitoring of MAUI unit tests on Helix queues across Windows and macOS platforms.

23.3k|2.0k|Updated May 8, 2020
One-click install
npx skills add https://github.com/dotnet/maui --skill run-helix-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-helix-tests
Source: https://github.com/dotnet/maui/tree/main/.github/skills/run-helix-tests
Command: npx skills add https://github.com/dotnet/maui --skill run-helix-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the submission and monitoring of .NET MAUI unit tests on Helix infrastructure from your local environment, reducing manual setup and follow-up work across multiple test queues.

Core Features & Use Cases

  • Submit tests to Helix: Push MAUI unit test projects to distributed Helix queues for parallel execution.
  • Monitor tests and retrieve results: Track job progress and fetch logs to speed up debugging.
  • Use Case: A developer wants to validate changes to MAUI's XAML or core libraries across Windows and macOS queues without performing local, repetitive test runs.

Quick Start

  1. Ensure the .NET SDK is installed and the dotnet cake tool is available as described in prerequisites.
  2. Submit tests: pwsh .github/skills/run-helix-tests/scripts/Submit-HelixTests.ps1
  3. Monitor a job: pwsh .github/skills/run-helix-tests/scripts/Get-HelixJobStatus.ps1 -JobId <JOB_ID> -Wait
  4. Review logs for failures: pwsh .github/skills/run-helix-tests/scripts/Get-HelixWorkItemLog.ps1 -JobId <JOB_ID> -FailedOnly

Frequently Asked Questions about run-helix-tests

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

FAQPage Schema
How do I automate submitting .NET MAUI unit tests to Helix queues?

You can automate submitting .NET MAUI unit tests to Helix queues by running the Submit-HelixTests.ps1 PowerShell script, which pushes test projects to distributed queues for parallel execution across Windows and macOS platforms.

What do I need to run MAUI tests on Helix from my local environment?

Running MAUI tests on Helix locally requires PowerShell 7+ and a provisioned .NET SDK with the dotnet cake tool installed to drive the submission and monitoring scripts.

Can I monitor Helix job progress and retrieve logs for failed MAUI tests?

You can monitor Helix job progress and retrieve failure logs by running Get-HelixJobStatus.ps1 with the -Wait parameter, then using Get-HelixWorkItemLog.ps1 with the -FailedOnly flag to fetch specific failure logs.

Does the Helix test submission Skill support parallel execution across Windows and macOS?

The Helix test submission Skill supports parallel execution across Windows and macOS queues, allowing you to validate .NET MAUI unit tests on multiple platforms simultaneously without performing local repetitive test runs.

What is the best way to debug failed MAUI unit tests on Helix infrastructure?

To debug failed MAUI unit tests on Helix, use the Get-HelixWorkItemLog.ps1 script with the -FailedOnly parameter to fetch specific logs for failed work items, speeding up the debugging process.