Index of every page on this site: llms.txt
All skills
tradermonty avatar

/earnings-trade-analyzer

@f95e770
Run it yourself

Analyze recent post-earnings stocks using a 5-factor scoring system (Gap Size, Pre-Earnings Trend, Volume Trend, MA200 Position, MA50 Position). Scores each stock 0-100 and assigns A/B/C/D grades. Use when user asks about earnings trade analysis, post-earnings momentum screening, earnings gap scoring, or finding best recent earnings reactions.

Use this Skill: https://skilld.dev/gh/tradermonty/claude-trading-skills/earnings-trade-analyzer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈93 tokens for metadata: the name and description. ≈1.8k when used: this file. ≈964 more on demand in 1 file.

Description uses 4.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈371 characters, or 4.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Earnings Trade Analyzer - Post-Earnings 5-Factor Scoring

Analyze recent post-earnings stocks using a 5-factor weighted scoring system to identify the strongest earnings reactions for potential momentum trades.

When to Use

  • User asks for post-earnings trade analysis or earnings gap screening
  • User wants to find the best recent earnings reactions
  • User requests earnings momentum scoring or grading
  • User asks about post-earnings accumulation day (PEAD) candidates

Prerequisites

  • FMP API key (set FMP_API_KEY environment variable or pass --api-key)
  • Free tier (250 calls/day) is sufficient for default screening (lookback 2 days, top 20)
  • Paid tier recommended for larger lookback windows or full screening

Workflow

Step 1: Run the Earnings Trade Analyzer

Execute the analyzer script:

# Default: last 2 days of earnings, top 20 results
python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py --output-dir reports/

# Custom lookback and market cap filter
python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py \
  --lookback-days 5 \
  --min-market-cap 1000000000 \
  --top 30 \
  --output-dir reports/

# Deterministic anchor date (America/New_York); the window is anchored on the
# ET calendar date, not the runner's local clock. For reproducible runs/tests.
python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py \
  --as-of 2026-09-15 \
  --output-dir reports/

# With entry quality filter
python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py \
  --apply-entry-filter \
  --output-dir reports/
Degraded endpoint / budget fallback for scheduled reviews

If the analyzer reports a 404, an implausible empty earnings calendar, or exhausts its API-call budget before producing scored candidates during a scheduled after-close/pre-market run, do not report "no earnings reactions" immediately. A clean empty response over a date window containing at least one XNYS session exits 1 with ZERO_RESULT_REASON=earnings_calendar_empty_with_market_sessions. If the shared XNYS calendar cannot classify the window, it exits 1 with ZERO_RESULT_REASON=market_calendar_unavailable; if pandas-market-calendars is not installed, it exits 2 with a requirements.txt hint instead. Budget or daily rate-limit exhaustion during profile fetching exits 1 with ZERO_RESULT_REASON=profiles_budget_exhausted. Treat each as a failed run to retry or fall back on, not a quiet day. Only a clean empty response over a zero-session window exits 0 as ZERO_RESULT_REASON=no_earnings_rows.

  1. First retry once with a narrower liquid-universe configuration so the full 5-factor scorer has a chance to complete, for example:
python3 skills/earnings-trade-analyzer/scripts/analyze_earnings_trades.py \
  --lookback-days 2 \
  --min-market-cap 5000000000 \
  --top 20 \
  --max-api-calls 600 \
  --output-dir reports/<routine-date>
  1. If the scored run still returns no candidates or cannot complete, verify the same range through the stable endpoint used by the compatibility shim and clearly label the result as an ungraded fallback:
curl "https://financialmodelingprep.com/stable/earnings-calendar?from=YYYY-MM-DD&to=YYYY-MM-DD&apikey=$FMP_API_KEY"

Then optionally enrich returned US tickers through the analyzer's stable-first FMP client or per-symbol /stable/quote?symbol=<ticker> calls to rank by same-day changesPercentage, market cap, and liquidity. Use legacy /api/v3 quote calls only as a legacy-key fallback after stable has failed. Present these as preliminary / ungraded reactions because the 5-factor scorer did not run; do not assign A/B/C/D grades from the fallback alone.

No-candidate output pitfall: The analyzer may print Candidates after filtering: 0 / No candidates found matching criteria. and exit successfully without writing an earnings_trade_analyzer_*.json file. In that case, do not try to run PEAD Mode B from a nonexistent candidate file. Say explicitly that no scored analyzer JSON was produced, run the endpoint/quote enrichment fallback above if the routine needs an earnings section, and label any names as manual-review only. This success-exit path does not cover budget exhaustion during profile fetching: that case exits 1 (ZERO_RESULT_REASON=profiles_budget_exhausted) instead.

Empty windows and today-only runs

The earnings calendar window is inclusive and uses the America/New_York calendar date from --as-of (or the current ET date). A clean provider [] is a benign quiet-window result only when the shared XNYS calendar successfully counts zero exchange sessions in that exact window, such as a weekend or holiday. If the window contains an XNYS session, the same clean [] exits 1 with ZERO_RESULT_REASON=earnings_calendar_empty_with_market_sessions so a provider drop is not reported as a quiet day. If the XNYS calendar cannot be queried, the run also exits 1 with ZERO_RESULT_REASON=market_calendar_unavailable. A missing pandas-market-calendars package exits 2 with a requirements.txt hint.

--lookback-days 0 is valid and queries exactly the single ET as-of date. Use it after the relevant announcements have been published (normally after the session close); an empty response on an XNYS session remains intentionally fail-closed. A non-empty response whose rows do not carry a symbol retains the separate ZERO_RESULT_REASON=no_earnings_rows behavior; that case is not the literal-empty-list session check above.

Step 2: Review Results

  1. Read the generated JSON and Markdown reports
  2. Load references/scoring_methodology.md for scoring interpretation context
  3. Focus on Grade A and B stocks for actionable setups

Step 3: Present Analysis

For each top candidate, present:

  • Composite score and letter grade (A/B/C/D)
  • Earnings gap size and direction
  • Pre-earnings 20-day trend
  • Volume ratio (20-day vs 60-day average)
  • Position relative to 200-day and 50-day moving averages
  • Weakest and strongest scoring components

Step 4: Provide Actionable Guidance

Based on grades:

  • Grade A (85+): Strong earnings reaction with institutional accumulation - consider entry
  • Grade B (70-84): Good earnings reaction worth monitoring - wait for pullback or confirmation
  • Grade C (55-69): Mixed signals - use caution, additional analysis needed
  • Grade D (<55): Weak setup - avoid or wait for better conditions

Output

  • earnings_trade_analyzer_YYYY-MM-DD_HHMMSS.json - Structured results with schema_version "1.0"
  • earnings_trade_analyzer_YYYY-MM-DD_HHMMSS.md - Human-readable report with tables

Unknown earnings timing

FMP does not confirm a bmo/amc session for every earnings row; unconfirmed rows report earnings_timing: "unknown" and the gap calculation assumes the AMC window as a fallback. Both reports surface timing_unknown_count out of timing_candidates_total so this assumption stays visible rather than blending unnoticed into the scores.

Resources

  • references/scoring_methodology.md - 5-factor scoring system, grade thresholds, and entry quality filter rules

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning6d5 checks · Risk SAFE
  • Gen Agent Trust Hub6d

    The skill is a comprehensive stock market analysis tool designed to identify momentum trades following corporate earnings reports. It uses the Financial Modeling Prep (FMP) API to fetch earnings data and company profiles, then applies a technical scoring system. The skill follows security best practices, such as redacting API keys from log outputs and using structured data handling. No malicious patterns, obfuscation, or unauthorized access attempts were detected.

  • Socket6d

    No alerts

  • Snyk6d

    Risk: LOW · No issues

  • Runlayer9mo

    13/14 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at f95e770. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last week

README badge

README badge for tradermonty/claude-trading-skills/earnings-trade-analyzer