chore(skills/stocks): relocate to optional-skills/finance/stocks/

This commit is contained in:
teknium1 2026-05-10 22:23:30 -07:00 committed by Teknium
parent 896a7ce261
commit 2ea957fc41
2 changed files with 0 additions and 0 deletions

View file

@ -1,82 +0,0 @@
---
name: stocks
description: Real-time stock quotes, price history, company search, multi-stock compare, and crypto prices via Yahoo Finance. No API key required.
version: 1.0.0
author: Mibayy
license: MIT
metadata:
hermes:
tags: [stocks, finance, market, trading, crypto, yahoo-finance, investing]
category: finance
requires_toolsets: [terminal]
---
# Stocks & Finance Skill
Real-time stock market data via Yahoo Finance.
5 commands: quote, search, history, compare, crypto.
No API key needed. Python stdlib only.
---
## When to Use
- User asks for a stock price (AAPL, TSLA, MSFT...)
- User wants to look up a company by name
- User wants price history or performance over time
- User wants to compare multiple stocks side by side
- User asks for a crypto price (BTC, ETH, SOL...)
---
## Prerequisites
Python 3.8+ stdlib only. No pip installs.
Script path: `~/.hermes/skills/finance/scripts/stocks_client.py`
---
## Quick Reference
```
SCRIPT=~/.hermes/skills/finance/scripts/stocks_client.py
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 stocks by company name. Returns top 5: symbol, name, exchange, type.
### history SYMBOL [--range RANGE]
Price history. Ranges: 1mo, 3mo, 6mo, 1y, 5y (default: 1mo).
Returns OHLCV per day + stats (min, max, avg, total_return_pct).
### compare SYMBOL1 SYMBOL2 [...]
Side-by-side: price, change%, 52w performance.
### crypto SYMBOL [SYMBOL2...]
Crypto prices. Pass BTC not BTC-USD (appended automatically).
---
## Pitfalls
- Yahoo Finance API is unofficial and may change without notice.
- market_cap and pe_ratio may return null (require session crumb).
- Rate limits: add delays between bulk requests.
---
## Verification
```bash
python3 ~/.hermes/skills/finance/scripts/stocks_client.py quote AAPL
```