hermes-agent/optional-skills/finance/stocks/SKILL.md
Teknium 4a2198bf51
fix: Windows MCP PATHEXT resolution + python3 -> python in cross-platform skills (#84429)
Two Windows agent-loop friction fixes:

1. tools/mcp_tool.py (#56536): shutil.which(cmd, path=env_path) reads
   executable extensions from the PARENT process PATHEXT, not the MCP
   subprocess env — a stdio MCP config supplying both PATH and PATHEXT
   could fail to resolve a command its own env can locate, and startup
   then got a bare command name. On Windows, when the first which() call
   misses and the config env carries PATHEXT (any key casing), retry the
   resolution with the config's PATHEXT temporarily applied.

2. skills/ + optional-skills/ (#50606): 42 SKILL.md files that declare
   platforms: [.., windows] used python3 in their command examples.
   python3 does not exist on native Windows (the toolchain probe in the
   system prompt reports python3=missing), so every copy-pasted example
   burned a failed agent turn before self-correction. Replaced the
   command word python3 -> python (python3-config / python3.x version
   strings untouched). python is the spelling that exists in every
   Hermes-managed environment (Windows native, uv-managed venvs on all
   three OSes); agents on POSIX hosts additionally see the probed
   toolchain line and adapt either way.
2026-08-12 02:43:28 -07:00

2.7 KiB

name description version author license platforms metadata
stocks Stock quotes, history, search, compare, crypto via Yahoo. 0.1.0 Mibay (Mibayy), Hermes Agent MIT
linux
macos
windows
hermes
tags category related_skills
Stocks
Finance
Market
Crypto
Investing
finance
dcf-model
comps-analysis
lbo-model

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
python $SCRIPT quote AAPL

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

Quick Reference

python $SCRIPT quote AAPL
python $SCRIPT quote AAPL MSFT GOOGL TSLA
python $SCRIPT search "Tesla"
python $SCRIPT history NVDA --range 6mo
python $SCRIPT compare AAPL MSFT GOOGL
python $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

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

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