# Agent Skills

> Install SentiSense skills into Claude Code, Cursor, Codex, Gemini or OpenClaw with one command. Twenty-one read-only skills for sentiment, smart money, options, earnings, screening and full research workflows.

Base URL: `github.com/SentiSenseApp/skills`
Tier: Free + PRO (uses your API key)

All API access requires an API key via the `X-SentiSense-API-Key` header. Keys look like `ss_live_...`.

> SDKs: [Python](https://github.com/SentiSenseApp/sentisense#quick-start) · [Node](https://github.com/SentiSenseApp/sentisense-node#quick-start)

## Overview

Agent skills are plain markdown playbooks your coding agent reads to learn SentiSense: which endpoints exist, how to authenticate, and how to run multi-step research workflows. Install once and your agent can pull sentiment, smart-money flows, politician trades, and more without you pasting docs into the chat.

- **What it is:** twenty-one read-only skills, installed as files into your agent. No trading, no account changes, no writes.
- **Auth:** your SentiSense API key, read from the `SENTISENSE_API_KEY` environment variable.
- **Related:** the [MCP connector](/docs/api/connectors/) is a curated read-only slice for chat apps, and the [REST API](/docs/api/) is the raw surface the skills drive.

---

## Install

### Claude Code

```bash
claude plugin marketplace add SentiSenseApp/skills
claude plugin install sentisense@sentisense
```

Installs the whole collection as one plugin. Inside a session the same steps are `/plugin marketplace add SentiSenseApp/skills` and `/plugin install sentisense@sentisense`; each skill is then available as `sentisense:<skill-name>`.

### Other agents

```bash
npx skills add SentiSenseApp/skills
```

Cursor, Codex, Gemini and other coding agents, through the open-source [skills.sh](https://skills.sh) installer. Add `-s <skill-name>` to install one skill, or `--list` to see every skill by name.

### OpenClaw

```bash
openclaw plugins install clawhub:@sentisenseapp/stock-analysis
```

The `stock-analysis` bundle plugin installs every skill from [ClawHub](https://clawhub.ai/thesentitrader). A single skill installs on its own, for example `openclaw skills install @thesentitrader/sentisense`. Walkthrough: [how to add live market data to your OpenClaw agent](/blog/how-to-add-market-data-to-your-openclaw-agent/).

### Copy to your agent

```text
Install the SentiSense skills for me.

- In Claude Code: run `claude plugin marketplace add SentiSenseApp/skills`, then `claude plugin install sentisense@sentisense`.
- In Cursor, Codex, Gemini or another coding agent: run `npx skills add SentiSenseApp/skills`.
- On OpenClaw: run `openclaw plugins install clawhub:@sentisenseapp/stock-analysis`.
- If you cannot run an installer: fetch https://sentisense.ai/skill.md and follow it.

Then check whether the SENTISENSE_API_KEY environment variable is set. If it is not, tell me to create a free key at https://app.sentisense.ai/get-api-key and wait until I have set it. Never ask me to paste the key into this chat.

Once the key is set, read the 0-sentisense-onboarding skill, make one request to confirm the key works, and tell me which skills are installed.
```

Paste it into any agent. It picks the installer that fits and checks your key.

The installers copy our public skill files from [github.com/SentiSenseApp/skills](https://github.com/SentiSenseApp/skills) into your agent; nothing runs at install time. Without an installer, point your agent at [sentisense.ai/skill.md](https://sentisense.ai/skill.md), the full API reference as one file, and tell it to fetch and follow it.

---

## Authenticate

```bash
export SENTISENSE_API_KEY="ss_live_..."
```

Get a key free at [app.sentisense.ai/get-api-key](https://app.sentisense.ai/get-api-key), or manage an existing one in the [developer console](https://app.sentisense.ai/settings/developer). The skills send it as the `X-SentiSense-API-Key` header on every request. Your account tier applies as usual: Free gets the monthly quota with preview-depth data on PRO endpoints, and PRO unlocks the full payload.

---

## The skills

### Start here

| Skill | What it does |
|-------|--------------|
| `0-sentisense-onboarding` | Read first: API key setup and which skill owns which task. The router for the collection. |
| `sentisense` | The full API reference: every endpoint, auth, quotas, and response shapes. The one to install if you are building your own tooling. |
| `sentisense-cli` | The official CLI, run via `npx` with nothing to install: quotes, sentiment, and market data as single commands, with a `--json` mode returning exact API responses. |

### Research and terminals

| Skill | What it does |
|-------|--------------|
| `stock-terminal` | Turns chat into a financial terminal: commands like `open NVDA`, `screen smart-money`, or `daily brief` return composite research reports. |
| `stocks-analysis` | Committee-style US stock analysis: investor personas independently research a thesis, attack each other's cases, and reconcile into a verdict. Worked example: [AI stock analysis by investment committee](/blog/ai-stock-analysis-investment-committee/). |
| `stock-earnings-analysis` | Reads a quarter end to end: the per-quarter analysis report, the risk-factor diffs attached to the quarter they belong to, who reported this week, and the forward calendar. |
| `last-30-days-in-markets` | Synthesizes the month into one brief: the day-by-day arc of market mood, the biggest story themes, and the signals that accumulated, each claim carrying its date. |
| `stock-market-dashboard` | Builds a morning market briefing as a single self-contained HTML file: mood gauge, sector heat, options radar, watchlist, flows, and the week's calendar. |
| `stock-ontology` | Company knowledge graph for AI agents: the people and products behind a ticker, any tracked entity by name, and each one's SentiSense Score over the same window. |

### Signals and trackers

| Skill | What it does |
|-------|--------------|
| `stock-sentiment` | Focused sentiment and smart-money positioning reads for US stocks. |
| `stock-screener` | Filters stocks and ETFs on the SentiSense Score, analyst, technical, and price fields in one query, or runs the 28 curated screens; translates plain-language asks into valid plans. |
| `analyst-ratings-tracker` | Wall Street ratings and price targets: who covers a stock and where each firm stands, upgrades and downgrades by ticker and market-wide, one analyst's call history, and the Street versus the crowd. |
| `insider-trading-tracker` | SEC Form 4 insider trading: buys and sells by ticker, market-wide activity, cluster buy signals, and 10b5-1 plan detection. |
| `institutional-13f-tracker` | Quarterly 13F institutional ownership by ticker or manager: top holders, quarter-over-quarter buying and selling, activist positions. |
| `politicians-stock-tracker` | Congressional trading disclosures: trades by member, by ticker, and STOCK Act filings. |
| `unusual-options-activity` | End-of-day options positioning ranked against each ticker's own history: IV rank, put/call percentile, skew, open-interest walls, and max pain. |
| `company-kpi-tracker` | Company KPIs from earnings filings: segment and product revenue, deliveries, subscribers, unit sales and non-GAAP operating metrics, with the filing citation, quarter-over-quarter and year-over-year changes, preliminary values and discontinued histories. |

### Visual tools and calculators

| Skill | What it does |
|-------|--------------|
| `market-heatmap` | Draws the whole market as one self-contained interactive HTML page: a treemap sized by market cap and grouped by sector, recolourable by move, sentiment, Score, mentions or options interest. |
| `expected-move-visualizer` | Turns implied volatility into an offline HTML chart: the modeled 30, 60 and 90 day expected-move cone around the current price, skewed by 25-delta demand, with IV rank and the next earnings date marked. |
| `options-payoff-calculator` | An interactive expiry profit-and-loss chart for calls, puts, spreads, straddles and condors, pre-loaded with the ticker's own price, IV and skew. Premiums are modeled from end-of-day IV, not quoted from a live chain. |
| `position-size-calculator` | Share count, position value, dollar at risk and R multiple from an account size, a risk percentage and a stop, pre-filled with the ticker's last price and its 14-session average true range. Guide: [position size calculator](/blog/position-size-calculator/). |

All twenty-one are read-only. Per-skill security audits are on [ClawHub](https://clawhub.ai/thesentitrader).

---

## Notes

- **Quotes are 15-minute delayed; sentiment and news are batch.** Prices refresh continuously, while sentiment reads and news annotations are recomputed on a regular cadence.
- **Coverage spans the most-watched US stocks**, not every ticker.
- The skills provide market information for informational and educational purposes only. It is not investment advice.
- Use of the API through a skill is governed by the [API Terms of Service](https://sentisense.ai/agreement/api-terms/).