mcpField
E
earnings-financial-guidance

earnings-financial-guidance

github.com/octagonaiData & databases130266 installsUpdated 21w ago
Repository

About earnings-financial-guidance

earnings-financial-guidance is a skill for extracting and analyzing forward-looking financial guidance from earnings transcripts. It organizes company and segment outlooks, risks, and guidance-versus-actual comparisons, with source citations and follow-up questions.

Key features

  1. 01Company and segment guidance extraction
  2. 02Revenue, margin, and operational outlooks
  3. 03Risk and caveat identification
  4. 04Guidance-versus-actual comparison
  5. 05Source citations and follow-up questions

Use cases

  1. 01Update financial models with company guidance
  2. 02Compare management outlook with consensus
  3. 03Track segment outlook and disclosed risks
  4. 04Review forecast accuracy against actual results

MCP support

Requires Octagon MCP to extract financial guidance from earnings transcripts. The input does not specify a particular MCP tool call.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/octagonai/skills --skill earnings-financial-guidance

After installing, type/earnings-financial-guidancein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

marketplace.json
README.md
references/
interpreting-results.md
mcp-setup.md

Details

From the project README

Earnings Financial Guidance

Extract and analyze financial guidance and forward-looking statements from earnings transcripts, with segment-level detail, risk factor identification, and comparison to actual results.

Prerequisites

Ensure Octagon MCP is configured. See references/mcp-setup.md for installation instructions.

Workflow

Step 1: Extract Financial Guidance

Use the Octagon MCP to extract guidance from earnings transcripts:

Extract and analyze financial guidance and forward-looking statements from <TICKER>'s latest earnings transcript.
Step 2: Targeted Guidance Analysis

Focus on specific guidance components:

# Revenue Guidance
Extract revenue guidance from <TICKER>'s latest earnings call.

# Segment Guidance
Extract segment-level revenue guidance from <TICKER>'s earnings transcript.

# Margin Guidance
Extract gross margin and operating margin guidance from <TICKER>'s earnings call.

# EPS Guidance
Extract earnings per share guidance from <TICKER>'s latest earnings transcript.

# Risk Factors
Extract risk factors and forward-looking statement caveats from <TICKER>'s earnings call.

# Guidance vs. Actuals
Compare prior guidance to actual results in <TICKER>'s latest earnings call.

Expected Output

The skill returns structured guidance analysis including:

ComponentDescription
Company GuidanceExplicit forecasts and ranges
Segment DetailBusiness unit specific outlook
Demand OutlookCustomer demand expectations
Risk FactorsCaveats and uncertainties
Guidance vs. ActualsPrior guidance compared to results
Follow-up QuestionsAI-generated questions for deeper analysis
Source CitationsTranscript and web search references

Example Query

Extract and analyze financial guidance and forward-looking statements from MSFT's latest earnings transcript.

Example Response

Financial Guidance and Forward-Looking Statements from MSFT's Q4 2023 Earnings Transcript

Microsoft's latest earnings transcript (Q4 2023) outlines the following key guidance and forward-looking statements:

Guidance Summary

  • Demand Outlook: The company expects consistent demand signals across commercial businesses, LinkedIn, gaming, and search advertising. However, results may vary if macroeconomic conditions change
  • Windows OEM Inventory: Elevated inventory levels in the Windows OEM business from the prior quarter are anticipated to decrease, leading to a widened guidance range for the More Personal Computing segment
  • More Personal Computing Guidance: The segment's revenue guidance was adjusted to $12.5–$12.9 billion, though actual Q4 2023 revenue reached $13.7 billion (3% year-over-year increase)

Risk Factors

  • Results could be impacted by changes in the business environment, particularly in the Windows OEM segment

Additional Context from Web Search

  • Refinitiv estimates projected a 5.7% year-on-year decline for the More Personal Computing segment in Q4 2023, contrasting with the actual 3% growth reported
  • Cost of revenue for the segment increased $3.2 billion (5%) year-over-year, driven by growth in cloud and AI investments

Follow-up Questions

  • What specific factors caused the discrepancy between the guidance range ($12.5–$12.9B) and actual revenue ($13.7B) for More Personal Computing?
  • How does Microsoft plan to address potential inventory risks in the Windows OEM business moving forward?
  • What portion of the $3.2 billion cost increase in More Personal Computing relates to AI/cloud investments versus other operational expenses?

Sources: MSFT_Q42023 [Page 1], Web Search Results

Guidance Categories

Revenue Guidance
TypeDescription
Total RevenueCompany-wide revenue forecast
Segment RevenueBusiness unit breakdown
GeographicRegional revenue outlook
Growth RateYoY or QoQ expectations
Profitability Guidance
TypeDescription
Gross MarginProduct/service margin outlook
Operating MarginOperating profitability target
Net MarginBottom-line expectations
EPSEarnings per share guidance
Operational Guidance
TypeDescription
Operating ExpensesOpEx forecast and drivers
CapExCapital expenditure plans
Tax RateEffective tax rate expectation
Share CountDiluted shares outstanding

Guidance Analysis Framework

Guidance Quality Assessment
QualityIndicators
HighSpecific ranges, clear assumptions
MediumDirectional guidance, qualitative
LowVague statements, many caveats
Range Interpretation
Narrow Range (e.g., $12.5B - $12.7B):
- High confidence in forecast
- Limited variability expected
- Typical for mature, predictable businesses

Wide Range (e.g., $12.0B - $13.5B):
- Lower confidence or visibility
- Multiple scenarios possible
- Common in volatile environments
Guidance vs. Consensus
ScenarioInterpretation
Guidance > ConsensusCompany more optimistic than Street
Guidance = ConsensusAligned expectations
Guidance < ConsensusStreet may need to revise down

Forward-Looking Statement Analysis

Common Caveats
CaveatMeaning
"Subject to market conditions"Macro-dependent
"Excluding one-time items"Adjusted basis
"If demand trends continue"Assumes steady state
"Barring unforeseen events"Base case only
Risk Factor Categories
CategoryExamples
MacroeconomicRecession, inflation, rates
CompetitiveMarket share, pricing pressure
OperationalSupply chain, capacity
RegulatoryPolicy changes, compliance
Foreign ExchangeCurrency headwinds/tailwinds

Segment-Level Analysis

Segment Guidance Components
ComponentWhat to Extract
Revenue RangeDollar or growth guidance
Margin OutlookProfitability expectations
Key DriversFactors influencing performance
Risk FactorsSegment-specific headwinds
Cross-Segment Comparison
SegmentGrowthMarginRisk
Segment AHighStableLow
Segment BLowImprovingMedium
Segment CModerateDecliningHigh

Guidance vs. Actuals Tracking

Building a Tracking Table
MetricGuidanceActualVarianceBeat/Miss
Revenue$12.5-12.9B$13.7B+$0.8BBeat
EPS$2.50-2.60$2.69+$0.09Beat
Gross Margin68-69%69.8%+80bpsBeat
Variance Analysis
VarianceInterpretation
Significant beatConservative guidance or tailwinds
Modest beatGood execution
In-lineAccurate forecasting
Modest missMinor headwinds
Significant missMajor challenges

Use Cases

  1. Model Updates: Feed guidance into financial models
  2. Consensus Comparison: Check Street alignment
  3. Risk Assessment: Identify disclosed uncertainties
  4. Segment Analysis: Understand business unit outlook
  5. Trend Tracking: Monitor guidance changes over time
  6. Beat/Miss Prediction: Anticipate earnings outcomes

Combining with Other Skills

SkillCombined Analysis
analyst-estimatesGuidance vs. consensus
income-statementValidate historical trends
earnings-call-analysisFull context + guidance detail
sec-10q-analysisCross-reference with filings
stock-price-changeMarket reaction to guidance

Analysis Tips

  1. Track Guidance History: Build a multi-quarter tracker

  2. Note Assumption Changes: What's different from last quarter?

  3. Compare to Peers: How does guidance compare to competitors?

  4. Watch for Revisions: Mid-quarter updates signal importance

  5. Read the Caveats: Understand limitations of guidance

  6. Cross-Reference Sources: Verify with SEC filings

Interpreting Results

See references/interpreting-results.md for detailed guidance on analyzing financial guidance.

Comments

Markdown supported