Stock Analysis
Pull Yahoo Finance stock and crypto metrics, compare tickers, and manage a local portfolio with periodic performance reports from your agent.
Overview
stock-analysis is an agent skill for the Grow phase that analyzes US stocks and cryptocurrencies via Yahoo Finance, manages portfolios, and supports periodic performance reports.
Install
npx skills add https://github.com/gracefullight/stock-checker --skill stock-analysisWhat is this skill?
- uv-run Python scripts: single ticker, multi-ticker compare, JSON output
- 8 analysis dimensions for US stocks; 3 dimensions for crypto
- Top-20 market-cap crypto tickers (BTC-USD, ETH-USD, SOL-USD, etc.)
- Portfolio flows: create portfolio, add/remove assets, track holdings
- Periodic reports: daily, weekly, monthly, quarterly, yearly
- 8 analysis dimensions for stocks
- 3 analysis dimensions for cryptocurrencies
- Top 20 cryptocurrencies by market cap supported
Adoption & trust: 10.1k installs on skills.sh; 28 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need quick, repeatable equity and crypto snapshots and portfolio tracking from the agent without building a custom market data integration.
Who is it for?
Indie founders tracking personal or side-project treasury, watching earnings reactions, or monitoring a small set of liquid tickers and top crypto pairs.
Skip if: Production trading bots, compliance-grade brokerage integrations, or teams that cannot run uv and local Python scripts.
When should I use this skill?
Use for stock analysis, portfolio tracking, earnings reactions, or crypto monitoring with Yahoo Finance data.
What do I get? / Deliverables
You get script-driven analysis tables or JSON, portfolio updates, and cadence-friendly performance views grounded in Yahoo Finance data.
- Per-ticker or multi-ticker analysis output (text or --output json)
- Portfolio state updates and periodic performance summaries when those flows are invoked
Recommended Skills
Journey fit
Portfolio and periodic reports fit Grow analytics—measuring positions and performance over time rather than building product features. Canonical shelf is analytics: multi-dimensional analysis scripts and report cadences (daily through yearly).
How it compares
CLI skill package wired to Yahoo Finance—not a hosted dashboard SaaS or an MCP market data server.
Common Questions / FAQ
Who is stock-analysis for?
Solo builders who want agent-invoked stock and crypto checks, comparisons, and lightweight portfolio tracking from the terminal.
When should I use stock-analysis?
In Grow analytics when reviewing portfolio performance, comparing candidate tickers before reallocating personal funds, or checking major crypto pairs after market moves.
Is stock-analysis safe to install?
It runs local scripts and calls external finance data; confirm env and brew installs, and review the Security Audits panel on this Prism page before use.
SKILL.md
READMESKILL.md - Stock Analysis
# Stock Analysis (v5.0) Analyze US stocks and cryptocurrencies using Yahoo Finance data. Includes portfolio management, crypto support, and periodic analysis. ## Quick Start **IMPORTANT:** Pass ONLY the stock ticker symbol(s) as arguments. Do NOT add extra text, headers, or formatting in the command. Analyze a single ticker: ```bash uv run {baseDir}/scripts/analyze_stock.py AAPL uv run {baseDir}/scripts/analyze_stock.py MSFT --output json ``` Compare multiple tickers: ```bash uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL ``` ## Cryptocurrency Analysis (v5.0) Analyze top 20 cryptocurrencies by market cap: ```bash uv run {baseDir}/scripts/analyze_stock.py BTC-USD uv run {baseDir}/scripts/analyze_stock.py ETH-USD SOL-USD ``` **Supported Cryptos:** BTC-USD, ETH-USD, BNB-USD, SOL-USD, XRP-USD, ADA-USD, DOGE-USD, AVAX-USD, DOT-USD, MATIC-USD, LINK-USD, ATOM-USD, UNI-USD, LTC-USD, BCH-USD, XLM-USD, ALGO-USD, VET-USD, FIL-USD, NEAR-USD **Crypto Analysis Dimensions:** - Market cap (large/mid/small classification) - Category (Smart Contract L1, DeFi, Payment, etc.) - BTC correlation (30-day) - Momentum (RSI, price range) - Market context (VIX, general market regime) ## Portfolio Management (v5.0) Create and manage portfolios with mixed assets (stocks + crypto): ```bash # Create portfolio uv run {baseDir}/scripts/portfolio.py create "My Portfolio" # Add assets uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150.00 uv run {baseDir}/scripts/portfolio.py add BTC-USD --quantity 0.5 --cost 40000 --portfolio "My Portfolio" # View holdings with current P&L uv run {baseDir}/scripts/portfolio.py show # Update/remove assets uv run {baseDir}/scripts/portfolio.py update AAPL --quantity 150 uv run {baseDir}/scripts/portfolio.py remove BTC-USD # List/delete portfolios uv run {baseDir}/scripts/portfolio.py list uv run {baseDir}/scripts/portfolio.py delete "My Portfolio" ``` **Portfolio Storage:** `~/.clawdbot/skills/stock-analysis/portfolios.json` ## Portfolio Analysis (v5.0) Analyze all assets in a portfolio with optional period returns: ```bash # Analyze portfolio uv run {baseDir}/scripts/analyze_stock.py --portfolio "My Portfolio" # With period returns (daily/weekly/monthly/quarterly/yearly) uv run {baseDir}/scripts/analyze_stock.py --portfolio "My Portfolio" --period weekly uv run {baseDir}/scripts/analyze_stock.py -p "My Portfolio" --period monthly ``` **Portfolio Summary includes:** - Total cost, current value, P&L - Period return (if specified) - Concentration warnings (>30% in single asset) - Recommendation summary (BUY/HOLD/SELL counts) **Examples:** - ✅ CORRECT: `uv run {baseDir}/scripts/analyze_stock.py BAC` - ✅ CORRECT: `uv run {baseDir}/scripts/analyze_stock.py BTC-USD` - ❌ WRONG: `uv run {baseDir}/scripts/analyze_stock.py === BANK OF AMERICA (BAC) - Q4 2025 EARNINGS ===` - ❌ WRONG: `uv run {baseDir}/scripts/analyze_stock.py "Bank of America"` Use the ticker symbol only (e.g., BAC, not "Bank of America"). For crypto, use the -USD suffix (e.g., BTC-USD). ## Analysis Components The script evaluates eight key dimensions: 1. **Earnings Surprise (30% weight)**: Actual vs expected EPS, revenue beats/misses 2. **Fundamentals (20% weight)**: P/E ratio, profit margins, revenue growth, debt levels 3. **Analyst Sentiment (20% weight)**: Consensus ratings, price target vs curren