investing
CLAUDE.md489 starsChanged 3 months agoApache-2.0View on GitHub
This is a financial analysis toolkit powered by Daloopa's institutional-grade financial data, designed for hedge fund analysts doing fundamental equity research. Fallback scripts (when no MCP provides market data): - python infra/marketdata.py quote TICKER — price, market cap, shares, beta - python infra/marketdata.py multiples TICKER — P/E, EV/EBITDA, P/S, P/B - python infra/marketdata.py history TICKER --period 2y — historical OHLCV - python infra/marketdata.py peers TICKER1 TICKER2 ... — side-by-side multiples - python infra/market_data.py risk-free-rate — 10Y Treasury from FRED Example:…
We split this CLAUDE.md into the rules it gives an agent
9 rules. About 0 are common, 6 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
All analysis should be thorough, data-driven, and cite sources
- Very specific: line 11
Follow design-system.md for number formatting, analytical density, and styling
- Distinctive: line 14
Always follow this pattern when working with Daloopa data:
- Very specific: line 32
All skills reference .claude/skills/design-system.md for consistent formatting:
- Distinctive: line 40
Every financial figure must link back to its Daloopa source:
- Distinctive: line 47
Always use standard financial analysis layout:
- Distinctive: line 55
Never compare same-quarter guidance to same-quarter actual
- Distinctive: line 58
When analyzing any company, always discover and include company-specific KPIs beyond standard financials (e.g., subscribers, ARR, GMV, …
- Very specific: line 61
All generated analysis is saved to the reports/ directory.
≈ “Common” is an estimate: at least 1 in 5 of the 25,680 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Daloopa Financial Analysis Toolkit
This is a financial analysis toolkit powered by Daloopa's institutional-grade financial data, designed for hedge fund analysts doing fundamental equity research.
Analyst Context
- Perspective: long/short equity, fundamental analysis
- Data source: Daloopa MCP server (SEC filings, earnings, financial statements)
- Market data: MCP-first (use whatever market data MCP the user has configured), fallback to
infra/market_data.py - Consensus estimates: optional (when available, adds beat/miss and forward context)
- All analysis should be thorough, data-driven, and cite sources
- Follow
design-system.mdfor number formatting, analytical density, and styling
MCP Tool Workflow
Always follow this pattern when working with Daloopa data:
discover_companies— Look up company by ticker or name to getcompany_iddiscover_company_series— Find available financial metrics and KPIs for the companyget_company_fundamentals— Pull actual data for specific series and periodssearch_documents— Search SEC filings (10-K, 10-Q, 8-K) for qualitative information
Market Data
Market data uses whatever MCP the user has configured (preferred), falling back to infra/market_data.py if no market data MCP is available. See .claude/skills/data-access.md Section 2 for the full resolution order.
Fallback scripts (when no MCP provides market data):
python infra/market_data.py quote TICKER— price, market cap, shares, betapython infra/market_data.py multiples TICKER— P/E, EV/EBITDA, P/S, P/Bpython infra/market_data.py history TICKER --period 2y— historical OHLCVpython infra/market_data.py peers TICKER1 TICKER2 ...— side-by-side multiplespython infra/market_data.py risk-free-rate— 10Y Treasury from FRED
Design System
All skills reference .claude/skills/design-system.md for consistent formatting:
- Number formatting ($X.Xbn, X.X%, X.Xx multiples, +/-Xbps)
- Three-layer analytical density (data point + context + implication)
- Table conventions (columns = periods, rows = metrics, growth sub-rows)
- Commentary blocks after every major table
- Color palette (navy #1B2A4A, steel blue #4A6FA5, gold #C5A55A)
Citation Format
Every financial figure must link back to its Daloopa source:
[$X.XX million](https://daloopa.com/src/{fundamental_id})Example: Revenue grew to $75.2 billion
Table Format
Always use standard financial analysis layout:
- Columns = time periods (Q1 2024, Q2 2024, etc.)
- Rows = financial metrics (Revenue, Net Income, etc.)
Guidance vs Actuals Rules
- Quarterly guidance from Q(N) applies to Q(N+1) results
- Annual guidance from Q1/Q2/Q3 applies to current fiscal year
- Annual guidance from Q4 applies to NEXT fiscal year
- Never compare same-quarter guidance to same-quarter actual
Key Operating KPIs
When analyzing any company, always discover and include company-specific KPIs beyond standard financials (e.g., subscribers, ARR, GMV, same-store sales, DAU/MAU, ARPU, units, bookings, backlog).
Reports
All generated analysis is saved to the reports/ directory. Reports are gitignored so each analyst generates their own. Word documents, Excel models, PDFs, and decks are also saved there.
Available Commands
Building Block Skills (HTML reports)
/setup— Walk through initial setup and authentication/earnings TICKER— Full earnings analysis with guidance tracking/earnings-prep TICKER— Pre-earnings preparation report for the night before a company reports/earnings-flash TICKER— Rapid first-read earnings flash/tearsheet TICKER— Quick one-page company overview/industry TICKER1 TICKER2 ...— Cross-company industry comparison/bull-bear TICKER— Bull/bear/base scenario framework/guidance-tracker TICKER— Track management guidance accuracy/inflection TICKER— Auto-detect biggest metric accelerations/decelerations/capital-allocation TICKER— Deep dive into buybacks, dividends, shareholder yield/dcf TICKER— Discounted cash flow valuation with sensitivity analysis/comps TICKER— Trading comparables with peer multiples and implied valuation/precedent-transactions TICKER— Precedent M&A transactions with deal multiples and implied valuation/comp-sheet TICKER— Multi-company industry comp sheet Excel model with deep KPIs/supply-chain TICKER— Interactive supply chain dashboard mapping suppliers, customers, and financial interdependencies/unit-economics TICKER— Bottoms-up unit economics decomposition/working-capital TICKER— Cash conversion cycle, earnings quality & working capital deep-dive
Investment Deliverables (.docx, .xlsx, .pdf)
/research-note TICKER— Generate professional Word research note/build-model TICKER— Build multi-tab Excel financial model/initiate TICKER— Initiate coverage: generates both research note + Excel model/update TICKER— Refresh existing coverage with latest quarter's data/ib-deck TICKER— Generate institutional-grade pitch deck (HTML → PDF)
Infrastructure
infra/market_data.py— Market data fallback via yfinance (price, multiples, history)infra/chart_generator.py— Professional chart generation (6 chart types: time-series, waterfall, football-field, pie, scenario-bar, dcf-sensitivity)infra/projection_engine.py— Forward financial projectionsinfra/excel_builder.py— Multi-tab Excel model builder (single-company)infra/comp_builder.py— Multi-company comp sheet Excel builder (8 tabs)infra/docx_renderer.py— Word document renderer from templatesinfra/pdf_renderer.py— Markdown → styled HTML → PDF rendererinfra/deck_renderer.py— HTML deck → PDF rendererinfra/report_differ.py— Context JSON diff for update trackingtemplates/research_note.docx— Word template for research notes
Plugin
The building block skills are also available as standalone plugins in two sibling repos: ../daloopa-plugin-claude/ (Claude Code plugin) and ../daloopa-plugin-codex/ (Codex plugin, derived from the Claude version — no argument-hint/$ARGUMENTS, plus per-skill agents/openai.yaml). The plugins use MCP + generic market data language (no Python infrastructure required). Use scripts/sync_plugin.sh to sync shared skill files to both plugin repos. Note: each plugin repo maintains its own simplified skills/data-access.md — shared policy changes (e.g., Source Quality rules) must be applied to those copies manually.
API Documentation
The daloopa-docs MCP server provides direct access to Daloopa's knowledgebase for API usage questions, data coverage, and platform features. A local copy of the docs is also in daloopa_docs/. See also: https://docs.daloopa.com
In this repository23 other files it gives its agents.
- build-modelSkill
- bull-bearSkill
- capital-allocationSkill
- comp-sheetSkill
- compsSkill
- dcfSkill
- earnings-flashSkill
- earnings-prepSkill
- earnings-reviewSkill
- guidance-trackerSkill
- ib-deckSkill
- industrySkill
- inflectionSkill
- initiateSkill
- meta-skillSkill
- precedent-transactionsSkill
- research-noteSkill
- setupSkill
- supply-chainSkill
- tearsheetSkill
- unit-economicsSkill
- updateSkill
- working-capitalSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

