Bring AlphaGBM into your own AI workspace.
29 open skills for real-time market data, opportunity scoring, research and verification · Built for AI agents
Website · Documentation · Quick Start · Contributing
See the Skills v2 audit for the current capability map and release gates.
git clone https://github.com/AlphaGBM/skills.git .claude/skills/alphagbmThen ask your AI: "Show an AlphaGBM options demo using bundled sample data." Demo output is not live data. Use the API connection below for current results.
AlphaGBM is a real-data market intelligence layer for traders and AI agents. It connects live market data, quantitative scoring, research workflows and ongoing verification to the tools people already use.
These 29 skills bring AlphaGBM's capabilities into Claude Code, Cursor, Windsurf, Codex, WorkBuddy or any agent that supports skills.
| Capability | What the Skills provide |
|---|---|
| Data access | Call AlphaGBM APIs from your AI workspace; distinguish live responses from bundled demos |
| Options intelligence | Scoring, volatility, Greeks and strategy workflows with endpoint-specific contracts |
| Stock research | Fundamental, sentiment and risk analysis; risk scores are not return probabilities |
| Published research | Read public abstracts and preserve source links, publication times and evidence when provided; full research access may be tier-gated |
| Shared account | Authenticated calls use the account behind your API key, not a separate Skills allowance |
| Investor frameworks | Optional research lenses, distinct from validated scoring models |
Market coverage, data freshness and API-key access vary by endpoint. Private Research Brain and newer multi-asset workflows remain under contract review; their presence in the product is not a blanket API-access guarantee.
# Clone into your project
git clone https://github.com/AlphaGBM/skills.git .claude/skills/alphagbm
# Or add as submodule
git submodule add https://github.com/AlphaGBM/skills.git .claude/skills/alphagbmgit clone https://github.com/AlphaGBM/skills.git .cursor/skills/alphagbm# Clone and install
git clone https://github.com/AlphaGBM/skills.git
cd skills/cli
pip install -e .
# Set your API key
alphagbm config set-key agbm_xxxxxxxxxxxxxxxx
# Start analyzing
alphagbm stock analyze AAPL
alphagbm options score NVDASee cli/README.md for full CLI documentation.
Selected market tools include bundled samples for AAPL, NVDA, SPY, TSLA and META. Explicitly request demo mode to use them; never present a stored sample as a current quote. Research Insights uses published articles, not bundled samples.
"Analyze AAPL stock using AlphaGBM" "Score NVDA options" "Show me TSLA's volatility surface" "What's the best bullish strategy for META?"
# Set your API key for real-time data
export ALPHAGBM_API_KEY=agbm_xxxxxxxxxxxxxxxx
export ALPHAGBM_BASE_URL=https://alphagbm.zeabur.app # optional, this is the default
# Get your free key at https://alphagbm.com/api-keyscurl https://alphagbm.zeabur.app/api/healthReturns API status, available data fields, data source health, and market coverage — no auth needed. Useful for AI agents to verify what's available before making calls.
Authenticated calls use the account associated with your API key; installing a Skill does not create a separate allowance. Access, quota and cache behavior depend on the endpoint and deployed environment. Consult your account for current limits rather than assuming a cached call is free. The current public Research Insights reader exposes published summaries; the product may gate full reports, deeper interpretation and ongoing verification behind account access.
| Skill | What It Does | Example Query |
|---|---|---|
| Stock Analysis | G=B+M model: fundamentals, momentum, EV, risk score, AI report | "Analyze AAPL" |
| Options Score | Score 0-100 across 4 strategies (Sell Put/Call, Buy Put/Call) | "Best NVDA call to buy" |
| Options Strategy | Strategy builder + scanner with 15+ templates | "Bullish play on TSLA" |
| Vol Surface | 3D implied volatility across strikes & expiries | "Is AAPL IV expensive?" |
| Vol Smile | Skew analysis for a single expiration | "NVDA put skew" |
| Greeks | Greeks calculator + implied volatility solver | "Greeks for AAPL 220C" |
| P&L Simulator | What-if analysis for any position | "Simulate my iron condor" |
| Chokepoint Analysis | Map supply-chain bottlenecks and test concentration, irreplaceability and demand tension | "Find AI supply-chain chokepoints" |
| Skill | What It Does | Example Query |
|---|---|---|
| IV Rank | IV percentile vs. 252-day history | "Is TSLA IV high?" |
| Earnings IV Panel | Crush history + implied move + IV Rank tag + priced Iron Condor | "Iron Condor for META earnings" |
| Unusual Activity | Smart money / large block detection | "Unusual options flow today" |
| Market Sentiment | VIX, Put/Call, Fear & Greed dashboard | "Market sentiment now" |
| VIX Status ✨ | 5-tier fear thermometer: calm / normal / seller sweet spot / caution / extreme fear | "Is this a good time for BPS?" |
| FearScore ✨ | Per-ticker 6-indicator panic composite; ≥60 is BPS entry signal | "Fear score QQQ", "is NVDA oversold" |
| Skill | What It Does | Example Query |
|---|---|---|
| Compare | Side-by-side stock & options comparison | "AAPL vs MSFT" |
| Watchlist | Monitor tickers for key changes | "Add NVDA to watchlist" |
| Alert | Set IV, price, or activity alerts | "Alert if TSLA IV > 80" |
| Polymarket | Prediction market vs. options pricing | "Rate cut odds vs options" |
Exit, hedge, and sizing decisions quantified from real data — not opinion.
| Skill | What It Does | Example Query |
|---|---|---|
| Hedge Advisor ✨ | Scenario-driven hedge for an existing position (Falling Knife / Bottom Fishing / Gain Protection); returns priced Long Put / Collar / Tier-down specs | "Hedge my AAPL at cost 140, now 180" |
| BPS Backtest ✨ | Walk-forward backtest of Bull Put Spread with signal vs no-signal control in one call | "Backtest BPS on QQQ — does FearScore work?" |
| Take-Profit Lab ✨ | Any-ticker 15-strategy exit backtest; auto-classifies whether it's holdable or needs tiered exit via a novel "rollercoaster rate" metric | "Should I hold TQQQ long-term?" |
Mechanical translations of specific investors' philosophies into one-call tools.
| Skill | What It Does | Example Query |
|---|---|---|
| Duan-Yongping Analysis | Three-panel seller playbook (Sell Put at willing-buy price / Covered Call yield / VIX-tier panic-buy context) | "Duan-style analysis on AAPL" |
| Buffett Analysis ✨ | 4-lens scorecard (business / moat / management / valuation) → weighted HOLDABLE / WATCHABLE / AVOID verdict for any ticker | "Buffett analysis on KO" |
| Marks Cycle ✨ | Howard Marks-style cycle position 0-100 blending VIX + IV Rank + P/C + valuation; maps to offense/defense posture. Authenticated signal, no analysis-credit deduction | "Where are we in the cycle?" |
| Tepper Signal ✨ | Quantified Tepper 2009/2020 panic-buy detector: VIX ≥ 35 + FearScore ≥ 80 + quality filter → armed/watch/near/cold | "Is this a Tepper buy signal?" |
Build a personal, monitored research workspace. Profiles auto-refresh, theses get checked against triggers, the system audits itself weekly.
| Skill | What It Does | Example Query |
|---|---|---|
| Company Profile | Auto-built research files: fundamentals, PE/PB band, red flags, event radar | "Add NVDA to my knowledge base" |
| Investment Thesis | Buy reasons + structured sell triggers, monitored automatically | "Why did I buy AAPL?" |
| Macro View | Track VIX / US10Y / DXY / gold with portfolio-aware impact analysis | "Track VIX and US10Y" |
| Theme Research | Group tickers into themes (AI infra, HK dividend) + news keyword watching | "Create an AI infra theme" |
| Health Check | Weekly audit: stale profiles, thesis drift, orphan pages → 0-100 score | "Audit my research brain" |
| Research Insights | Retrieve published AlphaGBM research with market, tag, date and source metadata | "Show the latest semiconductor research" |
- Investment Masters -- 12 masters' methodologies (Buffett, Dalio, Soros, Marks, Liang Wenfeng, Raschke...) + 13F tracking
You / Your AI Agent
| (natural language)
+------------------------------------------------------+
| AlphaGBM Skills (this repo) |
| |
| Stock Options Vol Strategy Greeks ... |
| Analysis Score Surface Builder Dashboard |
+-------------------------+-----------------------------+
|
+----------+----------+
v v
Mock Data AlphaGBM API
(built-in, free) (alphagbm.zeabur.app)
Real-time market data
IV/HV/VRP/Greeks/Skew
Skills aren't isolated -- they reference each other to form a complete workflow:
Stock Analysis --> Options Score --> Options Strategy --> P&L Simulator
| | |
v v v
Compare Vol Surface Greeks
Vol Smile
IV Rank --> Earnings Crush
Market Sentiment --> Unusual Activity --> Alert
Watchlist
Polymarket --> Market Sentiment --> Options Strategy
| Market | Stocks | Options | Data Points |
|---|---|---|---|
| US | 200+ | Full chains | IV/HV/VRP/Greeks/Skew/Surface |
| HK | 35+ | Full chains | IV/HV/VRP/Greeks |
| CN | 20+ ETFs | Full chains | IV/HV/VRP/Greeks |
| Commodities | Au/Ag/Cu/Al | Futures options | IV/Greeks/Delivery risk |
Illustrative metrics below are not current quotes. Preserve actual source, timestamp and missing-data fields when interpreting API responses:
| Metric | Value | How It's Computed |
|---|---|---|
| IV | 32.5% | Black-Scholes on actual bid/ask prices |
| IV Rank | 58 | Current IV vs. 252 trading days of history |
| VRP | +4.0% | Implied Vol - Historical Vol — measures option overpricing |
| Option Score | 80/100 | Weighted: premium yield + support/resistance + safety margin + trend + PoP + liquidity + time decay |
| Stock Risk | API value | risk.score describes risk, not an opportunity score or probability of profit |
| Risk | 4/10 | Additive: valuation +2, growth +2, liquidity +2, market +1.5, technical +1 |
| EV | +5.2% | 50% × 1w + 30% × 1m + 20% × 3m expected value |
This is not "based on my training data" or "I estimate with 85% confidence."
This is math on market data.
You: "Analyze AAPL, then find the best options play"
The agent chains skills automatically:
1. GET /api/stock/quick-quote/AAPL → $261.40 (-0.8%)
2. POST /api/stock/analyze-sync → G=B+M score 7.0/10, EV +5.2%, BUY
{"ticker": "AAPL", "style": "balanced"} Risk 4/10, target $275, stop-loss $239
3. GET /api/options/snapshot/AAPL → IV 32.5%, IV Rank 58, VRP +4.0%
4. POST /api/options/chain-sync → Sell Put scores: 80, 78, 75...
{"symbol": "AAPL", "expiry_date": "..."} Buy Call scores: 76, 74, 72...
5. POST /api/options/tools/strategy/build → Bull Call Spread 265/280
{"template_id": "bull_call_spread"} Max profit $1085, max loss $415
6. POST /api/options/tools/simulate → Breakeven $269.15, PoP 44.5%
{"symbol": "AAPL", "legs": [...]}
You: "Is that IV expensive?"
7. GET /api/options/snapshot/AAPL → IV Rank 58 (moderate)
8. GET /api/options/tools/vol-surface/AAPL → ATM IV in contango, earnings in 26d
All from real API calls. All verifiable.
- 29 Skill definitions; selected market tools include demo data
- Claude Code & Cursor support
- CLI tool (
pip install -e ./cli) - Real-time WebSocket feeds
- Community strategy sharing
- More markets (EU, JP, KR options)
See CONTRIBUTING.md for guidelines. We welcome:
- Bug reports & feature requests
- Skill improvements & new skill proposals
- Translations (currently EN + CN)
- Mock data for additional tickers
MIT -- see LICENSE.
- alphagbm.com -- Full platform with live data
- API Documentation
- Discord Community
- Twitter/X
Built by the AlphaGBM team.
Real data. Real signals. Real edge.
