TA

tellmefrankie/ai-investment-skills

Developer tools
22 stars Quality 44 Trend 31

6 Claude Code skills for individual investors: options flow scanner (lottery-call filter), stop-loss monitor, earnings risk check, sector rotation, position classifier. Free tier included.

Overview

10+ Claude Code skills — investment analysis and developer tools — options flow scanner, stop-loss monitor, earnings risk check, sector rotation signal, lottery-call filter, and 9-wave morning briefing. Built from 6+ months of live portfolio management. Not demos — these run every morning on a real account. XLI at 5.32 = someone bought roughly 5 puts for every 1 call on the entire US industrial sector while the broad market was pricing in upside. RXRX looked like a strong buy until the filter ran — 84% of the call volume was sub-$0.10 lottery tickets. The free skills show the architecture. The pro bundle is what runs every trading day. No API keys needed for any dev tool. Just git and Claude Code. Raw put/call ratios are broken for tickers with high retail options activity. : raw P/C 0.38 -> flagged extreme bullish. After stripping 84% lottery calls (delta mildly bearish. A scanner without filtering would have sent a strong buy signal into a bearish setup. : raw P/C 1.

README

AI Investment Skills for Claude Code

10+ Claude Code skills — investment analysis and developer tools — options flow scanner, stop-loss monitor, earnings risk check, sector rotation signal, lottery-call filter, and 9-wave morning briefing.

Built from 6+ months of live portfolio management. Not demos — these run every morning on a real account.

Get the Pro Bundle — $29 one-time →


What it caught last week

Options Flow Summary — 2026-05-13

SPY  P/C: 0.44   [EXTREME BULLISH]
QQQ  P/C: 0.54   [BULLISH]
XLI  P/C: 5.32   [OUTLIER — INSTITUTIONAL HEDGE SIGNAL]  <- flagged automatically
CEG  P/C: 1.06   raw -> looks neutral
     adjusted: 59.2   [EXTREME BEARISH] after stripping 98.4% lottery calls
RXRX P/C: 0.38   raw -> extreme bullish
     adjusted: 2.14   [MILDLY BEARISH] after stripping 84% lottery calls

XLI at 5.32 = someone bought roughly 5 puts for every 1 call on the entire US industrial sector while the broad market was pricing in upside. RXRX looked like a strong buy until the filter ran — 84% of the call volume was sub-$0.10 lottery tickets.

Full writeup: XLI P/C 5.32 -> Full writeup: lottery-call filter ->


Skills

Free — clone and use immediately

Skill What it does Key number
EV Calculator — Live on Agensi Probability-weighted bull/base/bear scenario analysis 3 scenarios -> 1 decision
News Sentiment Engine — Live on Agensi 200+ RSS articles scored by ticker/sector, Telegram delivery 2 hrs reading -> 5 min digest

Pro Bundle — $29 one-time

Skill What it does Key number
Options Flow Analyzer P/C ratio scanner with lottery-call filter Caught XLI 5.32, RXRX 84% lottery
Investment Briefing Agent 9-wave morning analysis: macro -> sector -> technicals -> news -> critique -> simulation Full brief in under 5 min
Price Monitor & Alert Stop-loss/take-profit with Telegram alerts Alert delivery under 2 seconds
Multi-Agent Orchestrator Parallel agent teams with built-in quality harness 4 agents, 1 consensus output

Get the Pro Bundle — $29 ->

The free skills show the architecture. The pro bundle is what runs every trading day.

Dev Tools — free, no investment needed

Skill What it does
Git Standup Reads 24h git log → writes your standup (yesterday/today/blockers)
PR Review Prep Reads git diff → generates PR description, test plan, risk assessment
Claude Cost Tracker Breaks down API spend by model/project, flags Opus→Sonnet downgrade candidates
Commit Roast Brutally honest code review of your commit history. 30% comedy, 70% real feedback
Context Budget Tracks context window usage, warns at 85%, generates session checkpoint files
Debug Trail Auto-documents debugging sessions including dead ends. Generates structured bug reports

No API keys needed for any dev tool. Just git and Claude Code.


Why the lottery-call filter matters

Raw put/call ratios are broken for tickers with high retail options activity.

RXRX last week: raw P/C 0.38 -> flagged extreme bullish. After stripping 84% lottery calls (delta mildly bearish. A scanner without filtering would have sent a strong buy signal into a bearish setup.

CEG last week: raw P/C 1.06 -> neutral. After stripping 98.4% lottery calls: adjusted P/C 59.2 -> extreme bearish. The “neutral” reading was institutions selling premium into retail lottery-buying.

Without the filter: you read retail noise. With the filter: you see what institutions are doing.

Full explanation ->


Live output examples

Options scanner

[SCAN] 2026-05-13 -- 23 tickers, 847 contracts

XLI  P/C raw: 5.32  adjusted: 5.31  -> INSTITUTIONAL HEDGE SIGNAL
CEG  P/C raw: 1.06  adjusted: 59.2  -> EXTREME BEARISH (98.4% lottery stripped)
RXRX P/C raw: 0.38  adjusted: 2.14  -> MILDLY BEARISH (84% lottery stripped)
SPY  P/C raw: 0.44  adjusted: 0.44  -> normal

Morning briefing (9-wave)

[2026-05-13 06:00 KST] Investment Briefing -- Wave Summary

Wave 1 (Macro):      Rates flat, dollar soft. Modest risk-on.
Wave 2 (Sector):     Tech leading. Industrials lagging -- XLI hedge signal persistent.
Wave 3 (Technical):  SPY above 50-day. IWM at resistance.
Wave 4 (News):       No material catalysts. Fed speakers today.
Wave 5 (Critique):   Bullish case assumes no macro deterioration. Watch jobs Friday.
Wave 6 (Simulation): If XLI hedge resolves bearish: reduce cyclical 10-15%.
...
Consensus: Hold current allocation. Flag XLI for session 3 monitoring.

Price monitor alert

[ALERT] TEM -- Stop-loss triggered
Price: $47.13  |  Threshold: $47.50
Time: 09:34 KST  |  Alert delivered: 1.8s

Action: Review position sizing. Exit if conviction unchanged.

Installation

# Free skills
cp ev-calculator/SKILL.md ~/.claude/skills/ev-calculator.md
cp news-sentiment-engine/SKILL.md ~/.claude/skills/news-sentiment-engine.md

# Pro bundle -- download from Gumroad, then:
cp options-flow-analyzer/SKILL.md ~/.claude/skills/options-flow-analyzer.md
cp investment-briefing-agent/SKILL.md ~/.claude/skills/investment-briefing-agent.md
cp price-monitor-alert/SKILL.md ~/.claude/skills/price-monitor-alert.md
cp multi-agent-orchestrator/SKILL.md ~/.claude/skills/multi-agent-orchestrator.md

Works with Claude Code, Cursor, Codex CLI, Gemini CLI — any agent supporting the SKILL.md standard.


Options Analysis API (NEW)

Live lottery-filtered options analysis. Returns adjusted P/C ratios with signal classification.

GET /api/v1/options/scan?ticker=RXRX

{
  "ticker": "RXRX",
  "price": 3.01,
  "raw_pc": 0.29,
  "adjusted_pc": 1.73,
  "lottery_pct": 64.92,
  "signal": "bearish",
  "call_volume": 5416,
  "put_volume": 3282,
  "avg_iv": 149.41
}

Bulk scan up to 10 tickers: /api/v1/options/bulk?tickers=RXRX,TEM,CEG

Free tier: 5 requests/day. Docs at /api/docs.


Eval Fixtures

Test the lottery filter against real-world noisy options chains:

npx tsx test/lottery-filter.test.ts
# 12 passed, 0 failed

npx tsx test/eval-fixture.test.ts
# 23 passed, 0 failed
  • test/fixtures/rxrx-noisy-options.json — 84% lottery, signal inversion (raw bullish → adjusted bearish)
  • test/fixtures/cel-clean-options.json — 5% lottery, no inversion (control)
  • test/fixtures/rxrx-eval-fixture.json — full schema with signal/reasoning/outcome separation

dev.to series: Building in Public

Real results from running these skills on a live portfolio.


Follow along

Options Anomaly Weekly — every Monday, the top 3 scanner signals with interpretation. Free.

GitHub Discussions — live scanner output and Q&A.


Author

@tellmefrankie — running this system daily on a real portfolio.

License

MIT


View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add tellmefrankie/ai-investment-skills