Agent skill

Alpha Monitor

by VernonOY in VernonOY/alpha-skills

Factor monitoring. An agent skill from VernonOY/alpha-skills.

Apache-2.0Auto-check passedBusiness, Finance & HR

Install Alpha Monitor

skills CLI
$ npx skills add VernonOY/alpha-skills --skill alpha-monitor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install VernonOY/alpha-skills alpha-monitor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/VernonOY/alpha-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/alpha-monitor .claude/skills/alpha-monitor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
alpha-monitor
GitHub stars
117
Token cost
~1.7k tokens
SKILL.md length
358 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

Factor monitoring. An agent skill from VernonOY/alpha-skills.

  • Works in 7 steps: 读取因子库 / Read Factor Library → 加载近期数据 / Load Recent Data → 对每个活跃因子计算健康指标 / Compute Health Metrics… → …
  • Tasks that involve Trading and backtesting
  • SKILL.md covers Bilingual Terms / 双语术语, 项目定位 / Project Context, 执行流程 / Execution Pipeline and 注意事项 / Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Alpha Monitor is an agent skill from VernonOY/alpha-skills. Factor monitoring. Check active factors for IC decay and health issues. 因子监控。检查活跃因子的IC衰减和健康状态。 Triggers: "health check", "monitor", "检查因子健康", "因子状态"

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Trading and backtesting. The repository describes itself as: Quantitative factor research skills for AI coding assistants. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Trading and backtesting

Example prompts

  • “health check”
  • “monitor”
  • “检查因子健康”
  • “/alpha-monitor”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 读取因子库 / Read Factor Library
  2. 加载近期数据 / Load Recent Data
  3. 对每个活跃因子计算健康指标 / Compute Health Metrics for Each Active Factor
  4. 健康状态判定 / Health Status Determination
  5. 对WARNING/ALERT因子生成诊断 / Generate Diagnosis for WARNING/ALERT Factors
  6. 输出报告 / Output Report
  7. 更新注册表状态 / Update Registry Status

What it can do on your machine

Read from SKILL.md and the folder at commit f58f80a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Alpha Monitor loads about 1.7k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 358 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from VernonOY/alpha-skills at commit f58f80a, republished under its Apache-2.0 licence (© VernonOY). 358 words, ~1,745 tokens.

Download SKILL.mdSave it as .claude/skills/alpha-monitor/SKILL.md (or your agent's skills folder).
name
alpha-monitor
description
Factor monitoring. Check active factors for IC decay and health issues. 因子监控。检查活跃因子的IC衰减和健康状态。 Triggers: "health check", "monitor", "检查因子健康", "因子状态"

alpha-monitor — Factor Health Monitoring / 因子健康监控

你是一个因子监控系统。检查因子库中所有活跃因子的当前健康状态。 You are a factor monitoring system. Check health status of all active factors in the library.

Bilingual Terms / 双语术语

English中文
Factor因子
IC (Information Coefficient)信息系数
ICIR (IC Information Ratio)IC信息比率
Quintile五分位/分组
Long-Short多空
Sharpe Ratio夏普比率
Max Drawdown最大回撤
Monotonicity单调性
Robustness鲁棒性
Holding Period持有期
Factor Registry因子注册表
Backtest回测
Gate Check门控检查

项目定位 / Project Context

Multi-Market Support / 多市场支持:

Alpha Skills support A-share (default), HK, and US stocks via data adapters: Alpha Skills 通过数据适配器支持A股(默认)、港股和美股:

markdown
# .claude/alpha-agent.config.md
MARKET: A-share           # or "HK" or "US"
DATA_MODULE: (leave empty for A-share Tushare default)
                          # or "examples.us_data_yfinance"
                          # or "examples.hk_data_yfinance"

When a custom DATA_MODULE is set, the skill loads MARKET_CONFIG from that module to determine benchmark, cost rate, and trading rules. 设置自定义DATA_MODULE时,skill从该模块加载MARKET_CONFIG来确定基准、成本和交易规则。

Language Rule / 语言规则:

  • If the user speaks English, output in English
  • If the user speaks Chinese, output in Chinese
  • Table headers always show both languages: "IC Mean IC均值"

执行流程 / Execution Pipeline

Step 1: 读取因子库 / Read Factor Library
python
import sys, os, sqlite3, json, uuid
from datetime import datetime

PROJECT_DIR = '<当前工作目录 current working directory>'

# ── 因子注册表(自包含,无外部依赖)/ Factor Registry (self-contained, no external deps) ──

class FactorRegistry:
    def __init__(self, db_path="alpha_skills.db"):
        self.db_path = db_path
        with sqlite3.connect(db_path) as conn:
            conn.execute("""CREATE TABLE IF NOT EXISTS factors (
                id TEXT PRIMARY KEY, name TEXT UNIQUE NOT NULL,
                expression TEXT NOT NULL, category TEXT, description TEXT,
                status TEXT DEFAULT 'active', market TEXT DEFAULT 'A-share',
                ic_mean REAL, icir REAL, best_holding_period INTEGER,
                quality TEXT, eval_date TEXT,
                created_at TEXT DEFAULT CURRENT_TIMESTAMP, metadata TEXT)""")
    
    def register(self, name, expression, **kwargs):
        fid = str(uuid.uuid4())[:8]
        with sqlite3.connect(self.db_path) as conn:
            conn.execute(
                "INSERT OR REPLACE INTO factors (id,name,expression,category,description,status,market,ic_mean,icir,best_holding_period,quality,eval_date,metadata) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)",
                (fid, name, expression, kwargs.get("category",""), kwargs.get("description",""),
                 "active", kwargs.get("market","A-share"), kwargs.get("ic_mean"), kwargs.get("icir"),
                 kwargs.get("best_holding_period"), kwargs.get("quality"),
                 datetime.now().isoformat(), json.dumps(kwargs.get("metadata",{}))))
        return fid
    
    def list_all(self, status=None):
        with sqlite3.connect(self.db_path) as conn:
            conn.row_factory = sqlite3.Row
            if status:
                rows = conn.execute("SELECT * FROM factors WHERE status=? ORDER BY icir DESC", (status,)).fetchall()
            else:
                rows = conn.execute("SELECT * FROM factors ORDER BY icir DESC").fetchall()
            return [dict(r) for r in rows]
    
    def get(self, name):
        with sqlite3.connect(self.db_path) as conn:
            conn.row_factory = sqlite3.Row
            row = conn.execute("SELECT * FROM factors WHERE name=?", (name,)).fetchone()
            return dict(row) if row else None
    
    def update_status(self, name, status):
        with sqlite3.connect(self.db_path) as conn:
            conn.execute("UPDATE factors SET status=? WHERE name=?", (status, name))
    
    def delete(self, name):
        with sqlite3.connect(self.db_path) as conn:
            conn.execute("DELETE FROM factors WHERE name=?", (name,))

reg = FactorRegistry(os.path.join(PROJECT_DIR, "alpha_skills.db"))
active_factors = reg.list_all(status='active')

如果因子库为空,提示用户先注册因子。 If library is empty, prompt user to register factors first.

Step 2: 加载近期数据 / Load Recent Data

加载最近1年的数据用于计算滚动指标(同alpha-evaluate的数据加载流程)。 Load last 1 year of data for rolling metrics (same as alpha-evaluate data loading pipeline).

Step 3: 对每个活跃因子计算健康指标 / Compute Health Metrics for Each Active Factor

对每个因子 / For each factor:

  1. 重新计算因子值 Recompute factor values(使用注册时的expression/函数调用 using registered expression/function call)
  2. 计算近60日滚动IC均值 Compute 60-day rolling IC mean
  3. 计算近60日滚动ICIR Compute 60-day rolling ICIR
  4. 与注册时的ICIR对比,计算衰减比例 Compare with registered ICIR, compute decay ratio
  5. 计算近3个月IC>0的占比 Compute IC>0 ratio for last 3 months
  6. 判定健康状态 Determine health status
Show full SKILL.md (123 more words)Show less
Step 4: 健康状态判定 / Health Status Determination
🟢 HEALTHY: Rolling ICIR 滚动ICIR ≥ Registered ICIR 注册ICIR × 50%
🟡 WARNING: Rolling ICIR 滚动ICIR < Registered ICIR 注册ICIR × 50% or 或 2 consecutive months IC negative 连续2月IC为负
🔴 ALERT:   Rolling ICIR 滚动ICIR < 0 or 或 4 consecutive months IC negative 连续4月IC为负 or 或 quintile monotonicity collapse 分组单调性崩溃
Step 5: 对WARNING/ALERT因子生成诊断 / Generate Diagnosis for WARNING/ALERT Factors

分析可能的原因 Analyze possible causes:

  • 市场环境变化 Market regime change(趋势→震荡 trending→range-bound,或反之 or vice versa)
  • 因子拥挤 Factor crowding(与主流指数相关性升高 increased correlation with major indices)
  • 数据问题 Data issues(缺失率升高 higher missing rate)
  • 季节性效应 Seasonal effects

给出建议 Provide suggestions:

  • 🟡 WARNING: "Reduce weight, continue monitoring / 降低权重,继续观察"
  • 🔴 ALERT: "Suspend usage, consider retiring or finding replacement / 暂停使用,考虑退役或寻找替代"
Step 6: 输出报告 / Output Report
🏥 Factor Health Report / 因子健康报告 (YYYY-MM-DD)

🟢 pv_diverge      Rolling ICIR 滚动ICIR=0.62 (Registered 注册 0.70)  Healthy 健康
🟢 turnover_20     Rolling ICIR 滚动ICIR=0.48 (Registered 注册 0.52)  Healthy 健康
🟡 volatility_20   Rolling ICIR 滚动ICIR=0.19 (Registered 注册 0.43)  ← Decay 衰减 56%
   Diagnosis 诊断: <cause analysis 原因分析>
   Suggestion 建议: Reduce weight, observe 1 month / 降低权重,观察1个月

Summary 总览: N🟢 N🟡 N🔴 / Total 共 N active factors 个活跃因子
Step 7: 更新注册表状态 / Update Registry Status
python
reg.update_status("factor_name", "warning")  # or 或 "alert"

注意事项 / Notes

  1. 如果因子库只有少量因子,监控仍然运行(哪怕只有1个)/ Monitoring still runs even with just 1 factor
  2. 滚动窗口60日,不够60日时用全部可用数据 / Rolling window 60 days, use all available data if less than 60 days
  3. 诊断信息由AI推理生成,基于市场环境和因子特性 / Diagnosis is AI-generated based on market environment and factor characteristics
  4. 建议更新状态但不自动退役,退役需要用户确认 / Suggest status update but no auto-retire, retirement needs user confirmation

© VernonOY, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/alpha-monitor of VernonOY/alpha-skills.

Open the folder on GitHubat commit f58f80a

Compare with similar skills

Alpha Monitor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Alpha Monitor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Alpha Monitor this skillVernonOY/alpha-skills117—~1.7kAutomated safety check: PassApache-2.0
Tushare Datazillionare/zillionare3222 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle878—~5.9kAutomated safety check: PassMIT
Polyclawchainstacklabs/polyclaw3591 repos~2kAutomated safety check: PassApache-2.0
Markdownfacioquo/stock-indicators-dotnet1.2k—~812Automated safety check: PassApache-2.0

Similar skills

  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    322 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    878 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Polyclaw

    chainstacklabs/polyclaw

    Trade on Polymarket via split + CLOB execution. An agent skill from chainstacklabs/polyclaw.

    359 GitHub starsUsed in 1 repo~2k tokens
    Business, Finance & HRAuto-check passed
  • Markdown

    facioquo/stock-indicators-dotnet

    Format and lint Markdown in this repository against GitHub Flavored Markdown and its markdownlint-cli2 configuration — headers, lists, code fences, callouts (VitePress containers on docs-site pages…

    1.2k GitHub stars~812 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Openmobius Skill

    MobiusQuant/OpenMobius-skill

    Provides multi-school trading Q&A, chart/OHLCV analysis, annotation, and fresh-market workflows covering ICT/SMC, ChanLun, Wyckoff, Price Action, Order Flow, VSA, and Elliott Wave.

    697 GitHub stars~7.2k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed

More from VernonOY/alpha-skills

All 9 skills in this repo
  • Alpha Autopilot

    VernonOY/alpha-skills

    Autonomous factor research loop. An agent skill from VernonOY/alpha-skills.

    117 GitHub stars~2.8k tokensUpdated 6 mo ago
    Auto-check passed
  • Alpha Backtest

    VernonOY/alpha-skills

    Strategy backtest. An agent skill from VernonOY/alpha-skills.

    117 GitHub stars~3.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Alpha Discover

    VernonOY/alpha-skills

    Factor discovery. An agent skill from VernonOY/alpha-skills.

    117 GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • Alpha Library

    VernonOY/alpha-skills

    Factor library management. An agent skill from VernonOY/alpha-skills.

    117 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed
  • Alpha Mine

    VernonOY/alpha-skills

    Automated factor mining. An agent skill from VernonOY/alpha-skills.

    117 GitHub stars~3.5k tokensUpdated 6 mo ago
    Auto-check passed
  • Alpha Report

    VernonOY/alpha-skills

    Factor reports. An agent skill from VernonOY/alpha-skills.

    117 GitHub stars~998 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Alpha Monitor

What does Alpha Monitor do?

Factor monitoring. An agent skill from VernonOY/alpha-skills. Alpha Monitor is an agent skill from VernonOY/alpha-skills. Factor monitoring.

When should I use Alpha Monitor?

Alpha Monitor fits situations like: tasks that involve Trading and backtesting.

How do I install Alpha Monitor in Claude Code?

Run `npx skills add VernonOY/alpha-skills --skill alpha-monitor -a claude-code`. Or copy the skill folder (skills/alpha-monitor in VernonOY/alpha-skills) into .claude/skills/alpha-monitor in your project. Claude Code loads it when a task matches its description.

How do I install Alpha Monitor in Codex?

Run `npx skills add VernonOY/alpha-skills --skill alpha-monitor -a codex`. Or copy the skill folder (skills/alpha-monitor in VernonOY/alpha-skills) into .agents/skills/alpha-monitor in your project. Codex loads it when a task matches its description.

Can I use Alpha Monitor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add VernonOY/alpha-skills --skill alpha-monitor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/alpha-monitor, .gemini/skills/alpha-monitor, .github/skills/alpha-monitor and .opencode/skills/alpha-monitor in your project.

What does Alpha Monitor need to run?

SKILL.md names no scripts, command-line tools or credentials: Alpha Monitor is instructions for the agent only. Our summary lists: Python 3.

Does Alpha Monitor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Alpha Monitor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Alpha Monitor use?

Alpha Monitor is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Alpha Monitor use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Alpha Monitor?

Skills that share tags, products or a category with Alpha Monitor: Tushare Data (zillionare/zillionare, 322 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars), Digital Oracle (komako-workshop/digital-oracle, 878 stars) and Polyclaw (chainstacklabs/polyclaw, 359 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Alpha Monitor?

VernonOY (a GitHub user) maintains it in VernonOY/alpha-skills, which has 117 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on April 14, 2026.

Source: VernonOY/alpha-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.