skills/us-stock-analysis/SKILL.md
Comprehensive US stock analysis including fundamental analysis (financial metrics, business quality, valuation), technical analysis (indicators, chart patterns, support/resistance), stock comparisons, and investment report generation. Use when user requests analysis of US stock tickers (e.g., "analyze AAPL", "compare TSLA vs NVDA", "give me a report on Microsoft"), evaluation of financial metrics, technical chart analysis, or investment recommendations for American stocks.
npx skillsauth add kavi-lin/stock us-stock-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Comprehensive single-ticker US equity analysis — fundamentals, technicals, valuation, comparison, investment reports. See README.md for tone / formatting pedagogy and example queries.
Fetch via web search tools (always verify recency — prefer last quarter):
Search patterns: {ticker} {specific metric}, earnings reports, 10-K / 10-Q for deep financials.
Quality sources (tier order): Yahoo Finance, Google Finance, MarketWatch, Bloomberg, CNBC, Seeking Alpha; company IR pages; SEC EDGAR (filings); TradingView / StockCharts (technicals).
Decide which based on user ask:
Steps:
Output: company description (1-2 sentences) → current price / trading metrics → valuation metrics table → recent performance → notable news (if any).
Steps:
references/fundamental-analysis.md (framework)references/financial-metrics.md (metric definitions + formulas)references/report-template.mdCritical checks:
Steps:
references/technical-analysis.md (indicator definitions + patterns)Interpretation:
Steps:
references/report-template.md (full structure)Report sections required: Executive summary (w/ recommendation) → Company overview → Investment thesis (bull + bear) → Fundamental analysis → Technical analysis → Valuation → Risk assessment → Catalysts + timeline → Conclusion.
Triggers: "compare AAPL vs MSFT", "TSLA vs NVDA which is better"
Steps:
references/fundamental-analysis.md + references/financial-metrics.mdOutput: follow "Comparison Report Structure" in references/report-template.md.
Load conditionally based on workflow:
| File | When | Contains |
|---|---|---|
| references/technical-analysis.md | Technical workflow | Indicator definitions, chart patterns, S/R concepts |
| references/fundamental-analysis.md | Fundamental / Comparison | Business quality, financial health, valuation frameworks, red flags |
| references/financial-metrics.md | Any metric calc needed | All ratios + formulas (profitability, valuation, growth, liquidity, leverage, efficiency, cash flow) |
| references/report-template.md | Comprehensive / Comparison report | Full report structure, section templates, comparison format |
(Extended style guidance + tone examples in README.md.)
development
# earnings-analyst — 個股財報深度分析 > **Trigger**: `財報 [TICKER]` > **Version**: V1.0 > **Data Source**: FMP HTTP REST(`$FMP_API_KEY`) ## 目的 針對單一個股產出**深度財報分析報告**(逐季趨勢、品質指標、估值、分析師共識),涵蓋 sector V1.4 與 `分析 [TICKER]` 既有 protocol **沒有**的「財報層級」深潛內容。 ## 與既有 skill 的差異 | Skill | 重點 | 觸發 | |---|---|---| | `us-stock-analysis` | 估值/技術/情緒 snapshot(yfinance + FMP partial) | Phase 2 fundamentals lane | | `earnings-valuation-forecaster` | 12M 目標價 3×3 敏感度 | ad-hoc / earnings 前 14 天 | | `earnings-trade-analyzer` |
testing
Daily Top N hot themes × Top M short-term movers per theme. Combines theme-detector heat scoring (medium-term) with short-term-target predictions (1d/5d/15d) into a "Tactical Opportunity Radar" recommendation log. Tags concentration WARNING when ≥2 picks share theme. Records FRED + market regime snapshot at recommendation time for future backtest cross-tabs. Standalone — not auto-wired into investment_protocol. Use for daily watchlist refresh / Dashboard推薦面板feed / batch screening across hot themes.
testing
Short-term (1d / 5d / 15d) directional projection for a US stock — "Tactical Opportunity Radar". Outputs target range + confidence breakdown + benchmark-relative alpha + trading meta (stop / position size hint / exit trigger). Each horizon uses independent weights from config/weights.yaml. Refuses to project when source data is stale (returns insufficient_data with reasons). Hard-clamped to prevent cold-start absurd predictions. Use when caller wants short-term directional bias on a specific ticker, NOT for long-term valuation (use earnings-valuation-forecaster for 12-month). Standalone — not auto-wired into investment_protocol.
tools
Shared Finnhub API client used by other skills. Provides rate-limited (60/min), cached, retry-aware access to 17 Finnhub endpoints covering quotes, OHLCV, fundamentals, earnings calendar, earnings surprises, insider transactions, recommendation history, price targets, upgrades/downgrades, dividends, splits, IPOs, and SEC filings. Also exports adapters that normalize Finnhub raw responses into FMP-compatible shapes so that downstream code can swap providers without changing call sites. Use when another skill needs Finnhub data or when building a unified provider layer.