Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add staskh/trading_skills --skill report-stock -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/report-stock/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/report-stock/

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

Similar skills

All skills for Finance and business →

From the same set12

The whole set →
news-sentiment The news-sentiment skill fetches recent stock news from Yahoo Finance and gauges market sentiment. Use it to find out what's in the headlines and how it might sway the stock price. CX Codex +1 253installs fundamentals The fundamentals skill retrieves financial statements, earnings, and company metrics from Yahoo Finance. Use it when an agent needs fundamental analysis for a ticker. CX Codex +1 188installs stock-quote stock-quote is a Claude Code skill that fetches current price, volume, change, and 52-week range for any ticker. CX Codex +1 138installs greeks Skill computes option Greeks (delta, gamma, theta, vega) and implied volatility using the Black-Scholes model. Use it to understand how your position reacts to price changes, time decay, and shifts in volatility. CX Codex +1 137installs option-chain Skill pulls option chain data from Yahoo Finance: calls and puts with strike prices, bids, asks, volumes, and implied volatility. Use it to check option quotes for a specific expiration date. CX Codex +1 117installs risk-assessment risk-assessment calculates risk metrics for stocks and positions: volatility, beta, Value at Risk, and maximum drawdown. Use it to assess position risk and determine sizing. CX Codex +1 113installs ib-portfolio ib-portfolio — a skill for Claude Code fetches open positions and holdings from Interactive Brokers. The agent invokes it when asked about current stocks, portfolio value, or account assets. CX Codex +1 107installs spread-analysis The spread-analysis skill performs quantitative analysis of multi-leg option strategies for Claude Code. It triggers on requests concerning vertical spreads, iron condors, straddles, or strangle strategies. CX Codex +1 105installs

Project sponsors

Companies that keep this analytics open