earnings-recap

This skill generates a post-earnings analysis for any publicly traded stock using Yahoo Finance data accessed through the yfinance Python library. It solves the problem of quickly assembling a complete picture of a recent earnings event — the beat or miss result, the surprise magnitude, the stock's price reaction, and the surrounding financial context — without manually pulling from multiple sources. The skill explicitly frames its output as research and educational material, not financial advice.

The workflow first checks whether yfinance is installed and installs it via pip if missing, then extracts the ticker from the user's request and fetches earnings history, quarterly income/cashflow/balance statements, price history around the earnings date, company info, news, and analyst recommendations. It identifies the most recent earnings row, matches it to the corresponding quarter, and computes the price reaction by comparing closes before and after the report, accounting for before- or after-market timing. The recap is then structured into sections covering the headline EPS result, revenue and margin trends over recent quarters, the stock reaction versus its typical earnings-day move, and analyst sentiment. A detailed API reference documents the exact yfinance fields and margin/growth calculations used.

It targets retail investors, analysts, and finance-focused agent users who want a fast, structured earnings summary. No authentication or setup is required since yfinance pulls public Yahoo Finance data.