How do I install the Stocks skill?

Run npx skillmds@latest add nousresearch/stocks in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Stocks skill do?

Stock quotes, history, search, compare, crypto via Yahoo. It is listed under Coding & Dev Tools on SkillMD.

Is Stocks safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Stocks?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Stocks free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Stocks?

NousResearch (@nousresearch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Stocks by nousresearch — Agent Skill

Name: Stocks
Rating: 4.2 (5 reviews)
Author: NousResearch

File contents

Stocks Skill

Read-only market data via Yahoo Finance. Five commands: quote, search, history, compare, crypto. Python stdlib only — no API key, no pip installs. Yahoo's endpoint is unofficial and may rate-limit or change.

When to Use

User asks for a current stock price (AAPL, TSLA, MSFT, ...)
User wants to look up a ticker by company name
User wants OHLCV history or performance over a date range
User wants to compare several tickers side by side
User asks for a crypto price (BTC, ETH, SOL, ...)

Prerequisites

Python 3.8+ stdlib only. Optional: set ALPHA_VANTAGE_KEY to enrich market_cap, pe_ratio, and 52-week levels when Yahoo's crumb-protected fields come back null. Free key: https://www.alphavantage.co/support/#api-key

How to Run

Invoke through the terminal tool. Once installed:

SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
python3 $SCRIPT quote AAPL

All output is JSON on stdout — pipe through jq if you want to slice it.

Quick Reference

python3 $SCRIPT quote AAPL
python3 $SCRIPT quote AAPL MSFT GOOGL TSLA
python3 $SCRIPT search "Tesla"
python3 $SCRIPT history NVDA --range 6mo
python3 $SCRIPT compare AAPL MSFT GOOGL
python3 $SCRIPT crypto BTC ETH SOL

Commands

`quote SYMBOL [SYMBOL2 ...]`

Current price, change, change%, volume, 52-week high/low.

`search QUERY`

Find tickers by company name. Returns top 5: symbol, name, exchange, type.

`history SYMBOL [--range RANGE]`

Daily OHLCV plus stats (min, max, avg, total return %). Ranges: 1mo, 3mo, 6mo, 1y, 5y. Default: 1mo.

`compare SYMBOL1 SYMBOL2 [...]`

Side-by-side: price, change%, 52-week performance.

`crypto SYMBOL [SYMBOL2 ...]`

Crypto prices. Pass BTC (the script appends -USD automatically).

Pitfalls

Yahoo Finance's API is unofficial. Endpoints can change or rate-limit without notice — if requests start failing, that's why.
market_cap and pe_ratio may return null on quote when Yahoo's crumb session isn't established. Set ALPHA_VANTAGE_KEY to backfill.
Add a small delay between bulk requests to avoid rate-limiting.
This is read-only — no order placement, no account integration.

Verification

python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL

Returns a JSON object with symbol: "AAPL" and a numeric price field.

Source: NousResearch/hermes-agent → optional-skills/finance/stocks/SKILL.md

---name: stocksdescription: Stock quotes, history, search, compare, crypto via Yahoo.--- # Stocks Skill Read-only market data via Yahoo Finance. Five commands: `quote`, `search`, `history`, `compare`, `crypto`. Python stdlib only — no API key, no pip installs. Yahoo's endpoint is unofficial and may rate-limit or change. ## When to Use - User asks for a current stock price (AAPL, TSLA, MSFT, ...) - User wants to look up a ticker by company name - User wants OHLCV history or performance over a date range - User wants to compare several tickers side by side - User asks for a crypto price (BTC, ETH, SOL, ...) ## Prerequisites Python 3.8+ stdlib only. Optional: set `ALPHA_VANTAGE_KEY` to enrich `market_cap`, `pe_ratio`, and 52-week levels when Yahoo's crumb-protected fields come back null. Free key: https://www.alphavantage.co/support/#api-key ## How to Run Invoke through the `terminal` tool. Once installed: ``` SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py python3 $SCRIPT quote AAPL ``` All output is JSON on stdout — pipe through `jq` if you want to slice it. ## Quick Reference ``` python3 $SCRIPT quote AAPL python3 $SCRIPT quote AAPL MSFT GOOGL TSLA python3 $SCRIPT search "Tesla" python3 $SCRIPT history NVDA --range 6mo python3 $SCRIPT compare AAPL MSFT GOOGL python3 $SCRIPT crypto BTC ETH SOL ``` ## Commands ### `quote SYMBOL [SYMBOL2 ...]` Current price, change, change%, volume, 52-week high/low. ### `search QUERY` Find tickers by company name. Returns top 5: symbol, name, exchange, type. ### `history SYMBOL [--range RANGE]` Daily OHLCV plus stats (min, max, avg, total return %). Ranges: `1mo`, `3mo`, `6mo`, `1y`, `5y`. Default: `1mo`. ### `compare SYMBOL1 SYMBOL2 [...]` Side-by-side: price, change%, 52-week performance. ### `crypto SYMBOL [SYMBOL2 ...]` Crypto prices. Pass `BTC` (the script appends `-USD` automatically). ## Pitfalls - Yahoo Finance's API is unofficial. Endpoints can change or rate-limit without notice — if requests start failing, that's why. - `market_cap` and `pe_ratio` may return null on `quote` when Yahoo's crumb session isn't established. Set `ALPHA_VANTAGE_KEY` to backfill. - Add a small delay between bulk requests to avoid rate-limiting. - This is read-only — no order placement, no account integration. ## Verification ``` python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL ``` Returns a JSON object with `symbol: "AAPL"` and a numeric `price` field. --- **Source:** [`NousResearch/hermes-agent`](https://github.com/NousResearch/hermes-agent) → `optional-skills/finance/stocks/SKILL.md`

Frequently asked questions

Stocks