Home / hkuds / vibe-trading · agent/src/skills/backtest-diagnose/SKILL.md · GitHub

backtest-diagnose skillA

backtest-diagnose is agent-read markdown (skill) from hkuds/vibe-trading: Diagnose failed or underperforming backtests, locate the root cause, and fix the issue.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified before it reaches your agent: the main file against the SHA-256 recorded here, the others against the git hashes of its source commit. The deterministic audit below grades the latest version, and the same checks always give the same file the same grade.

What the file says

# Backtest Diagnosis

## Overview

Use this skill when a user reports that a backtest failed, raised an error, or produced poor results.

## Diagnostic Workflow

1. **Read existing artifacts**: use `read_file` to inspect `artifacts/metrics.csv`, `equity.csv`, and `trades.csv`
2. **Read the code**: use `read_file` to inspect `code/signal_engine.py` and `config.json`
3. **Classify the issue**: determine the root cause using the error taxonomy below
4. **Apply the fix**: use `edit_file` to modify the code, then rerun the backtest
5. **Verify the fix**: use `read_file` to inspect the new `metrics.csv`

## Error Taxonomy

### Runtime Errors (`exit_code != 0`)

| Error Type | Common Cause | Fix |
|---------|---------|---------|
| ImportError | Missing dependency | `bash("pip install xxx")` |
| KeyError | DataFrame column-name mismatch | Check the actual column names in `data_map` |
| IndexError | Empty data or insufficient length | Add length checks |
| TypeError | Incorrect signal type | Ensure the return value is `pd.Series` |

### Logic Bugs (Backtest Succeeds but Results Are Abnormal)
…

Read the whole file at its exact version.

How to install

Latest version
mdr add hkuds/vibe-trading/backtest-diagnose@git:20260819.ae68820
Exact content
mdr add hkuds/vibe-trading/backtest-diagnose@sha256:591c26aaad476e54

Pin to a label to follow the author's releases, or to a sha256 for exact bytes. Either way the resolved hash is written to mdr.lock, and mdr install fetches those bytes again and checks them, so it installs them exactly or fails.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2lcsv7oryll6z2bj.svg)](https://markdownregistry.com/a/art_2lcsv7oryll6z2bj)

2 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260819.ae68820 latest2026-08-19 ae68820 4,981 BA view · diff
git:20260409.27354eb2026-04-09 27354eb 4,264 BA view · diff
git:20260401.34eae372026-04-01 34eae37 4,249 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4981 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hkuds/vibe-trading · 34,089 stars · license MIT · pushed 2026-09-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2lcsv7oryll6z2bj
GET https://markdownregistry.com/api/v1/resolve?ref=hkuds/vibe-trading/backtest-diagnose
GET https://markdownregistry.com/api/v1/blob/591c26aaad476e54ec23df50da39e711cd544e98f3f3c810042e0b42e911be51

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from hkuds/vibe-trading

vibe-trading skill
hkuds/vibe-trading · agent/SKILL.md · Professional finance research toolkit — backtesting (10 engines + benchmark comparison panel), factor analysis, Alpha…
v0.1.15 · audit A · 34,089 stars
adr-hshare skill
hkuds/vibe-trading · agent/src/skills/adr-hshare/SKILL.md · ADR/H-share/A-share cross-listing premium analysis — track pricing gaps between US-listed ADRs, HK-listed H-shares, and…
git:20260409.27354eb · audit A · 34,089 stars
akshare skill
hkuds/vibe-trading · agent/src/skills/akshare/SKILL.md · AKShare financial data aggregator (18k+ stars). Free, no API key. Covers A-shares, US, HK, futures, macro, forex…
git:20260409.27354eb · audit A · 34,089 stars
alpha-zoo skill
hkuds/vibe-trading · agent/src/skills/alpha-zoo/SKILL.md · Browse and bench the bundled alpha zoos — prebuilt cross-sectional factor libraries (Kakushadze 101, GTJA 191, Qlib…
git:20260517.1676eaa · audit A · 34,089 stars
ashare-pre-st-filter skill
hkuds/vibe-trading · agent/src/skills/ashare-pre-st-filter/SKILL.md · A 股 ST/*ST 风险预测框架 — 基于最新中报/三季报或业绩预告/快报,预测下一财年是否会因营收、利润、净资产、分红不达标而被风险警示,并将新浪监管处罚记录作为独立证据面纳入风险等级。仅适用于 A 股,不预测财务造假。
git:20260828.18bd2fc · audit A · 34,089 stars
asset-allocation skill
hkuds/vibe-trading · agent/src/skills/asset-allocation/SKILL.md · Asset allocation theory and optimizer usage — MPT / Black-Litterman / risk budgeting / all-weather strategy, including…
git:20260710.fa5e098 · audit A · 34,089 stars
behavioral-finance skill
hkuds/vibe-trading · agent/src/skills/behavioral-finance/SKILL.md · Behavioral finance applications: theories of overreaction and underreaction, behavioral explanations for momentum and…
git:20260409.27354eb · audit A · 34,089 stars
bottleneck-hunter skill
hkuds/vibe-trading · agent/src/skills/bottleneck-hunter/SKILL.md · Supply-chain bottleneck arbitrage. Given a super-trend (AI infra, energy transition, defense, semiconductor reshoring…
git:20260706.6c09d25 · audit A · 34,089 stars
candlestick skill
hkuds/vibe-trading · agent/src/skills/candlestick/SKILL.md · Candlestick pattern recognition engine, pure pandas vectorized implementation of 15 classic candlestick patterns (5…
git:20260409.27354eb · audit A · 34,089 stars
ccxt skill
hkuds/vibe-trading · agent/src/skills/ccxt/SKILL.md · CCXT unified crypto exchange library (100+ exchanges). Free public market data. Fallback when OKX is unavailable.
git:20260409.27354eb · audit A · 34,089 stars
chanlun skill
hkuds/vibe-trading · agent/src/skills/chanlun/SKILL.md · 基于缠论(缠中说禅)的形态识别引擎,使用czsc库自动检测K线分型、笔、中枢,并生成一买/一卖/二买/二卖/三买/三卖等买卖点信号。支持多周期分析和形态分类(3/5/7/9/11笔形态)。
git:20260829.1af4019 · audit A · 34,089 stars
commodity-analysis skill
hkuds/vibe-trading · agent/src/skills/commodity-analysis/SKILL.md · Commodity analysis (oil supply-demand balance / gold pricing / copper as an economic predictor / inventory cycles /…
git:20260409.27354eb · audit A · 34,089 stars

Every file in hkuds/vibe-trading

Browse by kind, by grade A, or by owner.