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
npx skills add OctagonAI/skills --skill revenue-product-segmentation -a claude-codeWhat 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
MSFTfor the annual period with a flat response structure. - Calculate each segment's share of total revenue for
GOOGLand flag any concentration risk. - Compare the product segment mix of
AAPLandMSFTand 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-code2Manually: put the files in place
~/.claude/skills/revenue-product-segmentation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/revenue-product-segmentation/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill revenue-product-segmentation -a codex2Manually: put the files in place
.agents/skills/revenue-product-segmentation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill revenue-product-segmentation -a cursor2Manually: put the files in place
.cursor/skills/revenue-product-segmentation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OctagonAI/skills skills/revenue-product-segmentation2Manually: put the files in place
.github/skills/revenue-product-segmentation/SKILL.md1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill revenue-product-segmentation -a gemini-cli2Platform CLI
gemini skills install https://github.com/OctagonAI/skills --path skills/revenue-product-segmentationManually: put the files in place
.devin/skills/revenue-product-segmentation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill revenue-product-segmentation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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