diagnose

Diagnose broken Soria data pipelines by tracing schemas and row counts.

1|1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/Soria-Inc/soria-stack --skill diagnose-soria-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/Soria-Inc/soria-stack/tree/main/diagnose
Command: npx skills add https://github.com/Soria-Inc/soria-stack --skill diagnose-soria-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rapidly identify root causes for pipelines that report success but produce missing, incorrect, or slow data and for dives that fail to load; emphasize observation-first triage to avoid premature hypotheses.

Core Features & Use Cases

  • Triage-first investigation: Classify incidents into Silent Failure, Data Trace, Schema Mismatch, Infrastructure, or Quality and follow a disciplined checklist before proposing fixes.
  • Layered data tracing: Verify schemas and trace row counts and values across Postgres state, bronze, silver, gold, and marts to pinpoint where data diverges.
  • Actionable disposition: Attempt inline fixes (env switch, dbt run, manifest update, re-extract) or escalate by invoking the ticket workflow and produce a timestamped diagnostic artifact.

Quick Start

Describe the failure, include recent soria env status and any CLI output, and ask the skill to triage and propose next steps.

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I debug a data pipeline that reports success but has missing or incorrect data?

Debug silent data pipeline failures by classifying the incident and tracing row counts across bronze, silver, gold, and mart layers to pinpoint where data diverges. This observation-first triage identifies the root cause before attempting inline fixes or escalating backend issues.

What is the best way to trace dbt schema mismatches in a data warehouse?

Trace dbt schema mismatches by performing schema discovery via information_schema queries to verify structures. Inspecting soria CLI outputs and tracing data across layers isolates whether the mismatch originates from extraction, transformation, or warehouse publishing.

How do I triage a failed dbt mart or broken scraper pipeline?

Triage broken dbt marts and scraper pipelines by classifying the failure into Silent Failure, Data Trace, Schema Mismatch, or Infrastructure categories. Following a disciplined checklist, inspect CLI outputs and trace row counts to determine the exact failure point.

Can I fix infrastructure or pipeline issues inline, or do I need to create a ticket?

You can apply inline fixes for pipeline issues like env switches, dbt runs, manifest updates, or re-extraction attempts. If the issue is backend infrastructure, the triage process routes the problem by invoking the ticket workflow and producing a diagnostic artifact.

Why does my dive manifest fail to load when the CLI command returns success?

Dive manifest load failures during successful CLI runs often indicate silent data failures or schema mismatches upstream. Investigate by verifying schemas, tracing data across pipeline layers, and inspecting CLI outputs to find where the data becomes absent or inconsistent.