analyst-estimates — Claude Code skill for analyst forecasts
analyst-estimates is a Claude Code skill that fetches public-company revenue and EPS forecasts with estimate ranges and analyst counts. It supports review of forward expectations or valuation inputs.
MIT 277 installs ★ 132 updated 2026-06-05
npx skills add OctagonAI/skills --skill analyst-estimates -a claude-codeWhat analyst-estimates does
The skill queries Octagon MCP for analyst estimates across future periods. Its table includes average, low, and high revenue and EPS projections, plus the number of analysts contributing estimates for each metric.
Use the results to inspect estimate dispersion, compare near- and long-term forecasts, or check projections against historical performance. The guide also covers implied CAGR and forward P/E calculations. Octagon MCP must be configured in your agent first; without that connection, the skill cannot retrieve estimates.
What it helps with
- retrieve annual revenue projections for a public company
- compare average EPS forecasts with low and high estimates
- check analyst coverage across forecast periods
- compare forward estimates with historical financial results
Example prompts for the agent
- Get annual revenue and EPS estimates for
AAPL, including ranges and analyst counts. - Compare the spread of revenue forecasts for
MSFTacross future periods. - Check
NVDAanalyst estimates against its historical financial performance.
How to install analyst-estimates
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill analyst-estimates -a claude-code2Manually: put the files in place
~/.claude/skills/analyst-estimates/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/analyst-estimates/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill analyst-estimates -a codex2Manually: put the files in place
.agents/skills/analyst-estimates/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill analyst-estimates -a cursor2Manually: put the files in place
.cursor/skills/analyst-estimates/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OctagonAI/skills skills/analyst-estimates2Manually: put the files in place
.github/skills/analyst-estimates/SKILL.md1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill analyst-estimates -a gemini-cli2Platform CLI
gemini skills install https://github.com/OctagonAI/skills --path skills/analyst-estimatesManually: put the files in place
.devin/skills/analyst-estimates/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill analyst-estimates -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 analyst-estimates
How do I install analyst-estimates in Claude Code?
Run npx skills add OctagonAI/skills --skill analyst-estimates -a claude-code. The skill file is at ~/.claude/skills/analyst-estimates/SKILL.md.
What does analyst-estimates do?
It retrieves analyst revenue and EPS projections for public companies through Octagon MCP. Results include averages, estimate ranges, and analyst counts.
What does analyst-estimates need to run?
Configure Octagon MCP in your AI agent first. The skill uses that connection to fetch financial estimates.
Source text
SKILL.md · MIT
---
name: analyst-estimates
description: Retrieve analyst financial estimates including Revenue and EPS projections with low/high ranges and analyst coverage. Use when analyzing forward expectations, consensus estimates, valuation inputs, or comparing projections to historical performance.
---
# Analyst Estimates
Retrieve analyst financial estimates 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 analyst financial estimates for <TICKER> for the annual period, limited to <N> records on page 0.
```
**MCP Call:**
```json
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Retrieve analyst financial estimates for AAPL for the annual period, limited to 10 records on page 0"
}
}
```
## Output Format
The agent returns a table with analyst estimates across future periods:
| Fiscal Year Ending | Revenue Estimate (Low to High) | Revenue Avg | EPS Estimate (Low to High) | EPS Avg | # Revenue Analysts | # EPS Analysts |
|-------------------|-------------------------------|-------------|---------------------------|---------|-------------------|----------------|
| 2030-09-27 | $540.64B - $600.88B | $566.24B | $12.01 - $13.78 | $12.77 | 9 | 6 |
| 2029-09-27 | $520.95B - $578.99B | $545.62B | $10.62 - $12.17 | $11.28 | 13 | 6 |
| 2028-09-27 | $515.19B - $520.48B | $517.84B | $8.96 - $11.18 | $10.20 | 18 | 15 |
| 2027-09-27 | $474.27B - $531.94B | $490.97B | $8.41 - $9.77 | $9.23 | 31 | 30 |
| 2026-09-27 | $445.03B - $483.54B | $460.35B | $7.84 - $8.92 | $8.42 | 24 | 29 |
**Data Source:** octagon-financials-agent
## Key Observations Pattern
After receiving data, generate observations:
1. **Growth trajectory**: Calculate implied revenue and EPS CAGR
2. **Estimate dispersion**: Analyze spread between low and high estimates
3. **Analyst coverage**: Note number of analysts covering each period
4. **Near vs far-term**: Compare confidence in near-term vs long-term estimates
5. **Historical comparison**: Compare estimates to actual historical performance
## Metrics Reference
| Metric | Definition |
|--------|------------|
| Revenue Estimate (Low to High) | Range of analyst revenue projections |
| Revenue Avg | Consensus average revenue estimate |
| EPS Estimate (Low to High) | Range of analyst EPS projections |
| EPS Avg | Consensus average EPS estimate |
| # Revenue Analysts | Number of analysts providing revenue estimates |
| # EPS Analysts | Number of analysts providing EPS estimates |
## Analysis Tips
### Implied Growth Rate
```
Implied CAGR = (Future Estimate / Current)^(1/Years) - 1
```
Example: ($566B / $416B)^(1/5) - 1 = 6.4% revenue CAGR
### Estimate Dispersion
```
Dispersion = (High - Low) / Average × 100
```
- Narrow dispersion (<10%) = High consensus
- Wide dispersion (>20%) = Significant uncertainty
### Analyst Coverage Quality
- More analysts = more reliable consensus
- Declining coverage = less institutional interest
- <5 analysts = thin coverage, use caution
### Forward P/E Calculation
```
Forward P/E = Current Price / EPS Estimate
```
Use for valuation relative to growth expectations.
### Estimate Revisions (with follow-up)
Track changes over time:
- Upward revisions = positive momentum
- Downward revisions = negative momentum
- Frequency of revisions matters
## Valuation Applications
### DCF Inputs
Use estimates for:
- Revenue projections
- Margin assumptions (with historical data)
- Terminal growth rate guidance
### Relative Valuation
Compare:
- Forward P/E to historical average
- Forward P/E to peers
- PEG ratio (P/E / Growth rate)
### Earnings Surprise Potential
Compare estimates to:
- Management guidance
- Historical beat/miss rate
- Recent operating trends
## Confidence Assessment
### High Confidence Estimates
- Near-term (1-2 years out)
- Many analysts covering
- Narrow dispersion
- Stable business model
### Low Confidence Estimates
- Long-term (5+ years out)
- Few analysts covering
- Wide dispersion
- Rapidly changing industry
## Follow-up Queries
Based on results, suggest deeper analysis:
- "What factors are driving the projected revenue growth from [YEAR1] to [YEAR2]?"
- "How do these estimates compare to [COMPANY]'s historical financial performance?"
- "What are the key risks to achieving the upper end of these revenue estimates?"
- "Retrieve analyst price targets and ratings for [TICKER]"
© OctagonAI · MIT · OctagonAI/skills