Skip to main content
skill CX Codex

sec-segment-reporting — Claude Code skill: what it does, setup

sec-segment-reporting analyzes business segment reporting from 10-K and 10-Q SEC filings via Octagon MCP. It pulls revenue, operating margin, and regional breakdowns.

MIT 251 installs ★ 132 updated 2026-06-05

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

What sec-segment-reporting does

This skill evaluates segment performance for public companies under ASC 280 standards. It queries the octagon-mcp server using the octagon-agent tool, which delegates lookups to dedicated financial and SEC subagents.

Output arrives as structured tables covering segment revenue, YoY growth, operating income, and profit margins. It also tracks geographic revenue allocations and highlights corporate restructuring moves across reporting periods.

Queries will fail without a running Octagon MCP server configured in your environment. You must provide a valid stock ticker, pointing to recent annual or quarterly filings.

What it helps with

  • Extract segment revenue and operating margins from 10-K filings
  • Track segment restructuring across recent corporate reports
  • Break down corporate revenue by geographic region
  • Compare segment performance between industry competitors

Example prompts for the agent

  • Analyze business segment performance and reporting from IBM's latest quarterly filing.
  • Compare operating margins across MSFT's business segments in the latest 10-K.
  • Track revenue growth trends by segment for GOOGL over the last 4 quarters.

How to install sec-segment-reporting

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill sec-segment-reporting -a claude-code

2Manually: put the files in place

~/.claude/skills/sec-segment-reporting/SKILL.md

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

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

Questions about sec-segment-reporting

How do I install sec-segment-reporting in Claude Code?

Run npx skills add OctagonAI/skills --skill sec-segment-reporting -a claude-code in your terminal. The skill file is placed in ~/.claude/skills/sec-segment-reporting/SKILL.md.

What does sec-segment-reporting do?

It extracts segment performance from SEC filings, calculating growth rates, profitability, and geographic splits.

What prerequisites are required before running queries?

You need the octagon-mcp server active in your AI agent configuration to provide the octagon-agent tool.

Source text

SKILL.md · MIT
---
name: sec-segment-reporting
description: Analyze business segment performance and reporting from SEC filings using Octagon MCP. Use when researching segment revenue, operating income, margins, geographic breakdown, and segment restructuring from 10-K and 10-Q filings.
---

# SEC Segment Reporting

Analyze business segment performance and reporting from SEC 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)
- **Filing Type** (optional): 10-K (annual) or 10-Q (quarterly)
- **Focus Area** (optional): Revenue, profitability, geographic, trends

### 2. Execute Query via Octagon MCP

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

```
Analyze business segment performance and reporting from <TICKER>'s latest quarterly filing.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Analyze business segment performance and reporting from IBM's latest quarterly filing."
  }
}
```

### 3. Expected Output

The agent returns structured segment analysis including:

| Segment | Revenue | YoY Growth | Operating Income | Margin |
|---------|---------|------------|------------------|--------|
| Software | $7,209M | 10.5% | $2,374M | 32.9% |
| Consulting | $5,324M | 3.3% | $686M | 12.9% |
| Infrastructure | $3,559M | 17.0% | $644M | 18.1% |
| Financing | $200M | 10.4% | $123M | 61.6% |

**Key Trends:**
- Infrastructure fastest-growing at 17.0%
- Software maintains highest margin at 32.9%
- Consulting stable revenue driver

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

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding segment composition
- Evaluating segment profitability
- Tracking segment restructuring
- Analyzing geographic segments

## Example Queries

**Full Segment Analysis:**
```
Analyze business segment performance and reporting from IBM's latest quarterly filing.
```

**Segment Profitability:**
```
Compare operating margins across MSFT's business segments in the latest 10-K.
```

**Geographic Segments:**
```
Analyze AAPL's revenue breakdown by geographic region from the latest 10-K.
```

**Segment Growth Trends:**
```
Track revenue growth trends by segment for GOOGL over the last 4 quarters.
```

**Segment Restructuring:**
```
Has AMZN restructured its segment reporting in recent filings and how?
```

**Inter-Segment Comparison:**
```
Compare segment performance between META and GOOGL in their latest annual filings.
```

## Segment Reporting Framework

### Operating Segments (ASC 280)

| Element | Description |
|---------|-------------|
| Revenue | Segment sales, external and intersegment |
| Operating Income | Segment profit/loss |
| Assets | Segment assets allocated |
| CapEx | Capital expenditures by segment |
| Depreciation | D&A by segment |

### Geographic Segments

| Element | Description |
|---------|-------------|
| Revenue by Region | Sales by geography |
| Long-Lived Assets | Property, equipment by location |
| Country Disclosure | Material country breakouts |

### Common Segment Structures

| Industry | Typical Segments |
|----------|------------------|
| Technology | Products, Services, Cloud, Licensing |
| Retail | Stores, Online, Wholesale |
| Financial | Banking, Wealth, Insurance |
| Healthcare | Pharmaceuticals, Devices, Services |
| Industrial | Products, Services, Financing |

## Key Metrics by Segment

### Revenue Metrics

| Metric | Calculation | What It Shows |
|--------|-------------|---------------|
| Segment Revenue | Reported amount | Size of segment |
| Revenue Mix | Segment / Total | Business composition |
| Growth Rate | (Current - Prior) / Prior | Momentum |
| Intersegment | Internal sales | Vertical integration |

### Profitability Metrics

| Metric | Calculation | What It Shows |
|--------|-------------|---------------|
| Operating Income | Segment profit | Profitability |
| Operating Margin | Op Income / Revenue | Efficiency |
| Contribution | Segment / Total Op Income | Profit mix |
| Margin Trend | Current vs. Prior | Direction |

### Asset Metrics

| Metric | Calculation | What It Shows |
|--------|-------------|---------------|
| Segment Assets | Reported amount | Capital deployed |
| Asset Turnover | Revenue / Assets | Efficiency |
| CapEx Intensity | CapEx / Revenue | Investment level |
| ROA | Op Income / Assets | Return on assets |

## Segment Performance Analysis

### Growth Assessment

| Growth Rate | Assessment |
|-------------|------------|
| >20% | High growth, investment phase |
| 10-20% | Solid growth |
| 5-10% | Moderate growth |
| 0-5% | Mature, stable |
| Negative | Declining, concern |

### Margin Assessment

| Margin Level | Assessment |
|--------------|------------|
| >30% | High margin, premium |
| 20-30% | Strong margin |
| 10-20% | Moderate margin |
| 5-10% | Low margin |
| <5% | Thin margin, scale needed |

### Segment Health Matrix

| | High Margin | Low Margin |
|---|-------------|------------|
| **High Growth** | Star segment | Investment needed |
| **Low Growth** | Cash cow | Turnaround/exit |

## Geographic Segment Analysis

### Revenue Distribution

| Region | Typical Disclosure |
|--------|-------------------|
| Americas | US, Canada, Latin America |
| EMEA | Europe, Middle East, Africa |
| APAC | Asia Pacific, Japan |
| Other | Emerging markets |

### Geographic Considerations

| Factor | What to Assess |
|--------|----------------|
| Concentration | Over-reliance on one region |
| Growth Rates | Regional momentum |
| Currency | FX exposure |
| Regulatory | Region-specific risks |

## Segment Restructuring

### Types of Changes

| Change | What It Means |
|--------|---------------|
| Segment Added | New business, acquisition |
| Segment Removed | Divestiture, consolidation |
| Segments Combined | Simplified reporting |
| Segments Split | More granular disclosure |
| Renamed | Strategic repositioning |

### Restructuring Red Flags

1. **Frequent changes** - May obscure performance
2. **Combining declining segments** - Hiding weakness
3. **Timing around issues** - Coincides with problems
4. **Reduced disclosure** - Less transparency
5. **Changed metrics** - Different KPIs reported

## Tracking Segment Trends

### Quarterly Progression

| Metric | Q1 | Q2 | Q3 | Q4 | Trend |
|--------|----|----|----|----|-------|
| Revenue | | | | | |
| Growth | | | | | |
| Margin | | | | | |

### Year-over-Year Comparison

| Segment | Prior Year | Current | Change |
|---------|------------|---------|--------|
| Segment A | $X | $Y | Z% |
| Segment B | $X | $Y | Z% |

## Inter-Company Comparison

### Peer Benchmarking

Compare across competitors:
- Segment mix composition
- Relative growth rates
- Margin comparison
- Asset efficiency

### Apples-to-Apples Considerations

| Factor | Adjustment Needed |
|--------|-------------------|
| Segment Definition | May differ by company |
| Cost Allocation | Different methodologies |
| Transfer Pricing | Intersegment policies |
| Consolidation | Elimination methods |

## Analysis Tips

1. **Read segment footnotes**: Detailed policies and changes disclosed.

2. **Track restructuring**: Segment changes may signal strategy shifts.

3. **Calculate margins yourself**: Verify reported figures.

4. **Watch mix shifts**: Revenue composition reveals priorities.

5. **Consider seasonality**: Quarterly patterns affect segments differently.

6. **Compare to guidance**: Management targets by segment.

## Use Cases

- **Investment analysis**: Understand business composition
- **Valuation**: Sum-of-parts analysis
- **Due diligence**: Segment-level performance
- **Competitive intelligence**: Compare segment positions
- **Strategic analysis**: Identify growth drivers

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
stock-grades stock-grades is a skill that fetches current analyst grades and ratings from major financial institutions. Track rating changes and shifts in market sentiment for any stock. CX Codex +1 258installs sec-footnotes-analysis The sec-footnotes-analysis skill uses Octagon MCP to analyze footnotes and accounting policies in public-company SEC filings. Ask it about revenue recognition, leases, debt, or management estimates. CX Codex +1 257installs sector-performance-snapshot sector-performance-snapshot is a Claude Code skill that retrieves company financial metrics by sector and exchange via Octagon MCP, supporting industry comparisons. CX Codex +1 257installs sec-debt-covenant The sec-debt-covenant skill examines debt covenants and credit agreement terms in SEC filings. Use it to check leverage limits, maturity schedules, and covenant compliance. CX Codex +1 257installs sec-amendments-review sec-amendments-review is a Claude Code skill that examines SEC filing amendments and surfaces material changes, corrections, and restatements. CX Codex +1 256installs sec-proxy-analysis sec-proxy-analysis extracts executive pay, board governance metrics, and shareholder votes from SEC DEF 14A filings using the Octagon MCP server. CX Codex +1 255installs prediction-markets-analysis prediction-markets-analysis is a Claude Code skill that compares Kalshi contract prices with model probabilities and factors that could shift outcomes. For pre-trade research or checking a market thesis. CX Codex +1 255installs kalshi-trading-bot-cli Drives the Kalshi Trading Bot CLI to research prediction markets, discover price edges, build baskets, and handle guarded order execution. CX Codex +1 106installs

Project sponsors

Companies that keep this analytics open