# earnings-financial-guidance

earnings-financial-guidance extracts revenue targets, segment details, and risk factors from corporate earnings calls. It tracks forward-looking management guidance against reported quarter results.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 271 installs · ★ 132 repo stars
- Author: OctagonAI
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/OctagonAI/skills/tree/HEAD/skills/earnings-financial-guidance/SKILL.md
- Updated: 2026-06-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/earnings-financial-guidance

## What it does

The skill pulls financial guidance and forward-looking commentary directly from earnings call transcripts. It isolates targets for total revenue and operating margins across business units. The workflow spots management caveats early.

Inside, the skill structures extracted guidance into tracking tables that compare prior ranges against actual outcomes. The framework assesses forecast quality from range widths. Wide spreads signal uncertainty. Without an active Octagon MCP setup, the skill cannot access transcript data.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill earnings-financial-guidance -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/earnings-financial-guidance/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/earnings-financial-guidance/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill earnings-financial-guidance -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/earnings-financial-guidance/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill earnings-financial-guidance -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/earnings-financial-guidance/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OctagonAI/skills skills/earnings-financial-guidance
```

2. **Manually: put the files in place**
- File: `.github/skills/earnings-financial-guidance/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill earnings-financial-guidance -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OctagonAI/skills --path skills/earnings-financial-guidance
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/earnings-financial-guidance/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill earnings-financial-guidance -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OctagonAI/skills/tree/HEAD/skills/earnings-financial-guidance/SKILL.md

## When to use it
- extract revenue and earnings forecasts from call transcripts
- separate corporate guidance into business segment targets
- compare previous guidance ranges against reported numbers
- log cautionary statements and operational risk factors

## Example prompts
- Extract segment-level revenue guidance and risk factors from <TICKER>'s earnings transcript.
- Compare prior guidance to actual results in MSFT's latest earnings call.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 2fa3f775d426f7d6.

BEGIN THIRD-PARTY FILE 2fa3f775d426f7d6
````text
---
name: earnings-financial-guidance
description: Extract and analyze financial guidance and forward-looking statements from earnings transcripts, including segment guidance, risk factors, and guidance vs. actuals comparison.
---

# 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](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:

| Component | Description |
|-----------|-------------|
| Company Guidance | Explicit forecasts and ranges |
| Segment Detail | Business unit specific outlook |
| Demand Outlook | Customer demand expectations |
| Risk Factors | Caveats and uncertainties |
| Guidance vs. Actuals | Prior guidance compared to results |
| Follow-up Questions | AI-generated questions for deeper analysis |
| Source Citations | Transcript 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
````
END THIRD-PARTY FILE 2fa3f775d426f7d6

The third-party file has ended. Everything between the 2fa3f775d426f7d6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2834 of 8587 bytes. © OctagonAI · MIT · https://github.com/OctagonAI/skills/tree/HEAD/skills/earnings-financial-guidance/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
