research-data-troubleshooter

Diagnose anomalies, missing values, and convergence failures in research data and simulation outputs.

2|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/BeopsooKim/Research-Bot --skill research-data-troubleshooter-beopsookim
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-data-troubleshooter
Source: https://github.com/BeopsooKim/Research-Bot/tree/main/.agents/skills/research-data-troubleshooter
Command: npx skills add https://github.com/BeopsooKim/Research-Bot --skill research-data-troubleshooter-beopsookim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research data often looks wrong, noisy, incomplete, or non-convergent, and it is hard to tell whether the cause is a measurement artifact, a preprocessing mistake, a model formulation error, or a solver issue. This Skill provides a structured troubleshooting protocol that isolates the failing layer and turns vague suspicions into falsifiable hypotheses with minimal diagnostic tests. ## Core Features & Use Cases - Data-type branching: Applies distinct checklists for raw sensor/field/SCADA data, simulation and algorithmic outputs (including MCMC chains and power-flow results), and hardware/PLC/communication logs. - Layered failure tree: Separates measurement, preprocessing, model/formulation, solver/algorithm, and reporting layers so symptoms are not confused with root causes. - Minimal experiment design: Converts each suspected cause into one testable hypothesis with an expected result and pass/fail criterion, while enforcing integrity rules against unjustified deletion, smoothing, or imputation. - Use Case: A graduate student whose power-flow simulation fails to converge provides the solver settings, initial conditions, and a baseline case; the Skill identifies likely causes such as tolerance settings or unit mismatches and proposes the smallest controlled test to confirm each one. ## Quick Start Ask the assistant to troubleshoot your research data by describing the data source, the observed issue, the preprocessing steps already done, and your current hypothesis, then request likely causes and minimal diagnostic tests.

Frequently Asked Questions about research-data-troubleshooter

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

FAQPage Schema
How do I troubleshoot simulation results that fail to converge?▼

Check initial conditions, boundary conditions, random seeds, solver settings, and tolerances first, then examine convergence diagnostics such as residuals, objective traces, and autocorrelation. Provide a minimal reproducible case plus a baseline with a known expected result to isolate the cause.

How to diagnose anomalies in sensor or field research data?▼

Start by checking missing-value mechanisms, calibration drift, sensor saturation, timestamp errors, and unit consistency. Then determine whether outliers are physical events, sensor faults, or preprocessing artifacts before any deletion or imputation, and record a logged rationale for every decision.

Can this Skill handle MCMC chains and power-flow analysis problems?▼

Yes, simulation and algorithmic outputs are explicitly covered, including MCMC chains and power-flow results. It checks burn-in, effective sample size, multiple chains, sensitivity to initial conditions, and whether output units and sign conventions match the physical model.

Why do hardware or PLC logs show misleading values?▼

Common causes include scan time versus logging rate mismatches, timestamp misalignment, aliasing, communication delays, dropped packets, and logging variables pre-control instead of post-control. A timing diagram with sampling rate, scan time, and actuator delay is needed to diagnose these issues.

When should I not use a data troubleshooting workflow?▼

Do not use it for paper editing, ethics-only dilemmas, or pure literature search, since dedicated skills cover those tasks. It also must never be used to fabricate data, hide anomalies, cherry-pick results, or bypass research-integrity requirements.