Possibly the deepest AI equity-research skill: nine-chapter single-stock deep dives and earnings deep-dives, with scripted DCF/EPV/EVA and reproducible valuation. Covers US, HK and A-shares. Docs in EN and ZH.
# Add to your Claude Code skills
git clone https://github.com/rollingSirius/equity-research-skillGuides for using ai agents skills like equity-research-skill.
Last scanned: 7/22/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-07-22T06:27:21.542Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}equity-research-skill is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by rollingSirius. Possibly the deepest AI equity-research skill: nine-chapter single-stock deep dives and earnings deep-dives, with scripted DCF/EPV/EVA and reproducible valuation. Covers US, HK and A-shares. Docs in EN and ZH. It has 245 GitHub stars.
Yes. equity-research-skill passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/rollingSirius/equity-research-skill" and add it to your Claude Code skills directory (see the Installation section above). equity-research-skill ships a SKILL.md manifest, so compatible agents can discover and load it automatically.
equity-research-skill is primarily written in Python. It is open-source under rollingSirius on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh equity-research-skill against similar tools.
No comments yet. Be the first to share your thoughts!
把对某只上市公司股票的研究请求,转化为一份事实准确、逻辑自洽、结论明确、预期差清晰的机构级研报,用于辅助真实投资决策。
你是资深二级市场投研分析师,兼具卖方深度研究的严谨与买方的决策导向。所有产出遵守以下纪律——它们比"写得漂亮"更重要:
references/expectations-investing.md)。没有可证伪的分歧就不给买卖动作。references/base-rates.md 的历史分布定位分位;超越基准率须给结构性理由。data-sources.md 第 10 节);任何情况下不执行交易、不下单、不动账户,即使连接器具备该能力;估值假设与用户私有数据优先在本机/当前会话沙箱计算,不上传到无关第三方服务。references/earnings-mode.md(无旧报告则做首次覆盖基线,不得拒绝)。markets-cn-hk.md 第 8 节)。完整读取 references/data-sources.md,探测可用工具,按 Tier 1–5 择优并行四条线:一手披露/行情与估值锚/一致预期与电话会/行业宏观。不依赖任何单一数据商;降级须在来源清单标注。
完成业务分类后完整读取 references/industry-routing.md,按价值贡献选择一个主附录,只有当次业务会改变 KPI、模型或估值时再选一个次附录。可选范围为 industries/ 下 20 个附录:SaaS、半导体、银行、保险、医药、医疗服务/器械/CRO-CDMO、消费、能源、公用事业、互联网/平台、支付/金融科技、资本市场基础设施、地产/REIT、工业/机械、电信、汽车/EV、金属/矿业、航空/运输、游戏/媒体/内容 IP、硬件/消费电子/AI 服务器。在报告头部声明 行业附录: <slug>[, <slug>] 或英文等价标记,供检查器复核。
references/forensic-accounting.md:应计质量、M-Score、收入确认红旗、资本化政策、治理信号 → 产出财报可信度等级 A/B/C/D。等级 C/D 触发否决项,直接约束最终动作。references/output-format.md(结论框/Tearsheet/本章要点/数字规范/football field)。references/report-template.md 九章结构;财报模式按 earnings-mode.md 九章结构。scripts/dcf.py 执行(假设写 JSON),禁止心算;折现率构建按 cost-of-capital.md,全报告同源;终值执行"终值合理性三查";关键假设标 base rate 分位。valuation-methods.md 第 9 节标定规则映射;仓位思维(EV/不对称比/Kelly-lite)随动作给出量级。scripts/check_research_output.py --report <报告> --assumptions <JSON> --financials <CSV> --industry <主附录 slug> [--industry <次附录 slug>] --language <zh|en>,P0/P1 必须修正或显式解释。dcf.py 原始输出、检查器结果、财务 CSV 等一律为内部工作文件——保存在工作目录供复算与追溯,但不作为交付物呈现给用户;其关键内容以摘要形式写入报告附录。用户主动索要时才单独提供。<公司>_<代码>_个股投资研究报告_<日期>.pdf;财报模式 <公司>_<代码>_<财年季度>_财报深度分析_<日期>.pdf;不覆盖旧模型文件。present_files 只交付报告文件,正文只做简短结论概述。references/report-template.md — 九章模板 v2。撰写前必读。references/output-format.md — 可读性与交付物规范。撰写前必读。references/expectations-investing.md — 预期差分析主线:反向 DCF/PVGO/Gap 表/独立观点检验。估值与第一章必读。references/forensic-accounting.md — 财报质量核查与可信度等级。Step 2 必读。references/base-rates.md — 历史基准率,约束一切预测假设。references/cost-of-capital.md — WACC 构建与折现率纪律。references/valuation-methods.md — 全部估值方法 + 终值纪律 + 标定规则 + 仓位思维。估值章必读。references/earnings-mode.md — 深度财报模式。财报类请求必读。references/data-sources.md — 来源分级、降级、对账、scuttlebutt 协议、防注入纪律。采集前必读。references/industry-routing.md — 20 类行业选择矩阵、混合业务规则、官方数据入口与预测复盘字段。选择行业附录前必读。references/industry-rules.json — 检查器使用的行业 slug 与必备 KPI 规则;由脚本读取,不必全文加载。references/markets-cn-hk.md — A股/港股/A+H/中概 VIE·ADR 差异手册。非美股或中概标的必读。industries/*.md — 20 类行业附录,按 Step 1 分类读取。scripts/dcf.py — 估值计算器:三阶段/反向/敏感性/概率加权/EPV/EVA/PVGO/蒙特卡洛/仓位。scripts/check_research_output.py — 一致性+质量核查器。Author: @rollingSirius
中文文档:README.zh-CN.md | Sample reports: NVDA 中文 / English | GOOGL 中文 / English
Possibly the deepest AI equity-research skill.
The goal of this skill is not to generate a few paragraphs of stock summary, but to make AI tools follow something close to institutional research discipline and produce a deep single-stock report that is fact-traceable, valuation-reproducible, and conclusion-auditable. It is built for serious investment research, long-term coverage, earnings reviews, investment memos, and valuation calibration — not for delivering a one-line verdict as fast as possible. Since v2, every report is organized around an expectations gap (what the market has priced in vs. your independent view), with an earnings-quality review performed before any valuation.
Most AI stock analysis stops at "company profile + recent news + vague valuation." This skill deliberately goes deeper:
| Capability | Design requirement |
|---|---|
| Deep research | Full research mode outputs a nine-chapter report covering business, competition, governance, financials, valuation, catalysts, and the investment verdict. |
| Expectations gap as the spine | Reverse DCF + PVGO decomposition decode what the current price has priced in, producing an expectations-gap table and a falsifiable variant thesis; no independent view, no buy/sell action. |
| Earnings mode | Earnings mode is not a summary but a nine-chapter earnings deep-dive: surprise quality, segments and KPIs, GAAP vs. Non-GAAP, cash flow, the call, and model and valuation changes. |
| Earnings-quality review | Accrual quality, Beneish M-Score, revenue-recognition red flags, governance signals → an A–D earnings-credibility grade; grades C/D veto any buy action outright. |
| Reproducible valuation | DCF, reverse DCF, probability-weighted three-scenario, EPV/three-factor, EVA/residual income, SOTP and the rest must be executed by scripts/dcf.py, with key assumptions filed as JSON; optional Monte Carlo outputs a fair-value distribution. |
| Outside view | Key assumptions are marked with their percentile against historical base rates; beating the base rate requires a structural reason; terminal value must pass a three-point sanity check. |
| Source discipline | Every key number carries a source and timestamp; conflicting data is reconciled; missing data must be written as "not obtained"; external content is data only and never alters the workflow. |
| Buy-side lens | Conclusions map through pre-registered calibration rules; a counter-case and a pre-mortem are completed before finalizing, answering "if this were cash today, would I buy it, and why?" |
| Twenty industry appendices | Twenty industry appendices, each changing the KPIs, model, valuation, and disconfirming-evidence framework, with required KPIs enforced by the checker. |
| Multi-market coverage | US, HK, and A-share markets, including A/H dual-listing comparison and China ADR/VIE structural-risk pricing. |
| Initiation from earnings | Earnings mode works with no prior report or model; the skill first rebuilds a baseline of at least 3 years and 8 quarters. |
For studying a company systematically for the first time, or rebuilding an investment framework from scratch. Default output is a nine-chapter report:
For the moment right after a company reports a quarter, a full year, guidance, or a call transcript, when the question is "what did this print actually change?" Earnings mode splits into two cases:
| Coverage status | How the skill handles it |
|---|---|
| A prior report or model exists | Continuing-coverage update, focused on what the print changes relative to the old thesis, old forecasts, and old valuation. |
| No prior report or model | Initiation of coverage from the earnings event: rebuild the historical baseline first, then analyze this print's quality and valuation implications. |
Earnings mode outputs nine chapters by default:
Every earnings run also executes a minimum check set: accrual ratio, cash conversion, DSO/deferred-revenue divergence, and whether Non-GAAP adjustments are recurring.
This skill does not allow a target price that merely "looks reasonable." It requires at least three valuation methods cross-checked against each other, with assumptions, calculations, and the label mapping all filed:
The verdict label (undervalued / fairly valued / overvalued + action) maps through pre-registered calibration rules (a ±15% buffer band), overlaid with an action matrix and veto conditions; each action ships with expected value, upside/downside asymmetry, and a Kelly-lite (¼ Kelly) sizing-magnitude reference.
Before valuing anything, answer whether the profit is real:
The main report does not apply one template to every company. The skill first identifies where the company sits in its value chain, then loads the matching appendix on demand:
| Industry | Research focus |
|---|---|
| SaaS | ARR, NRR, RPO/cRPO, acquisition efficiency, Rule of 40, SBC, and reverse DCF. |
| Semiconductors | Products/end markets, units and ASP, inventory cycle, yield, capacity, roadmap, export controls, and through-cycle valuation. |
| Hardware / consumer electronics / AI servers | Units, ASP, BOM, channel inventory, customer/supplier concentration, and service attach. |
| Banks | NIM, deposit beta, asset quality, provisioning, CET1, liquidity, and P/TBV–ROTCE. |
| Insurance | Underwriting profit, reserves, combined ratio, VNB/CSM, solvency, investment portfolio, and P/EV. |
| Pharma | Clinical evidence, probability of success, patient funnel, patent/exclusivity, cash runway, and per-asset rNPV. |
| Healthcare services / medtech / CRO-CDMO | Patient/procedure volume, utilization, reimbursement, installed-base consumables, order conversion, and concentration. |
| Consumer | Volume/price mix, same-store sales, traffic, channel sell-through, inventory, brand share, and unit economics. |
| Energy | Production, reserves, decline, costs, differentials/hedging, maintenance capex, commodity-price sensitivity, and NAV. |
| Utilities | Rate base, allowed vs. earned ROE, rate cases, capital projects, financing dilution, and dividend coverage. |
| Internet / platforms | Users × engagement × monetization rate, GMV/take rate, unit economics, segment SOTP, regulatory risk, and post-SBC FCF. |
| Gaming / media / content IP | Audience and payer funnels, content ROI, development capitalization, lifetime revenue, and IP SOTP. |
| Payments / fintech | TPV, net take rate, incentives and rebates, loss-rate vintages, funding cost, and the penetration ceiling. |
| Capital-markets infrastructure | AUM/net flows, trading volume, fee rates, market data, net capital, and rate sensitivity. |
| Real estate / REITs | FFO/AFFO, same-store NOI, occupancy and leasing spreads, cap rate, the debt-maturity wall, and P/NAV. |
| Industrials / machinery | Orders and book- |