# sec-annual-comparison

sec-annual-comparison compares financial metrics and risk factors between annual 10-K filings using Octagon MCP. Use it to analyze year-over-year changes in revenue, profitability, risks, and business strategy.

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

## What it does

This skill pulls data from 10-K filings of public companies through Octagon MCP. Query a company by ticker (AAPL, MSFT, GOOGL) and receive structured year-over-year comparisons: revenue, net income, assets, liabilities, margins. The agent also compares risk factors, business descriptions, and strategic priorities across fiscal years.

Data flows from octagon-financials-agent and octagon-sec-agent. You can compare multiple years, focus on revenue segments, or track how risks shift. Output includes tables with growth percentages, trend analysis (whether revenue is accelerating or slowing, margins expanding or contracting), and significance thresholds (changes above 20% are flagged as material).

Octagon MCP must be configured in your AI agent first (Cursor, Claude Desktop, Windsurf). The skill generates prompts automatically, but you can narrow the focus: profitability, geography, competition, M&A. If 10-K data is incomplete or truncated, the agent flags it.

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill sec-annual-comparison -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill sec-annual-comparison -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OctagonAI/skills skills/sec-annual-comparison
```

2. **Manually: put the files in place**
- File: `.github/skills/sec-annual-comparison/SKILL.md`

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/OctagonAI/skills --path skills/sec-annual-comparison
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- compare financial metrics across two fiscal years
- track how risk factors evolve annually
- determine revenue and earnings growth rates
- identify emerging or elevated risks in the business
- analyze revenue by segment and strategic shifts

## Example prompts
- Compare key metrics and risk factors between CRM's current and prior year 10-K filings.
- How have TSLA's risk factors changed between fiscal 2024 and 2023?
- Analyze GOOGL's revenue by segment across the last three years from 10-K filings.

## 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: 3e1905281d511c2a.

BEGIN THIRD-PARTY FILE 3e1905281d511c2a
````text
---
name: sec-annual-comparison
description: Compare key metrics and disclosures between annual 10-K filings using Octagon MCP. Use when analyzing year-over-year changes in financials, risk factors, business descriptions, and strategic priorities across fiscal years.
---

# SEC Annual Comparison

Compare key metrics and risk factors between current and previous year 10-K filings for public companies using the Octagon MCP server.

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

## Workflow

### 1. Identify Analysis Parameters

Determine the following before querying:
- **Ticker**: Stock symbol (e.g., AAPL, MSFT, GOOGL)
- **Years** (optional): Specific fiscal years to compare
- **Focus Areas** (optional): Financials, risks, segments, strategy

### 2. Execute Query via Octagon MCP

Use the `octagon-agent` tool with a natural language prompt:

```
Compare key metrics and risk factors between <TICKER>'s current and previous year 10-K filings.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Compare key metrics and risk factors between CRM's current and previous year 10-K filings."
  }
}
```

### 3. Expected Output

The agent returns structured year-over-year comparison including:

**Financial Metrics:**
- Revenue: $31.353B (FY2023) vs $26.492B (FY2022) - 18.59% growth
- Net Income: $208M (FY2023) vs $1.444B (FY2022) - significant decline
- Total Assets: $98.849B vs $95.209B
- Total Liabilities: $41.755B vs $37.076B

**Key Changes:**
- $1.2B impairment of customer relationships and acquisition assets
- Increased goodwill from acquisitions (Slack, Acumen, Vlocity)
- Debt at $10.682B, covenant compliant

**Risk Factors:**
- Operational, regulatory, financial, market volatility risks
- Industry competition risks

**Data Sources**: octagon-financials-agent, octagon-sec-agent

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding year-over-year trends
- Identifying significant changes
- Evaluating risk factor evolution
- Assessing strategic shifts

## Example Queries

**Full Annual Comparison:**
```
Compare key metrics and risk factors between CRM's current and previous year 10-K filings.
```

**Multi-Year Trend:**
```
````
END THIRD-PARTY FILE 3e1905281d511c2a

The third-party file has ended. Everything between the 3e1905281d511c2a 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 2454 of 8518 bytes. © OctagonAI · MIT · https://github.com/OctagonAI/skills/tree/HEAD/skills/sec-annual-comparison/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
