# Agent Skills

> Install SentiSense skills into Claude Code, Cursor, Codex, or Gemini with one command. Six read-only skills: the full API reference, a stock terminal, committee-style stock analysis, 13F flows, politician trades, and stock sentiment.

Base URL: `https://app.sentisense.aigithub.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_...`.
## 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.

Skills are the deepest of the three ways into the same data graph. The [MCP connector](/docs/api/connectors/) is a curated read-only slice for chat apps, the [REST API](/docs/api/) is the raw surface, and skills teach a coding agent to drive the full API well.

- **What it is:** six 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.
- **Agents:** Claude Code, Cursor, Codex, and Gemini via the skills.sh installer; OpenClaw via ClawHub.

---

## Install

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

`npx skills` is the open-source [skills.sh](https://skills.sh) installer for coding agents. It reads our public skill files from GitHub and copies them into your agent. Nothing runs at install time, and you can see exactly what it installs first at [github.com/SentiSenseApp/skills](https://github.com/SentiSenseApp/skills).

Two useful variants:

- Run it with `--list` to see every skill in the collection by name.
- Add `-s <skill-name>` to install just one instead of the whole collection.

### No installer: one URL

The simplest path needs no installer at all. Point your agent at [sentisense.ai/skill.md](https://sentisense.ai/skill.md), a single markdown file with the full API reference, and tell it to fetch and follow it. It is the same content as the `sentisense` skill; installing just makes it a permanent part of your agent instead of a one-off fetch.

### On OpenClaw

Browse the same skills on ClawHub at [clawhub.ai/TheSentiTrader](https://clawhub.ai/TheSentiTrader), or install one directly:

```bash
npx clawhub install sentisense
```

---

## Authenticate

The skills authenticate with your SentiSense API key, read from the `SENTISENSE_API_KEY` environment variable:

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

Get one free at [app.sentisense.ai/get-api-key](https://app.sentisense.ai/get-api-key), or manage an existing key 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

| Skill | What it does |
|-------|--------------|
| `sentisense` | The full API reference: every endpoint, auth, quotas, and response shapes. The one to install if you are building your own tooling. |
| `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. |
| `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. |
| `stock-sentiment` | Focused sentiment and smart-money positioning reads for US stocks. |

All six are read-only.

---

## Notes

- **Quotes are real-time; sentiment and news are batch.** Prices update live, 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/).