Skill Introduction

Overview

Stock quotes, history, search, compare, crypto via Yahoo.

Core value

Turns reusable Other know-how into an installable skill, helping users complete github, community, ai, ai-agent work faster.

Target users

Developers, testers, and maintainers who handle Other tasks in Focus Code.
Teams that already trust workflows or content from NousResearch.
Users who want standardized prompts, steps, or conventions instead of repeating setup work.

Best practices

Read the skill content first to confirm required inputs, expected outputs, and dependencies.
Try it on a small task before relying on it for critical work.
Add project-specific constraints such as coding style, target platform, test expectations, and delivery format.
For external sources, verify the source link, version, and recent maintenance activity.

Best use cases

Tasks related to github, community, ai, ai-agent that need a reusable execution flow.
Converting a community repo, team convention, or personal workflow into day-to-day assistance.
Starting from a proven skill instead of writing prompts or procedures from scratch.

Limits and boundaries

Results depend on the quality of the original skill content and may need human correction.
It does not replace code review, tests, security review, or professional judgment.
External tools, APIs, account permissions, and local dependencies still need separate setup.

Differentiation

Structured around Other, making it easier to discover and reuse than loose prompt snippets.
Marked as GitHub, which helps users judge trust and maintenance expectations.
Keeps the original source link available for repository, documentation, or discussion follow-up.
Tagged with github, community, ai, ai-agent, so it can be filtered by concrete task intent.

Install and use

Install

Copy Install Command

focus install stocks-8394e1

View source

Detail Preview

SKILL.md

Primary filemarkdown3 KB

name: stocks description: Stock quotes, history, search, compare, crypto via Yahoo. version: 0.1.0 author: Mibay (Mibayy), Hermes Agent license: MIT platforms: [linux, macos, windows] metadata: hermes: tags: [Stocks, Finance, Market, Crypto, Investing] category: finance related_skills: [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
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.

stocks