Home / hkuds / vibe-trading · agent/src/skills/alpha-zoo/SKILL.md · GitHub

alpha-zoo skillA

alpha-zoo is agent-read markdown (skill) from hkuds/vibe-trading: Browse and bench the bundled alpha zoos — prebuilt cross-sectional factor libraries (Kakushadze 101, GTJA 191, Qlib 158, Fama-French / Carhart). Use when the user asks "which alphas exist", wants metadata on a named alpha, or wants to run IC/IR on a whole zoo over a universe..

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

# Alpha Zoo

## Purpose

When the user asks about prebuilt cross-sectional alphas — Kakushadze 101, GTJA 191, Qlib 158, Fama-French / Carhart — or wants to bench a whole zoo on an investable universe (CSI 300, S&P 500, BTC-USDT, ...), this skill orients you. The zoo is the curated library; the bench is the evaluator.

## Tools Available

| Tool | When to use |
|------|------|
| `alpha_zoo` | Browse the library. `action=list_alphas` to enumerate (filterable by zoo / theme / universe), `action=get_alpha` for one alpha's metadata, `action=health` for registry load status. |
| `alpha_bench` | Run IC / IR on one alpha or a whole zoo over a universe + period. Emits an HTML report. |
| `factor_analysis` | Ad-hoc factor evaluation from a user-supplied factor CSV + return CSV. Use this when the user has their own factor (not in the zoo). |

## Decision Tree

- "list all momentum alphas" → `alpha_zoo` with `action=list_alphas, theme=momentum`.
- "show me gtja191_alpha_001" → `alpha_zoo` with `action=get_alpha, alpha_id=gtja191_alpha_001`.
- "bench all of GTJA 191 on CSI 300 from 2020 to 2024" → `alpha_bench` with `zoo=gtja191, universe=csi300, period=2020-2024`.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add hkuds/vibe-trading/alpha-zoo@git:20260517.1676eaa
Exact content
mdr add hkuds/vibe-trading/alpha-zoo@sha256:38a2168fe94d8516

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_thkq3n2wqmxrlar3.svg)](https://markdownregistry.com/a/art_thkq3n2wqmxrlar3)

2 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260517.1676eaa latest2026-05-17 1676eaa 3,827 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 (3827 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_thkq3n2wqmxrlar3
GET https://markdownregistry.com/api/v1/resolve?ref=hkuds/vibe-trading/alpha-zoo
GET https://markdownregistry.com/api/v1/blob/38a2168fe94d8516a56224738d038ae23fbc209abdcbc143dfedf8aa092aaa2d

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
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
backtest-diagnose skill
hkuds/vibe-trading · agent/src/skills/backtest-diagnose/SKILL.md · Diagnose failed or underperforming backtests, locate the root cause, and fix the issue
git:20260819.ae68820 · 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.