backtest-diagnose

Diagnose failed backtests by inspecting code, config, and artifacts.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ebrahim-sani/trading-automation --skill backtest-diagnose-ebrahim-sani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backtest-diagnose
Source: https://github.com/ebrahim-sani/trading-automation/tree/main/vibe-trading/agent/src/skills/backtest-diagnose
Command: npx skills add https://github.com/ebrahim-sani/trading-automation --skill backtest-diagnose-ebrahim-sani

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose failed or underperforming backtests and identify the root cause.

Core Features & Use Cases

  • Read artifacts from artifacts/ (metrics.csv, equity.csv, trades.csv) to form a diagnostic baseline.
  • Inspect code files like code/signal_engine.py and config.json to identify mismatches or logic issues.
  • Apply targeted fixes and re-run the backtest to verify improvements and ensure stability.

Quick Start

Run the backtest diagnosis workflow on a failing or underperforming backtest to quickly identify the root cause and implement fixes.

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 Python trading backtest?

To diagnose a failing Python trading backtest, inspect artifacts like metrics.csv and equity.csv to form a baseline, review code files such as signal_engine.py for logic issues, and analyze config.json for parameter mismatches.

Why does my backtest underperform compared to expected trading metrics?

Backtest underperformance often stems from logic mismatches in code/signal_engine.py or incorrect settings in config.json. Reading trade artifacts like trades.csv helps identify the root cause by comparing expected and actual signal generation behavior.

What is the best way to fix a broken backtest after finding the root cause?

The best way to fix a broken backtest is to apply targeted code or configuration adjustments after diagnosis, then rerun the backtest to verify improvements by inspecting updated metrics and equity data for stability.

Can I use backtest diagnosis tools to inspect config.json and signal engines?

Yes, backtest diagnosis involves inspecting config.json and Python signal engine files to identify mismatches or logic issues, reading output artifacts to establish a diagnostic baseline, and verifying fixes through reruns.

How do I verify a backtest fix after modifying trading logic?

To verify a backtest fix, rerun the backtest after applying changes and inspect the updated metrics.csv and equity.csv artifacts to ensure the trading logic improvements are stable and resolve the original issue.

What artifacts do I need to read to troubleshoot an underperforming backtest?

Troubleshooting an underperforming backtest requires reading artifacts from the artifacts directory, specifically metrics.csv, equity.csv, and trades.csv, to establish a diagnostic baseline before inspecting source code.