Menu
Perform institutional-grade analysis of any US-listed stock using real-time and fundamental data from the Finskills API.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | us-stock-analyzer |
| version | 1.0.1 |
| description | Perform institutional-grade analysis of any US-listed stock using real-time and fundamental data from the Finskills API. |
| author | finskills |
| homepage | https://github.com/finskills/us-stock-analyzer |
| credentials | [{"name":"FINSKILLS_API_KEY","description":"Finskills API key — register for free at https://finskills.net (Pro plan unlocks historical data, financials, and batch quotes)","required":true,"link":"https://finskills.net"}] |
Perform institutional-grade analysis of any US-listed stock using real-time and fundamental data from the Finskills API. Delivers a structured investment report covering business quality, financial health, valuation, analyst consensus, and key risks — all in a single conversation turn.
API Key required — Register at https://finskills.net to get your free key (Pro plan for full functionality).
Set your key as: FINSKILLS_API_KEY=your_key_here
All requests use header: X-API-Key: <your_api_key>
Activate when the user:
Before starting, resolve:
AAPL, NVDA, MSFT. Ask if not provided.Make the following API calls in parallel (all require X-API-Key header):
GET https://finskills.net/v1/stocks/quote/{SYMBOL}
Extract: price, change, changePercent, volume, marketCap, week52High, week52Low, avgVolume
GET https://finskills.net/v1/stocks/profile/{SYMBOL}
Extract: name, sector, industry, description, employees, website, country, exchange
GET https://finskills.net/v1/stocks/financials/{SYMBOL}
Extract from income statement: revenue, grossProfit, operatingIncome, netIncome, eps
Extract from balance sheet: totalDebt, cashAndEquivalents, totalAssets, totalEquity
Extract from cash flow: operatingCashFlow, freeCashFlow, capitalExpenditures
GET https://finskills.net/v1/stocks/recommendations/{SYMBOL}
Extract: strongBuy, buy, hold, sell, strongSell counts; consensus rating; mean target price; price target range
GET https://finskills.net/v1/stocks/earnings/{SYMBOL}
Extract: last 4 quarters of EPS (actual vs estimate, beat/miss); next quarter EPS estimate; revenue estimates
GET https://finskills.net/v1/stocks/holders/{SYMBOL}
Extract: top 5 holders, total institutional ownership %, recent changes (bought/sold)
Confirm all API calls returned success: true. Note which data provider served
each call (source field). Flag any stale data (cached > 24h for quotes).
Score each dimension 1–5:
| Dimension | Signals to Look For |
|---|---|
| Competitive Moat | Market leadership, pricing power, switching costs, network effects |
| Management Quality | Capital allocation history, FCF conversion, debt management |
| Revenue Quality | Recurring/subscription vs one-time, customer concentration |
| Growth Trajectory | YoY revenue growth trend (accelerating/decelerating/stable) |
Calculate a composite Business Quality Score (BQS) = average of the four dimensions.
Compute and interpret:
| Metric | Formula | Benchmark |
|---|---|---|
| Gross Margin | grossProfit / revenue | Industry-specific |
| Operating Margin | operatingIncome / revenue | > 15% healthy |
| FCF Margin | freeCashFlow / revenue | > 10% excellent |
| Net Debt / EBITDA | (totalDebt − cash) / EBITDA | < 2x conservative |
| ROE | netIncome / totalEquity | > 15% strong |
| FCF Yield | freeCashFlow / marketCap | > 4% attractive |
| Current Ratio | currentAssets / currentLiabilities | > 1.5 healthy |
Flag any metric outside healthy range with a ⚠️ symbol.
Calculate:
| Ratio | Formula | Context |
|---|---|---|
| P/E (TTM) | price / EPS_TTM | vs sector average |
| Forward P/E | price / EPS_NextYear_estimate | vs 5-yr historical avg |
| EV/EBITDA | (marketCap + netDebt) / EBITDA | < 15x value zone |
| P/FCF | marketCap / freeCashFlow | vs growth peers |
| PEG Ratio | P/E / EPS_3yr_growth | < 1.0 undervalued |
Classify valuation as: Deep Value / Fair Value / Premium / Stretched
Provide a range-based fair value estimate using at least two methods (DCF implied from FCF yield, and P/E reversion to sector mean).
Analyze earnings history (last 4 quarters):
Analyst consensus summary:
Systematically identify:
Based on all data, output:
═══════════════════════════════════════════════════
US STOCK ANALYSIS REPORT — {TICKER} ({DATE})
═══════════════════════════════════════════════════
📌 COMPANY SNAPSHOT
{Company Name} | {Sector} | {Industry}
Price: ${price} Change: {change}% Market Cap: ${marketCap}
52-Week Range: ${week52Low} — ${week52High}
📊 BUSINESS QUALITY SCORE: {BQS}/5
◦ Competitive Moat: {score}/5 — {brief rationale}
◦ Management Quality: {score}/5 — {brief rationale}
◦ Revenue Quality: {score}/5 — {brief rationale}
◦ Growth Trajectory: {score}/5 — {brief rationale}
💰 FINANCIAL HEALTH
Revenue Growth (YoY): {%} | Gross Margin: {%} | Operating Margin: {%}
FCF Margin: {%} | Net Debt/EBITDA: {x} | ROE: {%}
[⚠️ Flag any concerns]
📐 VALUATION
TTM P/E: {x} | Forward P/E: {x} | EV/EBITDA: {x}
P/FCF: {x} | PEG: {x}
Assessment: {Deep Value / Fair Value / Premium / Stretched}
Fair Value Range: ${low} — ${high}
📈 ANALYST CONSENSUS
Rating: {consensus} | Mean Target: ${target} ({upside}% upside)
Distribution: {strongBuy}SB / {buy}B / {hold}H / {sell}S / {strongSell}SS
Analysts: {count} | Target Range: ${low} — ${high}
📋 EARNINGS QUALITY
Beat Rate: {%} ({n}/{total} quarters) | Avg Surprise: {+/-}%
Next Quarter EPS Estimate: ${estimate}
⚠️ KEY RISKS
1. {Risk 1}
2. {Risk 2}
3. {Risk 3}
🎯 INVESTMENT VERDICT
Rating: {STRONG BUY / BUY / HOLD / AVOID / SELL}
12M Target: ${target} (Base: ${base} | Bull: ${bull} | Bear: ${bear})
Confidence: {HIGH / MEDIUM / LOW}
Horizon: {investment horizon}
Thesis Summary: {2–3 sentence bull case}
Key Risks: {1–2 sentence risk summary}
═══════════════════════════════════════════════════
source field from API response) in a footnote.