Stock Analysis Report Generator
Generates professional reports with comprehensive stock analysis including trend analysis, PMCC viability, and fundamental metrics. Supports both PDF and markdown output formats.
Instructions
Step 1: Gather Data
Run the report script for each symbol:
uv run python scripts/report.py SYMBOL
The script returns detailed JSON with:
recommendation - Overall recommendation with strengths/risks
company - Company info (name, sector, industry, market cap)
trend_analysis - Bullish scanner results (score, RSI, MACD, ADX, SMAs)
pmcc_analysis - PMCC viability (score, LEAPS/short details, metrics)
fundamentals - Valuation, profitability, dividend, balance sheet, earnings history
piotroski - F-Score breakdown with all 9 criteria
spread_strategies - Option spread analysis (vertical spreads, straddle, strangle, iron condor)
Step 2: Generate Report
Step 2a — Write markdown
Read templates/markdown-template.md for formatting instructions. Generate a markdown report from the JSON data and save to sandbox/ as:
sandbox/{SYMBOL}_Analysis_Report_{YYYY-MM-DD}_{HHmm}.md
Step 2b — Convert to PDF (if requested)
Invoke the markdown-to-pdf skill on the markdown file just created:
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/{SYMBOL}_Analysis_Report_{YYYY-MM-DD}_{HHmm}.md
The PDF is written alongside the markdown file with the same basename.
Step 3: Report Results
After generating the report, tell the user:
- The recommendation (BUY/HOLD/AVOID)
- Key strengths and risks
- The report file path
Example
# Single symbol
uv run python scripts/report.py AAPL
# Multiple symbols - run separately
uv run python scripts/report.py AAPL
uv run python scripts/report.py MSFT
Report Contents
All sections defined in templates/markdown-template.md:
- Header — symbol, company name, generated timestamp
- Recommendation — BUY/HOLD/AVOID with strengths and risks
- Company Overview — sector, industry, market cap, beta
- Trend Analysis — bullish score, RSI, MACD, ADX, SMA distances, earnings date, signals list
- Fundamental Analysis — valuation (P/E, P/B, EPS), profitability (margins, ROE, ROA, growth), dividend & balance sheet, earnings history (up to 8 quarters)
- Piotroski F-Score — all 9 criteria with PASS/FAIL
- Insider Trading — net sentiment, buy/sell counts, recent transactions (omitted if no data)
- PMCC Viability — score, IV, LEAPS/short leg details, trade metrics (yield, capital required)
- Option Spread Strategies — bull call, bear put, straddle, strangle, iron condor
- Investment Summary — strengths and risk factors
- Disclaimer footer
Dependencies
This skill aggregates data from:
scanner-bullish for trend analysis
scanner-pmcc for PMCC viability
fundamentals for financial data and Piotroski score
Timezone
All timestamps and time-based calculations must use the America/New_York timezone. All JSON output must include generated_at (NY time string) and data_delay fields.
1---2name: report-stock3description: Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis4user_invocable: true5arguments:6 - name: symbols7 description: Stock ticker symbol(s) - single or space-separated list (e.g., AAPL or "AAPL MSFT GOOGL")8 required: true9dependencies: ["trading-skills"]10metadata:11 source: https://skillmd.com/skills/staskh/report-stock12---1314# Stock Analysis Report Generator1516Generates professional reports with comprehensive stock analysis including trend analysis, PMCC viability, and fundamental metrics. Supports both PDF and markdown output formats.1718## Instructions1920### Step 1: Gather Data2122Run the report script for each symbol:2324```bash25uv run python scripts/report.py SYMBOL26```2728The script returns detailed JSON with:29- `recommendation` - Overall recommendation with strengths/risks30- `company` - Company info (name, sector, industry, market cap)31- `trend_analysis` - Bullish scanner results (score, RSI, MACD, ADX, SMAs)32- `pmcc_analysis` - PMCC viability (score, LEAPS/short details, metrics)33- `fundamentals` - Valuation, profitability, dividend, balance sheet, earnings history34- `piotroski` - F-Score breakdown with all 9 criteria35- `spread_strategies` - Option spread analysis (vertical spreads, straddle, strangle, iron condor)3637### Step 2: Generate Report3839**Step 2a — Write markdown**4041Read `templates/markdown-template.md` for formatting instructions. Generate a markdown report from the JSON data and save to `sandbox/` as:42```43sandbox/{SYMBOL}_Analysis_Report_{YYYY-MM-DD}_{HHmm}.md44```4546**Step 2b — Convert to PDF (if requested)**4748Invoke the `markdown-to-pdf` skill on the markdown file just created:49```bash50uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/{SYMBOL}_Analysis_Report_{YYYY-MM-DD}_{HHmm}.md51```52The PDF is written alongside the markdown file with the same basename.5354### Step 3: Report Results5556After generating the report, tell the user:571. The recommendation (BUY/HOLD/AVOID)582. Key strengths and risks593. The report file path6061## Example6263```bash64# Single symbol65uv run python scripts/report.py AAPL6667# Multiple symbols - run separately68uv run python scripts/report.py AAPL69uv run python scripts/report.py MSFT70```7172## Report Contents7374All sections defined in `templates/markdown-template.md`:75761. **Header** — symbol, company name, generated timestamp772. **Recommendation** — BUY/HOLD/AVOID with strengths and risks783. **Company Overview** — sector, industry, market cap, beta794. **Trend Analysis** — bullish score, RSI, MACD, ADX, SMA distances, earnings date, signals list805. **Fundamental Analysis** — valuation (P/E, P/B, EPS), profitability (margins, ROE, ROA, growth), dividend & balance sheet, earnings history (up to 8 quarters)816. **Piotroski F-Score** — all 9 criteria with PASS/FAIL827. **Insider Trading** — net sentiment, buy/sell counts, recent transactions (omitted if no data)838. **PMCC Viability** — score, IV, LEAPS/short leg details, trade metrics (yield, capital required)849. **Option Spread Strategies** — bull call, bear put, straddle, strangle, iron condor8510. **Investment Summary** — strengths and risk factors8611. **Disclaimer footer**8788## Dependencies8990This skill aggregates data from:91- `scanner-bullish` for trend analysis92- `scanner-pmcc` for PMCC viability93- `fundamentals` for financial data and Piotroski score949596## Timezone9798All timestamps and time-based calculations must use the `America/New_York` timezone. All JSON output must include `generated_at` (NY time string) and `data_delay` fields.