rudder-data-path-diagnostician-maintainer

Trace Rudder UI data issues from queries through APIs to source records.

280|30|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Undertone0809/rudder --skill rudder-data-path-diagnostician-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rudder-data-path-diagnostician-maintainer
Source: https://github.com/Undertone0809/rudder/tree/main/.agents/skills/maintainer/rudder-data-path-diagnostician-maintainer
Command: npx skills add https://github.com/Undertone0809/rudder --skill rudder-data-path-diagnostician-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you explain why a Rudder page shows missing, stale, sparse, or incorrect data by tracing the evidence chain from the UI request through APIs, services, and database/derived sources.

Core Features & Use Cases

  • Data lineage diagnosis: Identifies whether the issue is wrong target, empty source, filter/date mismatch, derived-data generation gaps, API contract gaps, UI render gaps, seed/demo gaps, or sync/import gaps.
  • Evidence-first root cause: Produces an evidence-backed explanation instead of guessing based on screenshots, with safe read-only checks by default.
  • Explanation mode: When data is already correct, explains how the current rendering/derivation works (lineage from UI query to route/service/derived projection/state).
  • Org/runtime verification: Ensures you diagnose the correct active runtime and organization scope before inspecting sources or proposing changes.

Quick Start

Ask the maintainer to diagnose which runtime and organization your Rudder Calendar/Dashboard/UI card is querying and what data lineage leads to the observed empty or incorrect result.

Frequently Asked Questions about rudder-data-path-diagnostician-maintainer

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

FAQPage Schema
How do I trace missing Rudder data to its root cause?

Trace missing Rudder data by following the evidence chain from UI queries through API routes, service aggregation, and underlying source or derived records. This diagnostic process classifies the failure boundary and uses read-only verification to produce an evidence-backed root cause.

Why does my Rudder Calendar show empty events or wrong dashboard counts?

Rudder Calendar empty events or wrong dashboard counts stem from failure boundaries like wrong target, empty source, filter-window mismatch, derived-data generation gaps, or sync/import gaps. Diagnosing the active runtime and organization scope identifies the specific failure category.

Can I diagnose Rudder data lineage issues in worktree previews and remote deployments?

Yes, Rudder data lineage diagnosis applies to dev environments, prod-local Desktop, worktree previews, and remote deployments. It verifies the correct active runtime and organization scope before inspecting sources or proposing fixes for empty dashboards or broken chat output.

What is data lineage diagnosis for derived data and API debugging?

Data lineage diagnosis for derived data traces the evidence chain from UI requests through API routes and service aggregation to source records. It explains how current rendering and derivation projections work when data is already correct, mapping the full lineage from UI query to state.

How do I find where specific Rudder UI data comes from?

Find where Rudder UI data comes from by tracing the evidence chain from the UI request through APIs, services, and database or derived sources. This explanation mode maps the full lineage from UI query to route, service, derived projection, and state.