13f firehose

Skill ssurmic/claude-investment-skills/13f-firehose

Investment-research skills for Claude Code: top-down macro-aware framework, bilingual EN/CN NL triggers, Telegram alerts (2-min cron + 1-3s webhook). For personal-finance buy-side use (swing/position/LEAPS) — not HFT. See NEXT-STEPS.md for roadmap.

Install

npx -y skills add ssurmic/claude-investment-skills --skill 13f-firehose

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Daily monitor for new 13F-HR filings from famous funds. Telegram alerts with NEW/ADDED/CLOSED diff vs. prior quarter.

SKILL.md

1.8 KB, as published. Nobody here has run it

13F Firehose

Scans SEC EDGAR twice daily for new 13F-HR filings from a curated registry of famous funds. Each new filing → Telegram alert with diff vs. prior quarter.

Funds tracked (17)

P1 (alert immediately): Leopold (Situational Awareness), NVIDIA Corp, Buffett (Berkshire), Ackman (Pershing), Loeb (Third Point), Tepper (Appaloosa), Soros, Burry (Scion), Englander (Millennium)

P2: RenTech, Bridgewater, Tiger Global, Coatue, Lone Pine, Marks (Oaktree)

P3: Wood (ARK), Einhorn (Greenlight)

Edit scripts/fund_registry.py to add/remove.

Cron

Three times daily, weekdays only (US business hours):

13:00 UTC (9 AM ET) — morning, catches overnight + pre-market filings
17:00 UTC (1 PM ET) — midday filings
21:00 UTC (5 PM ET) — post-close filings

13F deadlines: Feb 14 / May 15 / Aug 14 / Nov 14 (45 days after quarter-end).

Manual run

# Test (no Telegram)
TEST_MODE=1 PRIORITY_MAX=1 FORCE_RESCAN=1 python3 scripts/13f_firehose.py

# One CIK
python3 scripts/edgar_13f.py 2045724

Alert format

NEW positions ($5M+ min) | ADDED (>+20% shares) | CLOSED | Top 10 holdings with % AUM | EDGAR link

Adding a fund

Find CIK: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&company=NAME&type=13F-HR
Add to FUNDS list in fund_registry.py
Seed state to avoid first-run flood: see scripts/13f_firehose.py header

State

scripts/state.json tracks seen[cik] = accession. Committed back by GH Actions after each run.

To force re-alert one fund:

python3 -c "import json; s=json.load(open('scripts/state.json')); del s['seen']['2045724']; json.dump(s, open('scripts/state.json','w'), indent=2)"