report-stock — Claude Code skill: what it does, how to install
report-stock builds stock research reports in Markdown or PDF covering market trends, PMCC viability, and company fundamentals.
MIT 123 installs ★ 417 updated 2026-10-21
npx skills add staskh/trading_skills --skill report-stock -a claude-codeWhat report-stock does
The skill generates equity reports for stock tickers. It evaluates momentum indicators like RSI, MACD, and ADX alongside valuation ratios, balance sheet health, and the complete 9-point Piotroski F-Score breakdown. It also screens options setups, checking Poor Man's Covered Call viability, vertical spreads, and iron condors.
Everything runs through a Python script invoked via uv, pulling data from internal scanners like scanner-bullish, scanner-pmcc, and fundamentals. Markdown files are written to the sandbox/ directory, with optional conversion to PDF handled via the markdown-to-pdf skill. Without Python, the uv runner, and the supporting trading-skills tools, data gathering will not execute.
What it helps with
- generate stock research documents in Markdown or PDF
- evaluate Poor Man's Covered Call viability for single tickers
- calculate the 9-criterion Piotroski F-Score breakdown
- screen option spread strategies such as straddles and iron condors
Example prompts for the agent
- Generate an analysis report for AAPL in markdown
- Analyze MSFT and save the summary as a PDF
- Run fundamental and PMCC analysis for GOOGL
How to install report-stock
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill report-stock -a claude-code2Manually: put the files in place
~/.claude/skills/report-stock/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/report-stock/
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill report-stock -a codex2Manually: put the files in place
.agents/skills/report-stock/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill report-stock -a cursor2Manually: put the files in place
.cursor/skills/report-stock/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install staskh/trading_skills .claude/skills/report-stock2Manually: put the files in place
.github/skills/report-stock/SKILL.md1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill report-stock -a gemini-cli2Platform CLI
gemini skills install https://github.com/staskh/trading_skills --path .claude/skills/report-stockManually: put the files in place
.devin/skills/report-stock/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill report-stock -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about report-stock
How to install report-stock in Claude Code?
Run npx skills add staskh/trading_skills --skill report-stock -a claude-code in your terminal.
What does report-stock do?
It processes equity metrics, evaluates trend and option viability, then exports a report with a BUY, HOLD, or AVOID recommendation.
What is needed to export reports as PDF?
You need uv, Python, and the companion markdown-to-pdf skill available in your workspace.
Source text
SKILL.md · MIT
---
name: report-stock
description: Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis
user_invocable: true
arguments:
- name: symbols
description: Stock ticker symbol(s) - single or space-separated list (e.g., AAPL or "AAPL MSFT GOOGL")
required: true
dependencies: ["trading-skills"]
---
# 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:
```bash
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:
```bash
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:
1. The recommendation (BUY/HOLD/AVOID)
2. Key strengths and risks
3. The report file path
## Example
```bash
# 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`:
1. **Header** — symbol, company name, generated timestamp
2. **Recommendation** — BUY/HOLD/AVOID with strengths and risks
3. **Company Overview** — sector, industry, market cap, beta
4. **Trend Analysis** — bullish score, RSI, MACD, ADX, SMA distances, earnings date, signals list
5. **Fundamental Analysis** — valuation (P/E, P/B, EPS), profitability (margins, ROE, ROA, growth), dividend & balance sheet, earnings history (up to 8 quarters)
6. **Piotroski F-Score** — all 9 criteria with PASS/FAIL
7. **Insider Trading** — net sentiment, buy/sell counts, recent transactions (omitted if no data)
8. **PMCC Viability** — score, IV, LEAPS/short leg details, trade metrics (yield, capital required)
9. **Option Spread Strategies** — bull call, bear put, straddle, strangle, iron condor
10. **Investment Summary** — strengths and risk factors
11. **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.
© staskh · MIT · staskh/trading_skills