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.