helix-investigation

Diagnose Helix test failures by collecting AzDO timelines, job data, and console logs.

13|20|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/dotnet/arcade-skills --skill helix-investigation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: helix-investigation
Source: https://github.com/dotnet/arcade-skills/tree/main/plugins/dotnet-dnceng/skills/helix-investigation
Command: npx skills add https://github.com/dotnet/arcade-skills --skill helix-investigation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helix test investigations often require piecing together AzDO timelines, Helix job data, and raw console logs to identify why a pipeline fails. This skill provides a structured approach to collect these signals and surface root-cause patterns for faster remediation.

Core Features & Use Cases

  • Enumerates Helix work items for a given job to surface test groups, machine names, and exit codes.
  • Downloads console logs and test results to enable side-by-side failure analysis across multiple runs.
  • Distills findings into actionable root-cause categories (machine-specific, device/infrastructure, or systemic) with recommended next steps.
  • Use Case: identify whether a failing test is tied to a specific machine, queue, or Helix configuration, and guide issue filing.

Quick Start

Provide an AzDO build URL and the corresponding Helix job to begin collecting logs and generating root-cause insights.

Frequently Asked Questions about helix-investigation

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

FAQPage Schema
How do I diagnose Helix test failures in Azure DevOps pipelines?

Diagnose Helix test failures by collecting AzDO timelines, Helix job data, and raw console logs to compare failing versus passing runs and surface root-cause patterns for faster remediation.

What is the best way to find root causes for Helix pipeline failures across Apple, Android, and Windows queues?

Finding root causes for Helix pipeline failures involves enumerating Helix work items to surface machine names and exit codes, then categorizing issues as machine-specific, infrastructure-related, or systemic.

Do I need AzDO access and Helix MCP tools to investigate Helix job data?

Yes, investigating Helix job data requires AzDO access, Helix MCP tools, and curl to fetch raw console logs and test results necessary for root-cause analysis.

How do I categorize Helix test failures as machine-specific or systemic?

Categorize Helix test failures by comparing failing versus passing runs to identify patterns, then distill findings into actionable root-cause categories with recommended next steps for issue filing.

Why does my Helix test fail on a specific machine or queue configuration?

Helix tests may fail on specific machines or queues due to device or infrastructure issues; enumerating work items and analyzing exit codes helps determine if the failure is tied to a particular machine or systemic.