mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-05-11 03:31:55 +00:00

feat(optional-skills): port Anthropic financial-services skills as optional finance bundle (#21180 )

Adds 7 optional skills under optional-skills/finance/ adapted from
anthropics/financial-services (Apache-2.0):

  excel-author        — openpyxl conventions: blue/black/green cells,
                        formulas over hardcodes, named ranges, balance
                        checks, sensitivity tables. Ships recalc.py.
  pptx-author         — python-pptx for model-backed decks (pitch,
                        IC memo, earnings note) that bind every number
                        to a source workbook cell.
  dcf-model           — institutional DCF (49KB skill): projections,
                        WACC, terminal value, Bear/Base/Bull scenarios,
                        5x5 sensitivity tables. Ships validate_dcf.py.
  comps-analysis      — comparable company analysis: operating metrics,
                        multiples, statistical benchmarking.
  lbo-model           — leveraged buyout: S&U, debt schedule, cash
                        sweep, exit multiple, IRR/MOIC sensitivity.
  3-statement-model   — fully-integrated IS/BS/CF with balance-check
                        plugs. Ships references/ for formatting,
                        formulas, SEC filings.
  merger-model        — accretion/dilution analysis for M&A.

All seven are optional (not active by default). Users install via
'hermes skills install official/finance/<skill>'.

Hermesification:
- Stripped every Office JS / Office Add-in / mcp__office__*
  branch — skills assume headless openpyxl only.
- Replaced Cowork MCP data-source instructions with 'MCP first (via
  native-mcp), fall back to web_search/web_extract against SEC EDGAR
  and user-provided data'.
- Swapped Claude tool references (Bash, Read, Write, Edit, mcp__*)
  for Hermes-native equivalents and Python library calls.
- Canonical Hermes frontmatter (name/description/version/author/
  license/metadata.hermes.{tags,related_skills}).
- Descriptions tightened to 187-238 chars, trigger-first.
- Attribution preserved: author field credits 'Anthropic (adapted by
  Nous Research)', license: Apache-2.0, each SKILL.md links back to
  the upstream source directory.

Verification:
- All 7 discovered by OptionalSkillSource with source_id='official'
- Bundle fetch includes support files (scripts, references, troubleshooting)
- related_skills cross-refs all resolve within the bundle
- No Claude product / Cowork / Office JS / /mnt/skills leakage
  remains in body text (bounded mentions only in attribution blocks)

Source: https://github.com/anthropics/financial-services (Apache-2.0)

2026-05-07 04:58:39 -07:00

4.5 KiB

Raw Blame History

SEC Filings Data Extraction Reference

When to Use: Only reference this file when a model template specifically requires pulling data from SEC filings (10-K, 10-Q). For templates that provide data directly or use other data sources, this reference is not needed.

Extracting Data from SEC Filings (10-K / 10-Q)

When populating a model template with public company data, extract financials directly from SEC filings.

Step 1: Locate the Filing

Use SEC EDGAR: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=[TICKER]&type=10-K
For quarterly data, use type=10-Q

Step 2: Identify Filing Currency

Before extracting data, identify the reporting currency:

Check the cover page or header for reporting currency
Look at statement headers (e.g., "in thousands of U.S. dollars")
Review Note 1 (Summary of Significant Accounting Policies)

Common Currency Indicators

Indicator	Currency
$, USD	US Dollar
€, EUR	Euro
£, GBP	British Pound
¥, JPY	Japanese Yen
¥, CNY, RMB	Chinese Yuan
CHF	Swiss Franc
CAD, C$	Canadian Dollar

Set model currency to match filing; document in Assumptions tab.

Step 3: Navigate to Financial Statements

Within the 10-K or 10-Q, locate:

Item 8 (10-K) or Item 1 (10-Q): Financial Statements
Key sections to extract:
- Consolidated Statements of Operations (Income Statement)
- Consolidated Balance Sheets
- Consolidated Statements of Cash Flows
- Notes to Financial Statements (for schedule details)

Step 4: Data Extraction Mapping

Income Statement (from Consolidated Statements of Operations)

Filing Line Item	Model Line Item
Net revenues / Net sales	Revenue
Cost of goods sold	COGS
Selling, general and administrative	SG&A
Depreciation and amortization	D&A
Interest expense, net	Interest Expense
Income tax expense	Taxes
Net income	Net Income

Balance Sheet (from Consolidated Balance Sheets)

Filing Line Item	Model Line Item
Cash and cash equivalents	Cash
Accounts receivable, net	AR
Inventories	Inventory
Property, plant and equipment, net	PP&E (Net)
Total assets	Total Assets
Accounts payable	AP
Short-term debt / Current portion of LT debt	Current Debt
Long-term debt	LT Debt
Retained earnings	Retained Earnings
Total stockholders' equity	Total Equity

Cash Flow Statement (from Consolidated Statements of Cash Flows)

Filing Line Item	Model Line Item
Net income	Net Income
Depreciation and amortization	D&A
Changes in accounts receivable	ΔAR
Changes in inventories	ΔInventory
Changes in accounts payable	ΔAP
Capital expenditures	CapEx
Proceeds from issuance of common stock	Equity Issuance
Proceeds from / Repayments of debt	Debt activity
Dividends paid	Dividends

Step 5: Extract Supporting Detail from Notes

For schedules, pull from Notes to Financial Statements:

Note: Debt → Maturity schedule, interest rates, covenants
Note: Property, Plant & Equipment → Gross PP&E, accumulated depreciation, useful lives
Note: Revenue → Segment breakdowns, geographic splits
Note: Leases → Operating vs. finance lease obligations

Step 6: Historical Data Requirements

Extract 3 years of historical data minimum:

10-K provides 3 years of IS/CF, 2 years of BS
For 3rd year BS, pull from prior year's 10-K
Use 10-Qs to fill in quarterly granularity if needed

Data Extraction Checklist

Identify reporting currency and scale (thousands, millions)
3 years historical Income Statement
3 years historical Cash Flow Statement
3 years historical Balance Sheet
Verify IS Net Income = CF starting Net Income (each year)
Verify BS Cash = CF Ending Cash (each year)
Extract debt maturity schedule from notes
Extract D&A detail or useful life assumptions
Note any non-recurring / one-time items to normalize

Handling Common Filing Variations

Variation	How to Handle
D&A embedded in COGS/SG&A	Pull D&A from Cash Flow Statement
"Other" line items are material	Check notes for breakdown
Restatements	Use restated figures, note in assumptions
Fiscal year ≠ calendar year	Label with fiscal year end (e.g., FYE Jan 2025)
Non-USD reporting currency	Adapt model currency to match filing

4.5 KiB Raw Blame History