cvm-troubleshooter

Diagnose CVM pipeline failures and propose minimal reruns from diagnostics.

3|1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/KiselevAleksey/cvm --skill cvm-troubleshooter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cvm-troubleshooter
Source: https://github.com/KiselevAleksey/cvm/tree/main/skills/cvm-troubleshooter
Command: npx skills add https://github.com/KiselevAleksey/cvm --skill cvm-troubleshooter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires duckdb, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Diagnose and unblock CVM pipeline failures quickly. Use when ingest, dbt, train, score, e2e, or drift commands fail; when outputs are missing; or when reason quality/feature availability issues appear.

Core Features & Use Cases

  • Collect diagnostics first, then propose the smallest rerun.
  • Classify failures by stage: Ingestion (missing raw_*.csv), Prepare-data (dbt errors), Train (target/mart issues), Score (empty queues or quality gates).
  • Propose exact fix and rerun command with minimal impact.
  • Return a concise incident report with root cause, fix, and verification output path.

Quick Start

Run the diagnostics script to collect a failure report and apply the minimal rerun.

Frequently Asked Questions about cvm-troubleshooter

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

FAQPage Schema
How do I troubleshoot CVM pipeline failures when ingestion or dbt prepare-data commands fail?

To troubleshoot CVM pipeline failures, run the diagnostics script to collect a failure report, which classifies issues by stage such as missing raw CSVs for ingestion or dbt errors for prepare-data, and then applies a minimal rerun command.

Why does my CVM data pipeline training or scoring stage fail with missing outputs?

CVM pipeline training or scoring failures with missing outputs often stem from target mart issues or empty queues and quality gates. Collecting diagnostics identifies the precise root cause and verifies the output path after applying a minimal rerun.

Can I use DuckDB to diagnose data pipeline incidents across local and CI environments?

Yes, you can diagnose data pipeline incidents across local and CI environments using DuckDB dependencies. The process collects diagnostics from ingestion, e2e, and drift stages, returning a concise incident report with the root cause and verification path.

What is the best way to unblock a failed CVM pipeline without rerunning the entire workflow?

The best way to unblock a failed CVM pipeline is to collect diagnostics first, classify the failure by stage, and then propose the smallest rerun command with minimal impact. This returns an incident report detailing the exact fix and verification output path.

Does the CVM pipeline diagnostics process handle drift and reason quality issues?

Yes, the CVM pipeline diagnostics process handles drift and reason quality or feature availability issues. It collects failure reports and applies minimal reruns to resolve these specific stage failures and verify the resulting outputs.

When should I not use a minimal rerun approach for data pipeline troubleshooting?

You should not use a minimal rerun approach when a full end-to-end workflow failure occurs that cannot be isolated to a single stage like ingestion, prepare-data, training, scoring, e2e, or drift, as the diagnostics report requires a specific stage classification.