Agent skill

Alpha Report

by VernonOY in VernonOY/alpha-skills

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

Apache-2.0Auto-check passedBusiness, Finance & HR

Install Alpha Report

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

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

GitHub CLI
$ gh skill install VernonOY/alpha-skills alpha-report --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-report .claude/skills/alpha-report && 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-report
GitHub stars
117
Token cost
~998 tokens
SKILL.md length
424 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 5 steps: 因子库统计 Library statistics(总数 total、各状态计数… → 因子排行榜 Factor leaderboard(按ICIR排序 sorted… → 因子健康概览 Health overview(🟢🟡🔴分布… → …
  • Tasks that involve Trading and backtesting
  • SKILL.md covers Bilingual Terms / 双语术语, 项目定位 / Project Context, 报告类型 / Report Types and 生成流程 / Generation Pipeline, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Alpha Report is an agent skill from VernonOY/alpha-skills. Factor reports. Generate panoramic, deep-dive, or comparison reports. 因子报告。生成全景、深度、对比报告。 Triggers: "generate report", "factor report", "生成报告", "因子报告"

Its SKILL.md is about 1000 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

  • “generate report”
  • “factor report”
  • “/alpha-report”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 因子库统计 Library statistics(总数 total、各状态计数 status counts、各类别分布 category distribution)
  2. 因子排行榜 Factor leaderboard(按ICIR排序 sorted by ICIR)
  3. 因子健康概览 Health overview(🟢🟡🔴分布 distribution)
  4. 因子相关性矩阵 Factor correlation matrix(活跃因子之间的秩相关热力图 rank correlation heatmap among active factors)
  5. 建议 Suggestions(哪些因子冗余 which factors are redundant、哪类因子缺失 which factor types are missing)

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 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 Report loads about 998 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 424 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
~998

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). 424 words, ~998 tokens.

Download SKILL.mdSave it as .claude/skills/alpha-report/SKILL.md (or your agent's skills folder).
name
alpha-report
description
Factor reports. Generate panoramic, deep-dive, or comparison reports. 因子报告。生成全景、深度、对比报告。 Triggers: "generate report", "factor report", "生成报告", "因子报告"

alpha-report — Report Generation / 综合报告生成

你是一个量化研究报告撰写员。生成专业的因子研究报告。 You are a quant research report writer. Generate professional factor research reports.

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均值"

报告类型 / Report Types

根据用户意图选择报告类型 / Select report type based on user intent:

类型1: 因子库全景报告 / Type 1: Factor Library Panoramic Report

触发 Triggers: "因子库报告" / "library report"、"全景报告" / "panoramic report"

内容 Content:

  1. 因子库统计 Library statistics(总数 total、各状态计数 status counts、各类别分布 category distribution)
  2. 因子排行榜 Factor leaderboard(按ICIR排序 sorted by ICIR)
  3. 因子健康概览 Health overview(🟢🟡🔴分布 distribution)
  4. 因子相关性矩阵 Factor correlation matrix(活跃因子之间的秩相关热力图 rank correlation heatmap among active factors)
  5. 建议 Suggestions(哪些因子冗余 which factors are redundant、哪类因子缺失 which factor types are missing)
类型2: 单因子深度报告 / Type 2: Single Factor Deep-dive Report

触发 Triggers: "XX因子报告" / "XX factor report"、"XX因子详情" / "XX factor detail"

内容 Content:

  1. 因子基本信息 Basic info(表达式 expression、类别 category、注册日期 registration date)
  2. 评估指标 Evaluation metrics(IC/ICIR/分层 quintile/多空 long-short)— 调用 call FactorReport
  3. 因子在不同市场环境下的表现 Factor performance in different market regimes
  4. 与其他因子的相关性 Correlation with other factors
  5. 最新健康状态 Latest health status
Show full SKILL.md (168 more words)Show less
类型3: 多因子对比报告 / Type 3: Multi-factor Comparison Report

触发 Triggers: "对比XX和YY因子" / "compare XX and YY factors"、"比较这几个因子" / "compare these factors"

内容 Content:

  1. 指标对比表 Metrics comparison table(IC/ICIR/L/S Sharpe 多空Sharpe并排 side-by-side)
  2. 分层收益对比 Quintile return comparison
  3. 相关性分析 Correlation analysis(它们是互补还是冗余 are they complementary or redundant?)
  4. 组合建议 Combination suggestions(如果用这几个因子做组合,推荐权重 recommended weights if combining these factors)

生成流程 / Generation Pipeline

  1. 识别报告类型和目标因子 / Identify report type and target factors
  2. 从因子注册表读取元数据 / Read metadata from factor registry
  3. 如需要,重新计算因子值和指标 / If needed, recompute factor values and metrics
  4. 生成图表 / Generate charts(使用matplotlib直接绘制 generate directly with matplotlib)
  5. 输出文字摘要 + 图表文件路径 / Output text summary + chart file path

输出格式 / Output Format

文字报告直接输出在对话中(Markdown表格)。 Text reports are output directly in the conversation (Markdown tables). 图表保存到 output/ 目录并告知用户路径。 Charts are saved to output/ directory and user is informed of the path.

注意事项 / Notes

  1. 报告语言跟随配置 Report language follows config(.claude/alpha-agent.config.md 中的 LANGUAGE)
  2. 相关性计算用截面秩相关 Correlation computed using cross-sectional rank correlation(Spearman)
  3. 如果因子库为空,提示先评估和注册因子 / If library is empty, prompt to evaluate and register factors first
  4. 生成大型报告时告知用户 Inform user for large reports "Generating, please wait... / 正在生成,请稍候..."

© 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-report of VernonOY/alpha-skills.

Open the folder on GitHubat commit f58f80a

Compare with similar skills

Alpha Report 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 Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Alpha Report this skillVernonOY/alpha-skills117—~998Automated safety check: PassApache-2.0
Tushare Datazillionare/zillionare3212 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle875—~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/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    321 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.

    875 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 today
    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.

    695 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 5 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 5 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 5 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 5 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 5 mo ago
    Auto-check passed
  • Alpha Monitor

    VernonOY/alpha-skills

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

    117 GitHub stars~1.7k tokensUpdated 5 mo ago
    Auto-check passed

Questions about Alpha Report

What does Alpha Report do?

Factor reports. An agent skill from VernonOY/alpha-skills. Alpha Report is an agent skill from VernonOY/alpha-skills. Factor reports.

When should I use Alpha Report?

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

How do I install Alpha Report in Claude Code?

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

How do I install Alpha Report in Codex?

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

Can I use Alpha Report 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-report -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-report, .gemini/skills/alpha-report, .github/skills/alpha-report and .opencode/skills/alpha-report in your project.

What does Alpha Report need to run?

SKILL.md names no scripts, command-line tools or credentials: Alpha Report is instructions for the agent only.

Does Alpha Report 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 Report 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 Report use?

Alpha Report 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 Report use?

About 998 tokens (SKILL.md is roughly 4k 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 Report?

Skills that share tags, products or a category with Alpha Report: Tushare Data (zillionare/zillionare, 321 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars), Digital Oracle (komako-workshop/digital-oracle, 875 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 Report?

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.