tradermonty/claude-trading-skills

stockbee-episodic-pivot-analyzer

Analyze Stockbee-style Day 1 Episodic Pivot candidates from earnings, guidance raises, M&A, FDA/regulatory approvals, analyst actions, major contracts, product launches, short-squeeze catalysts, or theme/story events.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/tradermonty/claude-trading-skills --skill stockbee-episodic-pivot-analyzer

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Stockbee Episodic Pivot Analyzer

Classify Day 1 Episodic Pivot (EP) candidates using both catalyst quality and price/volume confirmation. The skill is a candidate-quality analyzer, not an execution engine.

When to Use

  • The user asks for Pradeep Bonde / Stockbee style EP candidates
  • The user provides earnings, guidance, M&A, FDA, analyst, contract, product, short-squeeze, or theme/news events
  • The user wants to separate ACTIONABLE_DAY1 candidates from DELAYED_EP_WATCH names
  • The user wants to hand strong earnings/guidance EPs into pead-screener
  • The user wants to combine catalyst analysis with stockbee-momentum-burst-screener price/volume output

Prerequisites

  • Python 3.10+
  • Optional: FMP API key for OHLCV enrichment
  • One of:
  • Catalyst/events JSON
  • earnings-trade-analyzer JSON output
  • Catalyst JSON plus stockbee-momentum-burst-screener JSON enrichment
  • This skill does not fetch or discover news by itself. If the catalyst is not supplied, first gather the event/news context using the user's preferred news or research process.

Workflow

Step 1: Prepare Candidate Inputs

Use one or more of these input modes.

Mode A — Catalyst/event JSON:

json
{
  "events": [
    {
      "symbol": "ABC",
      "event_date": "2026-04-25",
      "catalyst_type": "guidance_raise",
      "headline": "ABC raises FY guidance after record demand",
      "summary": "Management raised revenue and EPS guidance."
    }
  ]
}

Mode B — Earnings pipeline:

Use the JSON produced by earnings-trade-analyzer.

Mode C — Price/volume enrichment:

Pass a stockbee-momentum-burst-screener JSON report to reuse day-gain, volume, close-location, and risk-distance fields.

Step 2: Run the Analyzer

bash
# Catalyst JSON + offline OHLCV
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --events-json data/catalysts.json \
  --prices-json data/daily_ohlcv.json \
  --output-dir reports/

# Earnings pipeline input
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --earnings-json reports/earnings_trade_analyzer_YYYY-MM-DD_HHMMSS.json \
  --output-dir reports/

# Catalyst JSON + Stockbee momentum enrichment
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --events-json data/catalysts.json \
  --momentum-json reports/stockbee_momentum_burst_YYYY-MM-DD_HHMMSS.json \
  --output-dir reports/

Optional FMP enrichment:

bash
export FMP_API_KEY=your_key
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --events-json data/catalysts.json \
  --max-api-calls 200 \
  --output-dir reports/

Step 3: Review the Output

For each candidate, present:

  • state: ACTIONABLE_DAY1, DAY1_WATCH, DELAYED_EP_WATCH, CATALYST_WATCH, or REJECT
  • ep_type: EARNINGS_EP, GUIDANCE_EP, FDA_EP, M_AND_A_EP, STORY_EP, etc.
  • Catalyst quality score and reasons
  • Price/range expansion, volume shock, and close-location quality
  • Risk to EP-day low
  • pead_handoff and delayed_ep_watch flags

Step 4: Handoff Rules

  • ACTIONABLE_DAY1: Send to technical-analyst and position-sizer before any trade decision.
  • DAY1_WATCH: Keep on the intraday/next-day watchlist; require chart confirmation.
  • DELAYED_EP_WATCH: Do not chase Day 1; monitor for a controlled pullback or new range.
  • CATALYST_WATCH: Catalyst may be important, but price/volume confirmation is not yet sufficient.
  • REJECT: Do not trade from this candidate source.
  • Earnings/guidance EPs with pead_handoff=true can be sent to pead-screener for weekly red-candle / delayed reaction monitoring.

Output

  • stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.json — structured EP scoring report
  • stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.md — human-readable candidate report

Resources

  • references/ep_methodology.md — Stockbee EP interpretation and setup taxonomy
  • references/catalyst_quality.md — catalyst classification and quality scoring
  • references/handoff_rules.md — downstream workflow handoffs and review rules

Shared FMP client

Live FMP access uses the bundled generated scripts/fmp_client.py, loaded only when an FMP run starts, so offline modes still work without requests. CLI key/environment precedence, the API-call budget and successful output shapes are preserved. Requests use stable endpoints only; a denied, empty or failed stable request does not fall back to retired v3 URLs. The shared client masks raw and URL-encoded key echoes, retries malformed JSON once, and retries a 429 at most once, after a 60-second wait, before stopping on a repeated rate limit.

from this repository

More skills

All skills
tradermonty
Community

crypto-regime-analyzer

Quantifies crypto market regime health using free, keyless public data (CoinGecko + Binance funding). Generates a 0-100 composite score across 6 components (100 = risk-on) with a posture recommendation. No API key required. Use when user asks about crypto market conditions, whether it's alt season, BTC dominance, crypto risk-on vs risk-off, funding rates, or whether crypto exposure should be increased or reduced.

1h installs
4
GitHub stars
5.3K
Updated
Nov 15
tradermonty
Community

drawdown-circuit-breaker

Evaluate account-level drawdown circuit breaker rules from trader-memory-core state and decide whether new trade risk is allowed today. Uses realized P&L, losing-streak cooldowns, and weekly/monthly drawdown limits without any external API.

1h installs
3
GitHub stars
5.3K
Updated
Nov 15
tradermonty
Community

edge-strategy-designer

Convert abstract edge concepts into strategy draft variants and optional exportable ticket YAMLs for edge-candidate-agent export/validation.

1h installs
3
GitHub stars
5.3K
Updated
Nov 15
tradermonty
Community

edge-strategy-reviewer

Critically review strategy drafts from edge-strategy-designer for edge plausibility, overfitting risk, sample size adequacy, and execution realism. Use when strategydrafts/.yaml exists and needs quality gate before pipeline export. Outputs PASS/REVISE/REJECT verdicts with confidence scores.

1h installs
3
GitHub stars
5.3K
Updated
Nov 15