Skip to main content
skill CX Codex

revenue-product-segmentation — Claude Code skill: install & usage

revenue-product-segmentation — a skill for Claude Code, Codex, Cursor and other agents that pulls a product-segment revenue breakdown for any public company via Octagon MCP. Covers annual periods and returns figures in USD billions.

MIT 263 installs ★ 132 updated 2026-06-05

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

What revenue-product-segmentation does

Each request goes to octagon-financials-agent through octagon-mcp and comes back as a flat table — segment name, revenue in USD billions, and a total row. The example in the docs shows Apple's annual data: iPhone $209.59B, Services $109.16B, Wearables $35.69B, Mac $33.71B, iPad $28.02B, totalling $416.17B.

Once the table arrives, the skill walks through a built-in analysis framework: segment share of total revenue, identification of the primary driver, concentration risk flags (a single segment above 50% is high risk; two segments above 80% is moderate), hardware-versus-services split, and lifecycle stage per segment. It also surfaces follow-up queries for year-over-year growth rates and peer comparisons.

octagon-mcp must be configured in the agent before any call reaches octagon-agent — without it the tool call fails.

What it helps with

  • fetch annual product-segment revenue data for a public company by ticker
  • calculate each segment's share of total revenue
  • flag revenue concentration risk across product lines
  • compare a company's segment mix against a named peer
  • track which segments are gaining or losing share across periods

Example prompts for the agent

  • Retrieve detailed revenue by product segment for MSFT for the annual period with a flat response structure.
  • Calculate each segment's share of total revenue for GOOGL and flag any concentration risk.
  • Compare the product segment mix of AAPL and MSFT and show which has more diversified revenue.

How to install revenue-product-segmentation

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill revenue-product-segmentation -a claude-code

2Manually: put the files in place

~/.claude/skills/revenue-product-segmentation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/revenue-product-segmentation/

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

Questions about revenue-product-segmentation

How do I install revenue-product-segmentation in Claude Code?

Run npx skills add OctagonAI/skills --skill revenue-product-segmentation -a claude-code. The skill file will be available at ~/.claude/skills/revenue-product-segmentation/SKILL.md.

What does the revenue-product-segmentation skill do?

It queries Octagon MCP for a public company's annual product-segment revenue and returns a USD-denominated table. The built-in framework then calculates segment shares, flags concentration risk, and suggests follow-up queries for peer and period comparisons.

Does this skill require Octagon MCP to be set up first?

Yes. All data comes through the octagon-agent tool on octagon-mcp, so the server must be configured in your agent before the skill can make any calls.

Source text

SKILL.md · MIT
---
name: revenue-product-segmentation
description: Retrieve detailed revenue breakdown by product segment for public companies. Use when analyzing product mix, revenue concentration, segment contribution, or business line performance.
---

# Revenue Product Segmentation

Retrieve detailed revenue breakdown by product segment 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 detailed revenue by product segment for <TICKER>, for the annual period with a flat response structure.
```

**MCP Call:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve detailed revenue by product segment for AAPL, for the annual period with a flat response structure"
  }
}
```

## Output Format

The agent returns a table with revenue by product segment:

| Product Segment | Revenue (USD Billion) |
|-----------------|----------------------|
| iPhone | $209.59 |
| Services | $109.16 |
| Wearables, Home and Accessories | $35.69 |
| Mac | $33.71 |
| iPad | $28.02 |
| **Total** | **$416.17** |

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

## Key Insights Pattern

After receiving data, generate insights:

1. **Revenue concentration**: Calculate each segment as % of total
2. **Core business identification**: Identify largest revenue driver
3. **Growth segments**: Note high-growth or emerging segments
4. **Diversification assessment**: Evaluate revenue balance across segments
5. **Strategic positioning**: Understand product portfolio mix

## Analysis Tips

### Revenue Concentration
Calculate segment share:
```
Segment Share = Segment Revenue / Total Revenue × 100
```
Example: $209.59B / $416.17B = 50.36%

### Concentration Risk
- Single segment >50% = high concentration
- Top 2 segments >80% = moderate concentration
- No segment >30% = well diversified

### Segment Dynamics
Compare to prior periods:
- Which segments are growing share?
- Which are declining?
- Any new segments emerging?

### Margin Implications
Different segments often have different margins:
- Services typically higher margin than hardware
- Premium products vs commodity segments
- Recurring vs one-time revenue

### Strategic Questions
Based on segmentation:
- Is the company transitioning its business model?
- Are growth investments in high-margin segments?
- How does mix compare to competitors?

## Segment Analysis Framework

### Hardware vs Services
For tech companies:
- Hardware: One-time, capital intensive
- Services: Recurring, higher margin, scalable

### Geographic Implications
Segments may have geographic skew:
- Some products stronger in certain regions
- Currency exposure by segment
- Regulatory considerations

### Lifecycle Positioning
Segment maturity assessment:
- Growth phase: High growth, lower margins
- Mature: Stable, optimized margins
- Decline: Shrinking, harvesting

## Follow-up Queries

Based on results, suggest deeper analysis:

- "What are the year-over-year growth rates for each product segment?"
- "How do these revenue figures compare to [COMPANY]'s guidance?"
- "What are the regional breakdowns for [SEGMENT1] and [SEGMENT2] revenue?"
- "Compare [COMPANY]'s product segment mix to [PEER1] and [PEER2]"

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
earnings-analyst-questions earnings-analyst-questions is a Claude Code skill that analyzes questions from company earnings calls. It groups analyst concerns by topic and identifies who raised them. CX Codex +1 264installs earnings-competitive-review earnings-competitive-review reads earnings-call transcripts for management’s views on rivals, market position, and differentiation. Useful when researching a company’s competitive claims. CX Codex +1 264installs earnings-revenue-guidance earnings-revenue-guidance is a Claude Code skill that extracts revenue guidance from earnings transcripts, with segment breakdowns, currency adjustments, and M&A impact analysis. CX Codex +1 264installs earnings-mgmt-comments earnings-mgmt-comments extracts targeted management commentary from company earnings call transcripts across topics like AI initiatives, supply chain, and capital allocation. CX Codex +1 263installs earnings-market-expansion The earnings-market-expansion skill extracts geographic expansion, new country launches, and product diversification strategies from earnings call transcripts. Requires Octagon MCP. CX Codex +1 263installs revenue-geographic-segmentation revenue-geographic-segmentation pulls geographic revenue breakdowns for public companies through Octagon MCP and analyzes regional exposure alongside currency risks. CX Codex +1 263installs sec-analyst-master sec-analyst-master — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that runs a full SEC filing analysis by orchestrating the complete suite of Octagon SEC sub-skills. CX Codex +1 263installs sec-risk-factors sec-risk-factors — a skill that retrieves and categorizes risk factors from 10-K and 10-Q filings via Octagon MCP. Use it to analyze Item 1A disclosures, track risk changes across periods, and compare risk profiles between companies. CX Codex +1 263installs

Project sponsors

Companies that keep this analytics open