debug-pipeline

Diagnose Harness pipeline executions and generate structured failure analysis via MCP.

80|16|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/harness/harness-skills --skill debug-pipeline-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-pipeline
Source: https://github.com/harness/harness-skills/tree/main/skills/debug-pipeline
Command: npx skills add https://github.com/harness/harness-skills --skill debug-pipeline-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose Harness pipeline executions via MCP to produce structured, actionable reports detailing stage/step breakdowns, timing, bottlenecks, and failure details.

Core Features & Use Cases

  • Integrated diagnosis: Use harness_diagnose to fetch structured reports for a given pipeline or execution.
  • Deep dive mode: Request logs, YAML, and raw payloads for comprehensive analysis.
  • Context-aware health overview: Get project health data to spot trends and failures.

Quick Start

Provide an execution_id or pipeline_id to initiate a diagnostic scan and receive a formatted report.

Frequently Asked Questions about debug-pipeline

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

FAQPage Schema
How do I diagnose a failed Harness pipeline execution?

To diagnose a failed Harness pipeline execution, you provide an execution_id or pipeline_id to generate a structured report identifying bottlenecks, errors, and logs. This diagnostic scan applies to failed, successful, or in-progress runs.

What is included in a Harness pipeline diagnostic report?

A Harness pipeline diagnostic report includes stage and step breakdowns, execution timing, bottlenecks, and detailed failure information. You can also request logs, YAML definitions, and raw payloads for a comprehensive deep dive analysis.

How do I get pipeline execution logs using MCP?

You get pipeline execution logs by requesting a deep dive diagnosis through the harness_diagnose MCP tool. This fetches execution data, logs, and pipeline definitions to provide a comprehensive analysis of your pipeline run.

Do I need Harness MCP v2 to analyze pipeline failures?

Yes, you need Harness MCP v2 and the harness_diagnose tool to run the pipeline execution analysis. These dependencies are required to fetch the execution data, logs, and pipeline definitions needed for the diagnostic report.

Can I diagnose a pipeline that is currently in progress?

Yes, you can diagnose a pipeline that is currently in progress. The diagnostic scan applies to any Harness pipeline run, including failed, successful, or in-progress executions, to identify bottlenecks and errors.

What's the best way to spot trends in project pipeline failures?

The best way to spot trends in project pipeline failures is to use the context-aware health overview. This feature fetches project health data to help you identify recurring failures and trends across your Harness pipelines.