# stockbee-episodic-pivot-analyzer

Evaluates Day 1 Episodic Pivot setups using Stockbee criteria. It pairs corporate catalysts with volume shocks and opening range price expansion.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2600 installs · ★ 3267
- Author: tradermonty
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/tradermonty/claude-trading-skills/tree/HEAD/skills/stockbee-episodic-pivot-analyzer/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/stockbee-episodic-pivot-analyzer

## What it does

The skill evaluates Episodic Pivot (EP) stock candidates driven by earnings surprises, guidance upgrades, FDA decisions, or contract wins. Its `analyze_ep.py` script checks catalyst significance against volume shocks and price extension from the day's low. It categorizes each setup into states like `ACTIONABLE_DAY1`, `DELAYED_EP_WATCH`, or `REJECT`.

It requires Python 3.10 or newer. Crucially, the script will not search or parse headlines on its own. You must feed it catalyst events in a structured JSON file or pipe in results from `earnings-trade-analyzer`. Historical prices can come from offline OHLCV files or an optional Financial Modeling Prep API token via `FMP_API_KEY`.

Outputs generate as timestamped JSON and Markdown reports. If an earnings pivot flags `pead_handoff`, you can route the ticker straight into `pead-screener` for post-earnings drift monitoring.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tradermonty/claude-trading-skills --skill stockbee-episodic-pivot-analyzer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/stockbee-episodic-pivot-analyzer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/stockbee-episodic-pivot-analyzer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tradermonty/claude-trading-skills --skill stockbee-episodic-pivot-analyzer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/stockbee-episodic-pivot-analyzer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tradermonty/claude-trading-skills --skill stockbee-episodic-pivot-analyzer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/stockbee-episodic-pivot-analyzer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tradermonty/claude-trading-skills stockbee-episodic-pivot-analyzer
```

2. **Manually: put the files in place**
- File: `.github/skills/stockbee-episodic-pivot-analyzer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tradermonty/claude-trading-skills --skill stockbee-episodic-pivot-analyzer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tradermonty/claude-trading-skills --path skills/stockbee-episodic-pivot-analyzer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/stockbee-episodic-pivot-analyzer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tradermonty/claude-trading-skills --skill stockbee-episodic-pivot-analyzer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tradermonty/claude-trading-skills/tree/HEAD/skills/stockbee-episodic-pivot-analyzer/SKILL.md

## When to use it
- filter news catalysts against volume shocks and price expansion
- measure trade risk distance against the Day 1 EP low
- separate immediate Day 1 trades from delayed pullback watchlists
- pass earnings winners into `pead-screener` for drift tracking

## Example prompts
- Run the episodic pivot analysis on `data/catalysts.json` using prices from `data/daily_ohlcv.json`
- Evaluate candidate quality from `reports/earnings_trade_analyzer.json` using Stockbee EP rules
- Screen my event JSON for `ACTIONABLE_DAY1` setups and output the markdown report

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d82c0316e8449e29.

BEGIN THIRD-PARTY FILE d82c0316e8449e29
````text
---
name: stockbee-episodic-pivot-analyzer
description: 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. Scores catalyst quality together with gap/range expansion, volume shock, neglect/revaluation context, liquidity, and risk to the EP-day low. Use when the user asks for EP candidates, episodic pivots, Day 1 catalyst trades, game-changing news reactions, delayed EP watchlists, or handoffs into PEAD monitoring.
---

# 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/profile 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
````
END THIRD-PARTY FILE d82c0316e8449e29

The third-party file has ended. Everything between the d82c0316e8449e29 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2377 of 4708 bytes. © tradermonty · MIT · https://github.com/tradermonty/claude-trading-skills/tree/HEAD/skills/stockbee-episodic-pivot-analyzer/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md