Source profileQuality 83/100

HKUDS/Vibe-Trading/agent/src/skills/alpha-zoo/SKILL.md

alpha-zoo

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.

Source repository stars
29,558
Declared platforms
0
Static risk flags
0
Last source update
2026-08-04
Source checked
2026-08-04
DecisionCompatibilityInstallWorkflowPermissionsEvidenceSource

Decision brief

What it does—and where it fits

Browse and bench the bundled alpha zoos — prebuilt cross-sectional factor libraries (Kakushadze 101, GTJA 191, Qlib 158, Fama-French / Carhart).

Best for

  • 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 skil…

Not for

  • Filter mismatch on listalphas: theme / universe must match the alpha's declared metadata exactly (e.g. equitycn, not cn or china).
  • Calling alphabench with both alphaid and zoo set — they are mutually exclusive; pick one.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/HKUDS/Vibe-Trading --skill "agent/src/skills/alpha-zoo"
Safe inspection promptEditorial

Inspect the Agent Skill "alpha-zoo" from https://github.com/HKUDS/Vibe-Trading/blob/3a752d5a8ed088633040893de1cc9e6dc712596f/agent/src/skills/alpha-zoo/SKILL.md at commit 3a752d5a8ed088633040893de1cc9e6dc712596f. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    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…

    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 skil…
  2. 02

    Tools Available

    Review the “Tools Available” section in the pinned source before continuing.

    Review and apply the “Tools Available” source section.
  3. 03

    Decision Tree

    "list all momentum alphas" → alphazoo with action=listalphas, theme=momentum.

    "list all momentum alphas" → alphazoo with action=listalphas, theme=momentum."show me gtja191alpha001" → alphazoo with action=getalpha, alphaid=gtja191alpha001."bench all of GTJA 191 on CSI 300 from 2020 to 2024" → alphabench with zoo=gtja191, universe=csi300, period=2020-2024.
  4. 04

    Zoo Inventory

    Counts are nominal; check alphazoo action=health for the live count currently loaded.

    Counts are nominal; check alphazoo action=health for the live count currently loaded.

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score83/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars29,558SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
HKUDS/Vibe-Trading
Skill path
agent/src/skills/alpha-zoo/SKILL.md
Commit
3a752d5a8ed088633040893de1cc9e6dc712596f
License
MIT
Collected
2026-08-04
Default branch
main
View the original SKILL.md

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

ToolWhen to use
alpha_zooBrowse 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_benchRun IC / IR on one alpha or a whole zoo over a universe + period. Emits an HTML report.
factor_analysisAd-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.
  • "is the registry healthy" → alpha_zoo with action=health — surfaces loaded, failed, and per-error reasons.
  • User uploads my_factor.csv → factor_analysis (zoo tools are for prebuilt alphas only).

Zoo Inventory

ZooDescriptionApprox. count
kakushadze101Formulaic alphas from Kakushadze's 2015 paper. Mix of momentum, reversal, volume, and microstructure.~101
gtja191Guotai Junan 191 alphas — A-share focused cross-sectional factors.~191
qlib158Microsoft Qlib's 158 alpha factors — features tuned for ML pipelines.~158
classicalFama-French 3/5-factor + Carhart momentum.<10

Counts are nominal; check alpha_zoo action=health for the live count currently loaded.

Constraints

  • No per-stock per-date factor values are surfaced to the agent. IC results are aggregate stats (mean / std / IR / positive-ratio); the HTML report shows top-N by IR plus formulas, never the underlying panel.
  • Lookahead is banned in the operator set. delta(df, d) requires d >= 1; the negative-shift Ref(df, -n) form does not exist. See docs/alpha-zoo/spec.md for the full operator catalogue.
  • Universe loaders may not be wired for every market yet. When alpha_bench returns universe loader for X not yet implemented, that's the W2 scaffold — the universe is recognised but the data pull lands in W4.
  • Do not expose absolute filesystem paths in agent output. The bench tool writes to ~/.vibe-trading/reports/ by default; refer to it by that shorthand, not by the resolved absolute path.
  • alpha_zoo is read-only. alpha_bench writes a single HTML file per run — no scratch state elsewhere.

Common Pitfalls

  • Filter mismatch on list_alphas: theme / universe must match the alpha's declared metadata exactly (e.g. equity_cn, not cn or china).
  • Calling alpha_bench with both alpha_id and zoo set — they are mutually exclusive; pick one.
  • Empty registry (loaded=0) means no zoo modules are populated yet; treat it as "zoos pending W3 porting" rather than a bug.

Reference

  • Operator catalogue: docs/alpha-zoo/spec.md
  • Registry contract: src/factors/registry.py (frozen; do not modify)
  • IC / layered NAV math: src/factors/factor_analysis_core.py

Alternatives

Compare before choosing

Computed 10042,968

coreyhaines31/marketingskills

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program

2026-07-290 platforms
Computed 10042,968

coreyhaines31/marketingskills

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o

2026-07-290 platforms
Computed 10023,781

alirezarezvani/claude-skills

app-store-optimization

App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklist

2026-07-170 platforms
Computed 10014,225

wanshuiyin/Auto-claude-code-research-in-sleep

citation-audit

Use it for operations and research tasks; the detail page covers purpose, installation, and practical steps.

2026-08-040 platforms