SkillAgentSearch skills...

pead-screener

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns. Analyzes weekly candle formation to detect red candle pullbacks and breakout signals. Supports two input modes - FMP earnings calendar (Mode A) or earnings-trade-analyzer JSON output (Mode B)

Install / Use

npx skills add tradermonty/claude-trading-skills --skill pead-screener

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Supported Platforms

Universal

Tags

Our assessment of pead-screener

pead-screener scores 88/100 on our quality scale, 184th of 319 Customer Support skills we index.

Its SKILL.md is 4.4 KB long, well organised into 14 sections with 2 code examples: a solid amount of guidance for an agent.

With 2,885 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so pead-screener is actively maintained.
  • Our last check on 2026-11-01 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

pead-screener compared with similar skills

All 4 of these similar skills score higher than pead-screener; compare them before choosing.

SkillScoreStarsUpdatedFormat
pead-screener (this skill)by tradermonty882.9k53d agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install pead-screener?
Run npx skills add tradermonty/claude-trading-skills --skill pead-screener. The install tabs above show the steps for each supported agent.
Which AI agents does pead-screener work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is pead-screener safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is pead-screener still maintained?
The repository was last updated about 2 months ago, so pead-screener is actively maintained.

name: pead-screener description: Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns. Analyzes weekly candle formation to detect red candle pullbacks and breakout signals. Supports two input modes - FMP earnings calendar (Mode A) or earnings-trade-analyzer JSON output (Mode B). Use when user asks about PEAD screening, post-earnings drift, earnings gap follow-through, red candle breakout patterns, or weekly earnings momentum setups.

PEAD Screener - Post-Earnings Announcement Drift

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns using weekly candle analysis to detect red candle pullbacks and breakout signals.

When to Use

  • User asks for PEAD screening or post-earnings drift analysis
  • User wants to find earnings gap-up stocks with follow-through potential
  • User requests red candle breakout patterns after earnings
  • User asks for weekly earnings momentum setups
  • User provides earnings-trade-analyzer JSON output for further screening

Prerequisites

  • FMP API key (set FMP_API_KEY environment variable or pass --api-key)
    export FMP_API_KEY=your_api_key_here
    
  • Free tier (250 calls/day) is sufficient for default screening
  • For Mode B: earnings-trade-analyzer JSON output file with schema_version "1.0"

Workflow

Step 1: Prepare and Execute Screening

Run the PEAD screener script in one of two modes:

Mode A (FMP earnings calendar):

# Default: last 14 days of earnings, 5-week monitoring window
python3 skills/pead-screener/scripts/screen_pead.py --output-dir reports/

# Custom parameters
python3 skills/pead-screener/scripts/screen_pead.py \
  --lookback-days 21 \
  --watch-weeks 6 \
  --min-gap 5.0 \
  --min-market-cap 1000000000 \
  --output-dir reports/

Mode B (earnings-trade-analyzer JSON input):

# From earnings-trade-analyzer output
python3 skills/pead-screener/scripts/screen_pead.py \
  --candidates-json reports/earnings_trade_analyzer_YYYY-MM-DD_HHMMSS.json \
  --min-grade B \
  --output-dir reports/

Scheduled US-equity routine pitfall: Prefer Mode B for pre-market / US-equity cron briefs after running earnings-trade-analyzer. Mode A can pull the global FMP earnings calendar, spend the API budget on non-US symbols, and return weak/non-actionable foreign listings before reaching the intended US watchlist. If Mode A is used anyway and the script reports budget trimming or non-US symbols, mark PEAD output as degraded and treat it as manual-review only rather than a clean candidate source.

Step 2: Review Results

  1. Read the generated JSON and Markdown reports
  2. Load references/pead_strategy.md for PEAD theory and pattern context
  3. Load references/entry_exit_rules.md for trade management rules

Step 3: Present Analysis

For each candidate, present:

  • Stage classification (MONITORING, SIGNAL_READY, BREAKOUT, EXPIRED)
  • Weekly candle pattern details (red candle location, breakout status)
  • Composite score and rating
  • Trade setup: entry, stop-loss, target, risk/reward ratio
  • Liquidity metrics (ADV20, average volume)

Step 4: Provide Actionable Guidance

Based on stages and ratings:

  • BREAKOUT + Strong Setup (85+): High-conviction PEAD trade, full position size
  • BREAKOUT + Good Setup (70-84): Solid PEAD setup, standard position size
  • SIGNAL_READY: Red candle formed, set alert for breakout above red candle high
  • MONITORING: Post-earnings, no red candle yet, add to watchlist
  • EXPIRED: Beyond monitoring window, remove from watchlist

Output

  • pead_screener_YYYY-MM-DD_HHMMSS.json - Structured results with stage classification
  • pead_screener_YYYY-MM-DD_HHMMSS.md - Human-readable report grouped by stage

Unknown earnings timing

FMP does not confirm a bmo/amc session for every earnings row; unconfirmed rows carry earnings_timing: "unknown" in Mode A and the price gap calculation assumes the AMC window as a fallback. The Mode A report shows timing_unknown_count out of timing_candidates_total so this assumption stays visible (Mode B reports n/a since timing is inherited from the input JSON). timing_candidates_total is the post-budget-trim population that was actually analyzed, not the raw earnings-calendar row count.

Resources

  • references/pead_strategy.md - PEAD theory and weekly candle approach
  • references/entry_exit_rules.md - Entry, exit, and position sizing rules

Related Skills

View on GitHub
GitHub Stars2.9k
CategoryCustomer
Updated1mo ago
Forks655

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions