mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-12 03:42:08 +00:00
fce58cbe2e
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)
125 lines
4.5 KiB
Markdown
125 lines
4.5 KiB
Markdown
# 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
|
|
|
|
1. Use SEC EDGAR: `https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=[TICKER]&type=10-K`
|
|
2. 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 |
|