ratings-snapshot — Claude Code skill: fundamental stock ratings and metrics
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.
MIT 260 installs ★ 132 updated 2026-06-05
npx skills add OctagonAI/skills --skill ratings-snapshot -a claude-codeWhat ratings-snapshot does
ratings-snapshot queries data via Octagon MCP and returns a table with seven ratings for each company. The overall rating is a letter from A to F; component scores run from 1 to 5, with higher being better. You can pass multiple tickers at once (AAPL, MSFT, GOOGL) and cap the number of results. The skill shows whether a stock looks undervalued by DCF, how profitable the company is (ROE, ROA), its debt level, and valuation attractiveness (P/E, P/B). Octagon MCP must be set up in your AI agent for this to work.
What it helps with
- screen stocks using fundamental quality metrics
- compare financial strength across multiple companies
- identify potentially undervalued stocks by DCF score
- assess a company's profitability and leverage quickly
Example prompts for the agent
- Get a ratings snapshot for Apple, Microsoft and Google showing key metrics
- Fetch Nvidia's rating scores, limited to 5 records, to evaluate the quality profile
- Compare overall ratings and ROE for three competitors in the tech sector
How to install ratings-snapshot
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill ratings-snapshot -a claude-code2Manually: put the files in place
~/.claude/skills/ratings-snapshot/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ratings-snapshot/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill ratings-snapshot -a codex2Manually: put the files in place
.agents/skills/ratings-snapshot/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill ratings-snapshot -a cursor2Manually: put the files in place
.cursor/skills/ratings-snapshot/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OctagonAI/skills skills/ratings-snapshot2Manually: put the files in place
.github/skills/ratings-snapshot/SKILL.md1Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill ratings-snapshot -a gemini-cli2Platform CLI
gemini skills install https://github.com/OctagonAI/skills --path skills/ratings-snapshotManually: put the files in place
.devin/skills/ratings-snapshot/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OctagonAI/skills --skill ratings-snapshot -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 ratings-snapshot
How do I install ratings-snapshot in Claude Code?
Run npx skills add OctagonAI/skills --skill ratings-snapshot -a claude-code in your terminal, then edit ~/.claude/skills/ratings-snapshot/SKILL.md as needed.
What do the ratings in ratings-snapshot mean?
The overall rating (A–F) is a composite quality score. Component scores (1–5) show how the company ranks on each metric: return on equity (ROE), return on assets (ROA), debt-to-equity ratio (D/E), price-to-earnings (P/E), and price-to-book (P/B). Five is best, one is worst.
What do I need to use ratings-snapshot?
Octagon MCP must be configured in your AI agent (Cursor, Claude Desktop, Windsurf and others). See references/mcp-setup.md in the repository for setup instructions.
Source text
SKILL.md · MIT
---
name: ratings-snapshot
description: Retrieve ratings snapshot with overall rating and key metric scores including DCF, ROE, ROA, Debt-to-Equity, P/E, and P/B for public companies. Use when screening stocks, comparing quality metrics, or quick fundamental assessment.
---
# Ratings Snapshot
Retrieve ratings snapshot with overall rating and key metric scores 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 a ratings snapshot with overall rating and key metric scores (DCF, ROE, ROA, Debt-to-Equity, P/E, P/B) for <TICKER(S)>, limited to <N> records.
```
**MCP Call:**
```json
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Retrieve a ratings snapshot with overall rating and key metric scores (DCF, ROE, ROA, Debt-to-Equity, P/E, P/B) for AAPL, MSFT, GOOGL, limited to 10 records"
}
}
```
## Output Format
The agent returns a table with rating scores:
| Metric | Score |
|--------|-------|
| Overall Rating | B |
| Discounted Cash Flow (DCF) | 3 |
| Return on Equity (ROE) | 5 |
| Return on Assets (ROA) | 5 |
| Debt-to-Equity | 1 |
| Price-to-Earnings (P/E) | 2 |
| Price-to-Book (P/B) | 1 |
**Data Sources:** octagon-financials-agent, octagon-stock-data-agent
## Metrics Reference
| Metric | What It Measures | Higher Score Means |
|--------|------------------|-------------------|
| Overall Rating | Composite assessment (A-F or similar) | Better overall quality |
| DCF Score | Intrinsic value vs market price | More undervalued |
| ROE Score | Return on shareholder equity | Better profitability |
| ROA Score | Return on total assets | Better asset efficiency |
| Debt-to-Equity | Leverage assessment | Lower leverage (better) |
| P/E Score | Earnings valuation | More attractive valuation |
| P/B Score | Book value valuation | More attractive valuation |
## Score Interpretation
### Overall Rating Scale
| Rating | Interpretation |
|--------|----------------|
| A | Excellent - Top quality |
| B | Good - Above average |
| C | Average - Moderate quality |
| D | Below Average - Concerns present |
| F | Poor - Significant issues |
### Component Scores (typically 1-5)
| Score | Interpretation |
|-------|----------------|
| 5 | Excellent - Top quintile |
| 4 | Good - Above average |
| 3 | Average - Middle of pack |
| 2 | Below Average - Bottom half |
| 1 | Poor - Bottom quintile |
## Analysis Tips
### Quick Screening
Use ratings for initial filtering:
- Focus on A/B overall ratings
- Look for multiple high component scores
- Flag low scores for investigation
### Identify Strengths and Weaknesses
Component analysis reveals:
- High ROE + High ROA = Efficient operator
- Low D/E = Conservative financing
- Low P/E + Low P/B = Value candidate
- High DCF = Potentially undervalued
### Peer Comparison
Compare ratings across competitors:
- Same industry normalization important
- Relative ranking within sector
- Identify best-in-class
### Value vs Quality Trade-off
Different profiles:
- High profitability + High valuation = Quality premium
- Low profitability + Low valuation = Value trap risk
- High profitability + Low valuation = Potential opportunity
## Component Deep Dives
### DCF (Discounted Cash Flow)
- Compares intrinsic value to market price
- High score = stock appears undervalued
- Based on cash flow projections
### ROE (Return on Equity)
- Net Income / Shareholders' Equity
- Measures profit per dollar of equity
- Industry-relative comparison important
### ROA (Return on Assets)
- Net Income / Total Assets
- Measures profit per dollar of assets
- Lower for asset-heavy industries
### Debt-to-Equity
- Total Debt / Shareholders' Equity
- Lower = less financial risk
- Industry norms vary significantly
### P/E (Price-to-Earnings)
- Stock Price / Earnings Per Share
- Lower may indicate value
- Compare to growth rate (PEG)
### P/B (Price-to-Book)
- Market Cap / Book Value
- Lower may indicate value
- Less relevant for asset-light companies
## Follow-up Queries
Based on results, suggest deeper analysis:
- "What specific ratings criteria are used to calculate these scores?"
- "Are there historical trends in these metrics for [COMPANY]?"
- "What is the methodology for calculating the overall rating from component scores?"
- "Compare detailed financial metrics for [TICKER1] vs [TICKER2]"
© OctagonAI · MIT · OctagonAI/skills