backtest-diagnose

Diagnose failed backtests by analyzing artifacts, code, and configurations.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/GGwujun/SigmX --skill backtest-diagnose-ggwujun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backtest-diagnose
Source: https://github.com/GGwujun/SigmX/tree/main/agent/src/skills/backtest-diagnose
Command: npx skills add https://github.com/GGwujun/SigmX --skill backtest-diagnose-ggwujun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses failed or underperforming backtests, locates root causes, and provides actionable fixes to improve reliability and results.

Core Features & Use Cases

  • Read existing artifacts like artifacts/metrics.csv, equity.csv, and trades.csv to assess backtest health.
  • Read the codebase (e.g., code/signal_engine.py and config.json) to identify faulty logic or misconfigurations.
  • Classify issues using a predefined error taxonomy and guide remediation steps.
  • Apply fixes by editing the relevant source files and re-running the backtest to verify improvements.
  • Verify the fix by inspecting updated metrics to ensure stability and correctness.

Quick Start

Run the backtest diagnose workflow on your project to identify the root cause of a failure and apply a fix.

Frequently Asked Questions about backtest-diagnose

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

FAQPage Schema
How do I diagnose a failing trading backtest and find the root cause?

Diagnose a failing backtest by analyzing artifacts like metrics.csv, equity.csv, and trades.csv alongside signal_engine.py and config.json to identify root causes. The workflow reads these files to classify issues using a defined taxonomy and guide targeted fixes.

What is the best way to debug an underperforming backtest configuration?

Debug an underperforming backtest by inspecting config.json for misconfigurations and signal_engine.py for faulty logic. Reading artifacts like equity.csv helps assess backtest health, enabling you to classify issues and apply remediation steps to the source files.

Why does my backtest fail and how do I fix the signal engine logic?

Backtest failures often stem from faulty logic in signal_engine.py or errors in config.json. By reading artifacts such as trades.csv and metrics.csv, you can classify the issue using a predefined error taxonomy, apply fixes to the code, and re-run the backtest to verify.

Do I need specific artifacts to reproduce and fix a backtest failure?

Yes, reproducing and fixing a backtest failure requires access to artifacts/metrics.csv, artifacts/equity.csv, trades.csv, code/signal_engine.py, and config.json. You also need the ability to edit these files and re-run the backtest to verify improvements.

How do I verify a backtest fix after editing the source files?

Verify a backtest fix by re-running the backtest after editing source files, then inspecting updated metrics to ensure stability and correctness. This confirms that the applied fixes resolved the classified issues and improved the backtest results.

What types of issues can I identify using a backtest error taxonomy?

Using a predefined error taxonomy, you can classify issues in backtest configurations and code to identify misconfigurations in config.json or faulty logic in signal_engine.py. This structured classification guides the remediation steps needed to fix the backtest.