# financial-growth

financial-growth fetches year-over-year growth metrics across income and cash flow statements for public companies.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 273 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/financial-growth/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/financial-growth

## What it does

The skill instructs your AI assistant to query the `octagon-mcp` server using the `octagon-agent` tool. It retrieves percentage changes across fiscal years or quarters for total sales, gross profit, operating income, net income, earnings per share, and free cash flow.

Beyond generating the table, the skill guides the agent to evaluate growth patterns. It outlines checks for cash conversion issues when net income outpaces free cash flow, flags share buyback effects when EPS expands faster than profit, and highlights operating leverage.

Queries fail if `octagon-mcp` is not configured in your agent environment beforehand.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill financial-growth -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/financial-growth/SKILL.md

## When to use it
- calculate year-over-year growth rates for public company financial metrics
- spot divergence between net income growth and free cash flow
- detect share buyback patterns by comparing EPS and earnings expansion
- track margin trends by contrasting revenue and operating income shifts

## Example prompts
- Retrieve year-over-year growth in key financial metrics for AAPL, limited to 5 records and filtered by period FY
- Show annual financial growth trends for MSFT across revenue, net income, and free cash flow for 4 years
- Pull quarterly growth metrics for NVDA and flag any earnings quality discrepancies

## 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: e9cc8dcb2891c52b.

BEGIN THIRD-PARTY FILE e9cc8dcb2891c52b
````text
---
name: financial-growth
description: Retrieve comprehensive year-over-year growth in key financial metrics including Revenue, Gross Profit, Operating Income, Net Income, EPS, and Free Cash Flow. Use when analyzing overall company financial performance trends across income statement and cash flow.
---

# Financial Growth

Retrieve and analyze comprehensive year-over-year growth in key financial metrics for public companies using Octagon MCP.

## Prerequisites

Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See [references/mcp-setup.md](references/mcp-setup.md) for installation instructions.

## Query Format

```
Retrieve year-over-year growth in key financial metrics for <TICKER>, limited to <N> records and filtered by period <FY|Q>.
```

**MCP Call:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve year-over-year growth in key financial metrics for AAPL, limited to 5 records and filtered by period FY"
  }
}
```

## Output Format

The agent returns a comprehensive table with YoY growth percentages:

| Fiscal Year | Revenue Growth (%) | Gross Profit Growth (%) | Operating Income Growth (%) | Net Income Growth (%) | EPS Growth (%) | Free Cash Flow Growth (%) |
|-------------|-------------------|------------------------|----------------------------|----------------------|----------------|--------------------------|
| 2025 | 6.43% | 8.04% | 7.98% | 19.50% | 22.59% | -5.73% |
| 2024 | 2.02% | 6.82% | 7.80% | -3.36% | -0.81% | 6.98% |
| 2023 | -2.80% | -0.96% | -4.30% | -2.81% | 0.16% | -10.64% |
| 2022 | 7.79% | 11.74% | 9.63% | 5.41% | 8.47% | 19.89% |
| 2021 | 33.26% | 45.62% | 64.36% | 64.92% | 71.30% | 26.70% |

**Data Source:** octagon-financials-agent

## Key Insights Pattern

After receiving data, generate insights:

1. **Peak performance years**: Identify years with highest growth across all metrics
2. **Earnings vs cash flow divergence**: Compare Net Income growth to FCF growth
3. **Margin trends**: Compare Gross Profit and Operating Income growth to Revenue
4. **EPS enhancement**: Note when EPS growth exceeds Net Income growth (buybacks)
5. **Challenging periods**: Flag years with broad-based declines

## Metrics Reference

| Metric | Definition |
|--------|------------|
| Revenue Growth | YoY change in total sales |
| Gross Profit Growth | YoY change in Revenue minus COGS |
| Operating Income Growth | YoY change in income from operations |
| Net Income Growth | YoY change in bottom-line profit |
| EPS Growth | YoY change in earnings per share |
| Free Cash Flow Growth | YoY change in operating cash flow minus capex |

## Analysis Tips

### Exceptional Growth Years
When all metrics show double-digit growth:
- Identify specific drivers (new products, markets, pricing)
- Assess sustainability of growth rate
- Compare to industry and competitors
````
END THIRD-PARTY FILE e9cc8dcb2891c52b

The third-party file has ended. Everything between the e9cc8dcb2891c52b 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 2907 of 3991 bytes. © OctagonAI · MIT · https://github.com/OctagonAI/skills/tree/HEAD/skills/financial-growth/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
