Agent skill

Pead Screener

by tradermonty in tradermonty/claude-trading-skills

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns.

MITAuto-check passedBusiness, Finance & HR

Install Pead Screener

skills CLI
$ npx skills add tradermonty/claude-trading-skills --skill pead-screener -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tradermonty/claude-trading-skills pead-screener --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tradermonty/claude-trading-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pead-screener .claude/skills/pead-screener && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pead-screener
GitHub stars
3k
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
431 words
Files
16 (incl. scripts, references)
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns.

  • Works in 4 steps: Prepare and Execute Screening → Review Results → Present Analysis → …
  • User asks about PEAD screening
  • SKILL.md covers When to Use, Prerequisites, Workflow and Output, plus 1 more section
  • Runs Python scripts from its folder; calls python3; needs FMP_API_KEY

What it does

Pead Screener is an agent skill from tradermonty/claude-trading-skills. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts and reference files (for example `references/entry_exit_rules.md`, `references/pead_strategy.md` and `scripts/_fmp_compat.py`).

It sits in Business, Finance & HR. The repository describes itself as: Claude Code skills for equity investors and traders — market analysis, technical charting, economic calendars, screeners, and trading strategy development. The licence is MIT.

When your agent uses it

  • User asks about PEAD screening
  • Post-earnings drift
  • Earnings gap follow-through
  • Red candle breakout patterns

Example prompts

  • “/pead-screener”

Requirements

  • Python 3
  • A credential in FMP_API_KEY

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Prepare and Execute Screening
  2. Review Results
  3. Present Analysis
  4. Provide Actionable Guidance

What it can do on your machine

Read from SKILL.md and the folder at commit c8d58f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 12 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FMP_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pead Screener loads about 1.1k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 431 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from tradermonty/claude-trading-skills at commit c8d58f0, republished under its MIT licence (© tradermonty). 431 words, ~1,118 tokens.

Download SKILL.mdSave it as .claude/skills/pead-screener/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
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)
    bash
    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):

bash
# 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):

bash
# 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)
Show full SKILL.md (161 more words)Show less
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

© tradermonty, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files (scripts, references) in skills/pead-screener of tradermonty/claude-trading-skills.

  • SKILL.md
  • references/entry_exit_rules.md
  • references/pead_strategy.md
  • requirements.txt
  • scripts/_fmp_compat.py
  • scripts/calculators/__init__.py
  • scripts/calculators/breakout_calculator.py
  • scripts/calculators/liquidity_calculator.py
  • scripts/calculators/risk_reward_calculator.py
  • scripts/calculators/weekly_candle_calculator.py
  • scripts/fmp_client.py
  • scripts/report_generator.py
  • scripts/scorer.py
  • scripts/screen_pead.py
  • scripts/tests/conftest.py
  • scripts/tests/test_pead_screener.py

Open the folder on GitHubat commit c8d58f0

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in tradermonty/claude-trading-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Pead Screener next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pead Screener compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pead Screener this skilltradermonty/claude-trading-skills3k1 repos~1.1kAutomated safety check: PassMIT
Creating Financial ModelsChen-zexi/open-ptc-agent7293 repos~1.3kAutomated safety check: PassMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Itr Walakaranb192/itr-wala871—~3.6kAutomated safety check: PassMIT
Tushare Datazillionare/zillionare3222 repos~2.3kAutomated safety check: PassNone
Cc Sdd New Agentgotalab/cc-sdd3.7k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Creating Financial Models

    Chen-zexi/open-ptc-agent

    This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions

    729 GitHub starsUsed in 3 repos~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Itr Wala

    karanb192/itr-wala

    File Indian income tax returns (ITR) for FY 2025-26 / AY 2026-27.

    871 GitHub stars~3.6k tokensUpdated 7 days ago
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    322 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Cc Sdd New Agent

    gotalab/cc-sdd

    Add or extend coding-agent support in cc-sdd by executing the SOP in docs/cc-sdd/sop-new-agent.md end-to-end.

    3.7k GitHub stars~1.1k tokensUpdated 18 days ago
    Business, Finance & HRAuto-check passed
  • DBS Business Toolkit Entry

    dontbesilent2025/dbskill

    Chinese-language entry skill for the dontbesilent business toolkit: onboards new users, orchestrates tasks across sub-skills, runs numbered prompts and lists hidden ones.

    11k GitHub stars~2k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from tradermonty/claude-trading-skills

All 74 skills in this repo
  • Technical Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing weekly price charts for stocks, stock indices, cryptocurrencies, or forex pairs.

    3k GitHub starsUsed in 4 repos~4.6k tokens
    Auto-check passed
  • Theme Detector

    tradermonty/claude-trading-skills

    Detect and analyze trending market themes across sectors. An agent skill from tradermonty/claude-trading-skills.

    3k GitHub starsUsed in 2 repos~4.9k tokens
    Auto-check passed
  • Trader Memory Core

    tradermonty/claude-trading-skills

    Track investment theses across their lifecycle — from screening idea to closed position with postmortem.

    3k GitHub starsUsed in 2 repos~4.3k tokens
    Auto-check passed
  • Edge Strategy Reviewer

    tradermonty/claude-trading-skills

    Critically review strategy drafts from edge-strategy-designer for edge plausibility, overfitting risk, sample size adequacy, and execution realism.

    3k GitHub starsUsed in 1 repo~988 tokens
    Auto-check passed
  • Sector Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing sector rotation patterns and market cycle positioning.

    3k GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Stanley Druckenmiller Investment

    tradermonty/claude-trading-skills

    Druckenmiller Strategy Synthesizer - Integrates 8 upstream skill outputs (Market Breadth, Uptrend Analysis, Market Top, Macro Regime, FTD Detector, VCP Screener, Theme Detector, CANSLIM Screener)…

    3k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

Questions about Pead Screener

What does Pead Screener do?

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns. Pead Screener is an agent skill from tradermonty/claude-trading-skills. Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns.

When should I use Pead Screener?

Pead Screener fits situations like: user asks about PEAD screening; post-earnings drift; earnings gap follow-through; red candle breakout patterns.

How do I install Pead Screener in Claude Code?

Run `npx skills add tradermonty/claude-trading-skills --skill pead-screener -a claude-code`. Or copy the skill folder (skills/pead-screener in tradermonty/claude-trading-skills) into .claude/skills/pead-screener in your project. Claude Code loads it when a task matches its description.

How do I install Pead Screener in Codex?

Run `npx skills add tradermonty/claude-trading-skills --skill pead-screener -a codex`. Or copy the skill folder (skills/pead-screener in tradermonty/claude-trading-skills) into .agents/skills/pead-screener in your project. Codex loads it when a task matches its description.

Can I use Pead Screener in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tradermonty/claude-trading-skills --skill pead-screener -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pead-screener, .gemini/skills/pead-screener, .github/skills/pead-screener and .opencode/skills/pead-screener in your project.

What does Pead Screener need to run?

Going by SKILL.md and its folder, Pead Screener needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named FMP_API_KEY. Our summary lists: Python 3; A credential in FMP_API_KEY.

Does Pead Screener access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pead Screener safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Pead Screener use?

Pead Screener is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pead Screener use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Pead Screener?

Skills that share tags, products or a category with Pead Screener: Creating Financial Models (Chen-zexi/open-ptc-agent, 729 stars), Stock API (zhangxiangliang/stock-api, 2k stars), Itr Wala (karanb192/itr-wala, 871 stars) and Tushare Data (zillionare/zillionare, 322 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pead Screener?

tradermonty (a GitHub user) maintains it in tradermonty/claude-trading-skills, which has 2,982 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on October 11, 2026.

Source: tradermonty/claude-trading-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.