Skip to main content
skill CX Codex

sec-annual-comparison — Claude Code skill: compare 10-K filings

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.

MIT 259 installs ★ 132 updated 2026-06-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OctagonAI/skills --skill sec-annual-comparison -a claude-code
Open on GitHub

What sec-annual-comparison 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.

What it helps with

  • 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 for the agent

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

How to install sec-annual-comparison

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill sec-annual-comparison -a claude-code

2Manually: put the files in place

~/.claude/skills/sec-annual-comparison/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sec-annual-comparison/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sec-annual-comparison

How do I install sec-annual-comparison in Claude Code?

Run npx skills add OctagonAI/skills --skill sec-annual-comparison -a claude-code, then open ~/.claude/skills/sec-annual-comparison/SKILL.md.

What does sec-annual-comparison do?

It compares financial metrics, risk factors, business descriptions, and strategy between two annual 10-K filings. Provide a company ticker and the agent returns year-over-year analysis with growth rates, trends, and significance assessment for material changes.

What MCP server does this require?

Octagon MCP must be configured in your agent (Cursor, Claude Desktop, Windsurf, etc.) beforehand. The skill uses the octagon-agent tool and pulls data from octagon-financials-agent and octagon-sec-agent.

Source text

SKILL.md · MIT
---
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:**
```
Compare AAPL's financial performance across the last 3 fiscal years from 10-K filings.
```

**Risk Factor Evolution:**
```
How have TSLA's risk factors changed between FY2024 and FY2023 10-K filings?
```

**Segment Comparison:**
```
Compare revenue segment breakdown between GOOGL's FY2024 and FY2023 10-K filings.
```

**Strategic Changes:**
```
Compare the business description and strategy sections between MSFT's current and prior year 10-K.
```

**Margin Analysis:**
```
Compare gross margin and operating margin trends between NVDA's FY2024 and FY2023 10-K filings.
```

## Comparison Framework

### Financial Metrics

| Category | Key Metrics |
|----------|-------------|
| Revenue | Total revenue, growth rate, segment breakdown |
| Profitability | Gross profit, operating income, net income |
| Margins | Gross margin, operating margin, net margin |
| Balance Sheet | Assets, liabilities, equity, cash, debt |
| Cash Flow | Operating, investing, financing, free cash flow |
| Per Share | EPS, book value, dividends |

### Operational Metrics

| Category | Key Metrics |
|----------|-------------|
| Customers | Count, retention, concentration |
| Employees | Headcount, productivity |
| Geographic | Revenue by region, asset location |
| Segments | Business unit performance |

### Risk Factors

| Category | What to Compare |
|----------|-----------------|
| Business | Competitive, operational, strategic |
| Financial | Liquidity, debt, currency |
| Regulatory | Compliance, legal |
| Market | Economic, industry |
| Technology | Innovation, disruption |

### Strategic Elements

| Category | What to Compare |
|----------|-----------------|
| Mission | Corporate purpose |
| Strategy | Growth initiatives |
| Investments | R&D, CapEx, M&A |
| Markets | Geographic, product expansion |

## Year-over-Year Analysis

### Financial Trend Assessment

| Metric | Positive Trend | Negative Trend |
|--------|----------------|----------------|
| Revenue | Growing, accelerating | Declining, slowing |
| Margins | Expanding | Contracting |
| Earnings | Increasing | Decreasing |
| Cash Flow | Strengthening | Weakening |
| Debt | Declining | Increasing |

### Key Ratios to Track

| Ratio | Calculation | What It Shows |
|-------|-------------|---------------|
| Revenue Growth | (Current - Prior) / Prior | Top-line momentum |
| Gross Margin | Gross Profit / Revenue | Pricing power, costs |
| Operating Margin | Operating Income / Revenue | Operational efficiency |
| Net Margin | Net Income / Revenue | Bottom-line profitability |
| ROE | Net Income / Equity | Shareholder returns |
| Debt/Equity | Total Debt / Equity | Financial leverage |

### Change Analysis

| Change Type | Significance |
|-------------|--------------|
| >20% improvement | Major positive development |
| 5-20% improvement | Solid progress |
| ±5% | Stable/flat |
| 5-20% decline | Concerning deterioration |
| >20% decline | Material negative change |

## Risk Factor Comparison

### Types of Changes

| Change | What It Means |
|--------|---------------|
| New risk added | Emerging concern |
| Risk removed | Issue resolved or de-emphasized |
| Language expanded | Increased concern |
| Language reduced | Diminished concern |
| Position changed | Priority shift |
| Specificity added | Crystallizing risk |

### Priority Assessment

| Position | Prior Year | Current Year | Interpretation |
|----------|------------|--------------|----------------|
| Top 5 | Top 5 | Top 5 | Persistent priority |
| Lower | Lower | Top 5 | Elevated concern |
| Top 5 | Top 5 | Lower | Reduced priority |
| None | None | Added | New risk |
| Present | Present | Removed | Resolved |

## Business Description Changes

### What to Track

| Section | Changes to Note |
|---------|-----------------|
| Products | New offerings, discontinued products |
| Markets | Geographic expansion, exits |
| Customers | Target market shifts |
| Competition | New competitors, changed positioning |
| Strategy | New initiatives, changed priorities |
| Technology | Platform changes, R&D focus |

### Strategic Shifts

| Indicator | Examples |
|-----------|----------|
| New emphasis | Repeated new terms |
| Removed emphasis | Topics no longer discussed |
| Changed language | Different framing |
| Quantification | New metrics disclosed |
| Commitment | Specific targets stated |

## Segment Performance Comparison

### Revenue Analysis

| Segment | Prior Year | Current Year | Growth | Mix Change |
|---------|------------|--------------|--------|------------|
| Segment A | $X | $Y | Z% | +/- pp |
| Segment B | $X | $Y | Z% | +/- pp |

### Segment Health Indicators

| Indicator | Positive | Negative |
|-----------|----------|----------|
| Growth | Accelerating | Decelerating |
| Margin | Improving | Declining |
| Share of Total | Increasing (if healthy) | Declining |
| Investment | Increasing | Divesting |

## Multi-Year Trend Analysis

### 3-5 Year Comparison

Track over extended periods:
- Revenue CAGR
- Margin trajectories
- Balance sheet evolution
- Risk factor patterns
- Strategic consistency

### Inflection Points

| Signal | What Changed |
|--------|--------------|
| Growth acceleration | New product, market |
| Margin expansion | Scale, efficiency |
| Cash flow improvement | Working capital, CapEx |
| Risk emergence | New competitive threat |
| Strategic pivot | Changed direction |

## Analysis Tips

1. **Start with financials**: Numbers provide objective comparison base.

2. **Read both MD&As**: Management commentary reveals context.

3. **Track risk factor order**: Position indicates priority.

4. **Note new disclosures**: First-time mentions often significant.

5. **Compare segment detail**: Business unit changes reveal strategy.

6. **Check footnote changes**: Accounting policy shifts matter.

## Use Cases

- **Investment research**: Understand company trajectory
- **Due diligence**: Track performance evolution
- **Competitive analysis**: Compare across competitors
- **Risk monitoring**: Identify emerging concerns
- **Earnings analysis**: Context for quarterly results

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
sec-10q-analysis sec-10q-analysis pulls financial metrics, segment revenue, and operating margins from quarterly SEC 10-Q filings using Octagon MCP. CX Codex +1 260installs historical-market-cap A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that pulls historical market capitalization data for any stock ticker via Octagon MCP. CX Codex +1 260installs ratings-snapshot The ratings-snapshot skill fetches an overall rating and key financial metrics (DCF, ROE, ROA, debt-to-equity, P/E, P/B) for public companies. Use it to screen stocks by fundamentals and compare companies side by side. CX Codex +1 260installs sector-pe-ratios Retrieves sector P/E ratios across stock exchanges using Octagon MCP. Helps compare equity valuations against sector baselines. CX Codex +1 260installs stock-historical-index stock-historical-index — a skill to fetch full daily price history for market indices via Octagon MCP. Runs when analyzing index performance, calculating returns, and benchmarking individual stocks against the market. CX Codex +1 259installs price-target-consensus price-target-consensus fetches consensus price targets for any stock: average, median, high and low analyst projections. Use it to evaluate upside potential and measure how widely analysts' views diverge. CX Codex +1 259installs sec-mda-analysis sec-mda-analysis parses MD&A sections from SEC 10-K and 10-Q filings through the Octagon MCP server to track corporate strategy and risks. CX Codex +1 258installs sec-8k-analysis sec-8k-analysis extracts material corporate events and disclosures from SEC 8-K filings using the Octagon MCP server. CX Codex +1 258installs

Project sponsors

Companies that keep this analytics open