StockSkill

经过真实 QVeris 调用验证的开源金融研究 Skill 集合，面向 Codex、Claude Code、Cursor、OpenClaw 和其他兼容 SKILL.md 的 AI Agent。

StockSkill provides tested, QVeris-powered finance research skills. Each skill is self-contained, uses QVeris capability routing for external financial data, and keeps modeling or analytical computation local.

Skills

Skill	用途	方法论来源
FinGPT	金融新闻、情绪、RAG 与事件研究	AI4Finance-Foundation/FinGPT
FinRL	强化学习数据集、回测与离线策略研究	AI4Finance-Foundation/FinRL
FinRobot	财务、估值、电话会与公司研究报告	AI4Finance-Foundation/FinRobot
ClarityFinance	基本面、技术面、新闻和情绪四维分析	cooragent/ClarityFinance
Qlib	因子、时间序列、模型和组合研究	microsoft/qlib
AI Hedge Fund	多视角股票研究委员会	virattt/ai-hedge-fund

These are clean-room skill adaptations informed by the upstream projects. They do not bundle upstream models, datasets, or application code.

QVeris data flow

All live external financial data follows:

Discover → Inspect → Call

Each skill contains:

• SKILL.md: agent workflow and safety boundaries;
• qveris.manifest.json: required and optional QVeris capability contracts;
• candidate.json: upstream provenance and recorded test status;
• scripts/: self-contained QVeris client and validation runner;
• tests/: mocked end-to-end contract tests;
• agents/openai.yaml: UI metadata for compatible clients.

Install

Clone the repository:

git clone https://github.com/Leon-Drq/stockskill.git
cd stockskill

Install one skill into Codex:

cp -R skills/microsoft-qlib ~/.codex/skills/microsoft-qlib

Or install the complete collection:

mkdir -p ~/.codex/skills
cp -R skills/* ~/.codex/skills/

Set QVERIS_API_KEY only in your environment or secret manager. Never commit API keys.

Test

Requirements: Node.js 18 or newer. The offline tests require no API key.

make validate
make test
make preflight
QVERIS_API_KEY=... make live

• validate: validate every Skill and QVeris capability manifest;
• test: run mocked Discover → Inspect → Call tests;
• preflight: check current public QVeris provider coverage without consuming execution credits;
• live: make one real QVeris call per Skill and may consume credits.

The initial release passed 6/6 Skill validations, 12/12 mocked contract tests, all 35 required capability preflights, and 6/6 live QVeris smoke tests on 2026-08-10.

Current limitations

• FinRL uses realized volatility and market breadth because native VIX coverage is unavailable.
• FinRobot treats full regulatory filing text as optional; structured XBRL remains available.
• Qlib discloses historical-universe uncertainty while index rebalance-event coverage is unavailable.
• All skills are research-only. They do not access brokerage accounts or place orders.

License and attribution

StockSkill is released under the MIT License. Upstream project names, links, licenses, and tested commits are recorded in THIRD_PARTY_NOTICES.md and each skill's candidate.json.