pipeline-debug

Diagnose SOMA pipeline failures and generate prioritized debug reports.

3|3|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/webdevcom01-cell/agent-studio --skill pipeline-debug-webdevcom01-cell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pipeline-debug
Source: https://github.com/webdevcom01-cell/agent-studio/tree/main/skills/pipeline-debug
Command: npx skills add https://github.com/webdevcom01-cell/agent-studio --skill pipeline-debug-webdevcom01-cell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses why the SOMA pipeline (TI → HW → CR → Score Analyzer) failed or degraded. It provides structured multi-dimensional checks, maps evidence to root causes using explicit IF-THEN rules, auto-applies trivial fixes, and delivers a prioritized debug report to accelerate remediation. The approach replaces 5–8 manual MCP calls with a single, cohesive investigation pipeline.

Core Features & Use Cases

  • Structured, rule-based root-cause mapping using explicit IF-THEN tables.
  • Auto-applies trivial fixes when pre-conditions are met, with a log trail.
  • Full diagnostic flow across TI, HW, CR, and Score Analyzer with visibility into execution history.
  • Generates actionable remediation instructions and supports escalation to DEEP analysis when needed.
  • Use cases: when the SOMA pipeline fails, times out, or returns degraded quality, and you need a repeatable, auditable diagnostic.

Quick Start

Describe the pipeline issue and run pipeline-debug to generate a prioritized, actionable diagnostic report.

Frequently Asked Questions about pipeline-debug

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

FAQPage Schema
How do I diagnose SOMA pipeline failures across TI, HW, CR, and Score Analyzer stages?▼

To diagnose SOMA pipeline failures, run a structured multi-dimensional check across TI, HW, CR, and Score Analyzer stages. The pipeline-debug Skill maps execution evidence to root causes using explicit IF-THEN rules and auto-applies trivial fixes, generating a prioritized remediation report.

Why does the SOMA pipeline degrade or time out during execution?▼

SOMA pipeline degradation or timeouts occur due to failures in the TI, HW, CR, or Score Analyzer stages. By running structured diagnostics via as_get_recent_executions and as_find_broken_flows, the root-cause mapping identifies the exact stage failure and provides evidence-based remediation steps.

What is the best way to find root causes for broken SOMA pipeline flows?▼

The best way to find root causes for broken SOMA pipeline flows is using explicit IF-THEN rule-based mapping. This diagnostic approach replaces 5–8 manual MCP calls with a single investigation pipeline, leveraging as_find_broken_flows to classify root causes and auto-apply trivial fixes.

Can I automate fixing trivial SOMA pipeline errors without manual intervention?▼

Yes, you can automate fixing trivial SOMA pipeline errors. When pre-conditions are met, the diagnostic pipeline auto-applies trivial fixes and maintains a log trail, accelerating remediation while still escalating complex issues to a DEEP analysis report.

Does pipeline-debug require specific MCP tools to investigate execution history?▼

Yes, pipeline-debug operates within the MCP ecosystem and requires tools like as_get_recent_executions and as_find_broken_flows. These tools provide the execution history and broken flow visibility needed to produce root-cause classifications and actionable remediation instructions for the SOMA pipeline.

When should I escalate a SOMA pipeline diagnostic to DEEP analysis?▼

You should escalate a SOMA pipeline diagnostic to DEEP analysis when the initial structured multi-dimensional checks identify complex root causes that cannot be resolved by auto-applied trivial fixes, requiring further investigation beyond the standard prioritized debug report.