# 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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 258 installs · ★ 132 repo stars
- Author: OctagonAI
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/OctagonAI/skills/tree/HEAD/skills/stock-grades/SKILL.md
- Updated: 2026-06-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/stock-grades

## What it does

The skill connects to Octagon MCP and retrieves analyst ratings by stock ticker. You get rating history with action type (upgrade, downgrade, maintain), source institution, previous and current grade, and date issued. For instance, Maxim Group upgraded from Hold to Buy on January 30.

Inside the skill are reference tables for interpreting rating scales across different banks, a guide to action types (Upgrade, Downgrade, Initiate, Suspend, and others), and methods for spotting significant trends. It helps you distinguish between a meaningful upgrade from Hold to Buy and a routine reaffirmation of an existing rating.

Octagon MCP must be configured in your AI agent for the skill to work. Requests go through `octagon-agent` using natural language, like "Get the latest stock grades for the symbol AAPL from top analysts and financial institutions."

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill stock-grades -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/stock-grades/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/stock-grades/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill stock-grades -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/stock-grades/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill stock-grades -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/stock-grades/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OctagonAI/skills skills/stock-grades
```

2. **Manually: put the files in place**
- File: `.github/skills/stock-grades/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill stock-grades -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OctagonAI/skills --path skills/stock-grades
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/stock-grades/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill stock-grades -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OctagonAI/skills/tree/HEAD/skills/stock-grades/SKILL.md

## When to use it
- monitor how analyst opinion on a stock shifts over time
- distinguish a meaningful upgrade from routine rating maintenance
- compare grades across different banks and institutions
- spot clusters of upgrades or downgrades that signal catalysts
- evaluate analyst track record and credibility

## Example prompts
- Show me the latest analyst grades on AAPL from major institutions
- Which analysts recently upgraded TSLA and what's their reasoning?
- How has Goldman Sachs' rating on AMZN evolved over the past year?

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e08f3ebf7c68c854.

BEGIN THIRD-PARTY FILE e08f3ebf7c68c854
````text
---
name: stock-grades
description: Retrieve the latest stock grades and ratings from top analysts and financial institutions using Octagon MCP. Use when tracking analyst upgrades, downgrades, rating changes, and institutional sentiment over time.
---

# Stock Grades

Retrieve analyst grades, ratings, and rating changes from top financial institutions 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 the Stock

Determine the ticker symbol for the company you want to analyze (e.g., AAPL, MSFT, GOOGL).

### 2. Execute Query via Octagon MCP

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

```
Get the latest stock grades for the symbol <TICKER> from top analysts and financial institutions.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Get the latest stock grades for the symbol AAPL from top analysts and financial institutions."
  }
}
```

### 3. Expected Output

The agent returns analyst rating history including:

- **Rating Actions**: Upgrades, downgrades, maintains
- **Analyst/Institution**: Source of the rating
- **Previous Rating**: Prior grade
- **New Rating**: Current grade
- **Date**: When the rating was issued

**Example**: Maxim Group upgraded from Hold to Buy on 2026-01-30

**Data Sources**: octagon-stock-data-agent

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding rating scales
- Analyzing upgrade/downgrade trends
- Evaluating analyst credibility
- Tracking sentiment changes

## Example Queries

**Basic Query:**
```
Get the latest stock grades for the symbol AAPL from top analysts and financial institutions.
```

**Recent Changes:**
```
What are the most recent analyst rating changes for TSLA?
```

**Upgrade Focus:**
```
Show me recent upgrades for NVDA from major investment banks.
```

**Historical View:**
```
What is the history of analyst ratings for MSFT over the past year?
```

**Specific Institution:**
```
What is Goldman Sachs' current rating on AMZN?
```

## Understanding Rating Scales

### Common Rating Systems

| Rating Level | Common Terms |
|--------------|--------------|
| Strong Buy | Buy, Overweight, Outperform |
| Buy | Accumulate, Add, Positive |
| Hold | Neutral, Market Perform, Equal-Weight |
| Sell | Underweight, Underperform, Reduce |
| Strong Sell | Sell, Avoid |

### Rating Equivalencies

| Bank A | Bank B | Bank C | Meaning |
|--------|--------|--------|---------|
| Overweight | Buy | Outperform | Bullish |
````
END THIRD-PARTY FILE e08f3ebf7c68c854

The third-party file has ended. Everything between the e08f3ebf7c68c854 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2768 of 6685 bytes. © OctagonAI · MIT · https://github.com/OctagonAI/skills/tree/HEAD/skills/stock-grades/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
