@heylemon/lemonade 0.2.2 → 0.2.3

package/skills/stock-analysis/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: stock-analysis
+description: Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
+version: 6.2.0
+homepage: https://finance.yahoo.com
+commands:
+  - /stock - Analyze a stock or crypto (e.g., /stock AAPL)
+  - /stock_compare - Compare multiple tickers
+  - /stock_dividend - Analyze dividend metrics
+  - /stock_watch - Add/remove from watchlist
+  - /stock_alerts - Check triggered alerts
+  - /stock_hot - Find trending stocks & crypto (Hot Scanner)
+  - /stock_rumors - Find early signals, M&A rumors, insider activity (Rumor Scanner)
+  - /portfolio - Show portfolio summary
+  - /portfolio_add - Add asset to portfolio
+metadata: {"lemonade":{"emoji":"📈","requires":{"bins":["uv"],"env":[]},"install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}
+---
+
+# Stock Analysis v6.1
+
+Analyze US stocks and cryptocurrencies with 8-dimension analysis, portfolio management, watchlists, alerts, dividend analysis, and **viral trend detection**.
+
+## What's New in v6.2
+
+- **Rumor Scanner** — Early signals before mainstream news
+  - M&A rumors and takeover bids
+  - Insider buying/selling activity
+  - Analyst upgrades/downgrades
+  - Twitter/X "hearing that...", "sources say..." detection
+- **Impact Scoring** — Rumors ranked by potential market impact
+
+## What's in v6.1
+
+- **Hot Scanner** — Find viral stocks & crypto across multiple sources
+- **Twitter/X Integration** — Social sentiment via bird CLI
+- **Multi-Source Aggregation** — CoinGecko, Google News, Yahoo Finance
+- **Cron Support** — Daily trend reports
+
+## What's in v6.0
+
+- **Watchlist + Alerts** — Price targets, stop losses, signal changes
+- **Dividend Analysis** — Yield, payout ratio, growth, safety score
+- **Fast Mode** — `--fast` skips slow analyses (insider, news)
+- **Improved Performance** — `--no-insider` for faster runs
+
+## Quick Commands
+
+### Stock Analysis
+```bash
+# Basic analysis
+uv run {baseDir}/scripts/analyze_stock.py AAPL
+
+# Fast mode (skips insider trading & breaking news)
+uv run {baseDir}/scripts/analyze_stock.py AAPL --fast
+
+# Compare multiple
+uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL
+
+# Crypto
+uv run {baseDir}/scripts/analyze_stock.py BTC-USD ETH-USD
+```
+
+### Dividend Analysis
+```bash
+uv run {baseDir}/scripts/dividends.py JNJ
+uv run {baseDir}/scripts/dividends.py JNJ PG KO MCD --output json
+```
+
+### Watchlist + Alerts
+```bash
+uv run {baseDir}/scripts/watchlist.py add AAPL
+uv run {baseDir}/scripts/watchlist.py add AAPL --target 200
+uv run {baseDir}/scripts/watchlist.py add AAPL --stop 150
+uv run {baseDir}/scripts/watchlist.py list
+uv run {baseDir}/scripts/watchlist.py check
+```
+
+### Portfolio Management
+```bash
+uv run {baseDir}/scripts/portfolio.py create "Tech Portfolio"
+uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150
+uv run {baseDir}/scripts/portfolio.py show
+```
+
+### Hot Scanner
+```bash
+python3 {baseDir}/scripts/hot_scanner.py
+python3 {baseDir}/scripts/hot_scanner.py --no-social
+python3 {baseDir}/scripts/hot_scanner.py --json
+```
+
+### Rumor Scanner
+```bash
+python3 {baseDir}/scripts/rumor_scanner.py
+```
+
+## Analysis Dimensions (8 for stocks, 3 for crypto)
+
+### Stocks
+| Dimension | Weight | Description |
+|-----------|--------|-------------|
+| Earnings Surprise | 30% | EPS beat/miss |
+| Fundamentals | 20% | P/E, margins, growth |
+| Analyst Sentiment | 20% | Ratings, price targets |
+| Historical | 10% | Past earnings reactions |
+| Market Context | 10% | VIX, SPY/QQQ trends |
+| Sector | 15% | Relative strength |
+| Momentum | 15% | RSI, 52-week range |
+| Sentiment | 10% | Fear/Greed, shorts, insiders |
+
+### Crypto
+- Market Cap & Category
+- BTC Correlation (30-day)
+- Momentum (RSI, range)
+
+## Supported Cryptos (Top 20)
+
+BTC, ETH, BNB, SOL, XRP, ADA, DOGE, AVAX, DOT, MATIC, LINK, ATOM, UNI, LTC, BCH, XLM, ALGO, VET, FIL, NEAR
+
+(Use `-USD` suffix: `BTC-USD`, `ETH-USD`)
+
+## Limitations
+
+- Yahoo Finance may lag 15-20 minutes
+- Short interest lags ~2 weeks (FINRA)
+- Insider trades lag 2-3 days (SEC filing)
+- US markets only (non-US incomplete)
+
+## Disclaimer
+
+**NOT FINANCIAL ADVICE.** For informational purposes only. Consult a licensed financial advisor before making investment decisions.