earnings-recap

Analyze post-earnings results, surprises, and price reactions using yfinance data.

3.3k|382|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/himself65/finance-skills --skill earnings-recap-himself65
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: earnings-recap
Source: https://github.com/himself65/finance-skills/tree/main/plugins/market-analysis/skills/earnings-recap
Command: npx skills add https://github.com/himself65/finance-skills --skill earnings-recap-himself65

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yfinance, pandas, and includes references (resource) components.

What problem does it solve? After a company reports earnings, investors need to quickly understand whether it beat or missed estimates, how big the surprise was, how the stock reacted, and whether financial trends are improving — pulling this together manually from Yahoo Finance is slow and error-prone. ## Core Features & Use Cases - Beat/Miss Analysis: Compares actual vs estimated EPS with surprise percentage for the most recent or a specified past quarter. - Price Reaction Measurement: Calculates the stock's move in the reaction session (handling after-hours vs pre-market reports) and compares it to the average earnings-day move over the prior four reports. - Quarterly Trend Review: Presents revenue, gross/operating margins, and EPS trends from quarterly financial statements, with year-over-year growth where data allows. - Use Case: Ask "how did NVDA earnings go" the morning after a report and get a headline recap — the surprise, revenue growth, the stock's reaction versus its typical earnings move, and what changed in margins. ## Quick Start Ask the agent "Give me an earnings recap for AAPL" and it will fetch the latest report data via yfinance and summarize the beat or miss, trends, and price reaction.

Frequently Asked Questions about earnings-recap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a stock beat or missed earnings?▼

Use yfinance to compare reported EPS against the consensus estimate from get_earnings_dates() or earnings_history. The surprise percentage shows the beat or miss magnitude, and this skill presents it alongside revenue growth and the stock's reaction.

How to calculate stock price reaction to an earnings report?▼

Measure the percentage move from the last close before the report to the first close after it, using the announcement timestamp to determine the window. Reports at or after 16:00 Eastern use report-day close to next close; earlier reports use prior close to report-day close.

Does yfinance earnings data require an API key or setup?▼

No setup or authentication is required. yfinance pulls data directly from Yahoo Finance, and the skill auto-installs the package via pip if it is missing from the Python environment.

Why is earnings_history index not the announcement date?▼

The earnings_history DataFrame is indexed by fiscal quarter-end date, not the announcement date, so it cannot set the price-reaction window. Use get_earnings_dates() instead, which returns tz-aware announcement timestamps in America/New_York.

What are the limitations of Yahoo Finance earnings data?▼

Yahoo Finance data does not capture earnings call details like guidance or segment breakdowns, and revenue is compared year over year from statements rather than against a revenue consensus. The price reaction can also reflect broader market moves that day.