Agent skill

Report Stock

by staskh in staskh/trading_skills

Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis

MITAuto-check passedBusiness, Finance & HR

Install Report Stock

skills CLI
$ npx skills add staskh/trading_skills --skill report-stock -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install staskh/trading_skills report-stock --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/staskh/trading_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/report-stock .claude/skills/report-stock && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
report-stock
GitHub stars
374
Token cost
~880 tokens
SKILL.md length
343 words
Files
3 (incl. scripts)
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis

  • Works in 3 steps: Gather Data → Generate Report → Report Results
  • Tasks that involve Stock and market analysis
  • SKILL.md covers Instructions, Example, Report Contents and Dependencies, plus 1 more section
  • Runs Python scripts from its folder; calls uv

What it does

Report Stock is an agent skill from staskh/trading_skills. Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/report.py` and `templates/markdown-template.md`).

It sits in Business, Finance & HR, covering Stock and market analysis and PDF. The repository describes itself as: Claude powered advisor system for option traders. The licence is MIT.

When your agent uses it

  • Tasks that involve Stock and market analysis
  • Tasks that involve PDF

Example prompts

  • “/report-stock”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Gather Data
  2. Generate Report
  3. Report Results

What it can do on your machine

Read from SKILL.md and the folder at commit b71a74f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Report Stock loads about 880 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 343 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~880

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from staskh/trading_skills at commit b71a74f, republished under its MIT licence (© staskh). 343 words, ~880 tokens.

Download SKILL.mdSave it as .claude/skills/report-stock/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
report-stock
description
Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis
user_invocable
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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in .claude/skills/report-stock of staskh/trading_skills.

  • SKILL.md
  • scripts/report.py
  • templates/markdown-template.md

Open the folder on GitHubat commit b71a74f

Compare with similar skills

Report Stock next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Report Stock compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Report Stock this skillstaskh/trading_skills374—~880Automated safety check: PassMIT
Finance ReportAojdevStudio/Finance-Guru322—~1.7kAutomated safety check: PassCustom licence
Market Datazhongkaifu/TensorSharp557—~1kAutomated safety check: PassBSD-3-Clause
Breadth Chart Analysttradermonty/claude-trading-skills3k1 repos~8.1kAutomated safety check: PassMIT
Initiating Coveragerongxinzy/RongxinAI1542 repos~7.4kAutomated safety check: PassAGPL-3.0
Mx Finance Datahiboys/ExploreFinance365—~518Automated safety check: PassNone

Similar skills

  • Finance Report

    AojdevStudio/Finance-Guru

    Generate institutional-quality PDF analysis reports for stocks and ETFs.

    322 GitHub stars~1.7k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Market Data

    zhongkaifu/TensorSharp

    Use only for current stock/share prices, ticker quotes, and financial market movers (gainers, losers, most-traded shares).

    557 GitHub stars~1k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Breadth Chart Analyst

    tradermonty/claude-trading-skills

    This skill should be used when analyzing market breadth charts, specifically the S&P 500 Breadth Index (200-Day MA based) and the US Stock Market Uptrend Stock Ratio charts.

    3k GitHub starsUsed in 1 repo~8.1k tokens
    Business, Finance & HRAuto-check passed
  • Initiating Coverage

    rongxinzy/RongxinAI

    Create institutional-quality equity research initiation reports through a 5-task workflow.

    154 GitHub starsUsed in 2 repos~7.4k tokens
    Business, Finance & HRAuto-check passed
  • Mx Finance Data

    hiboys/ExploreFinance

    基于东方财富数据库,支持自然语言查询金融数据,覆盖A港美、基金、债券等多种资产,含实时行情、公司信息、估值、财务报表等,可用于投资研究、交易复盘、市场监控、行业分析、信用研究、财报审计、资产配置等场景,适配机构与个人多元需求。返回结果包含数据说明及 xlsx 文件。Natural language query for financial data across all markets…

    365 GitHub stars~518 tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed
  • Stock Market Hotspot Discovery

    hiboys/ExploreFinance

    面向A股市场热点发现的综合能力。适用于用户提出“今日热点是什么”“当前热股有哪些”等泛化问题时,返回结构化的Markdown热点报告。覆盖热点资讯、热门股票等维度。触发核心条件:用户关注市场层面的热门方向或事件热度,而非单一标的的深度诊断或指标计算。

    365 GitHub stars~537 tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed

More from staskh/trading_skills

All 28 skills in this repo
  • Fundamentals

    staskh/trading_skills

    Get fundamental financial data including financials, earnings, and key metrics.

    374 GitHub starsUsed in 1 repo~836 tokens
    Auto-check passed
  • Greeks

    staskh/trading_skills

    Calculate option Greeks (delta, gamma, theta, vega) and implied volatility for specific options.

    374 GitHub starsUsed in 1 repo~539 tokens
    Auto-check passed
  • Ib Account

    staskh/trading_skills

    Get account summary from Interactive Brokers including cash balance, buying power, and account value.

    374 GitHub starsUsed in 1 repo~535 tokens
    Auto-check: notes
  • Ib Find Short Roll

    staskh/trading_skills

    Find roll options for existing short positions OR find best covered call/put to open against long stock.

    374 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check: notes
  • Ib Option Chain

    staskh/trading_skills

    Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks.

    374 GitHub starsUsed in 1 repo~873 tokens
    Auto-check: notes
  • Ib Portfolio

    staskh/trading_skills

    Get portfolio positions from Interactive Brokers. An agent skill from staskh/trading_skills.

    374 GitHub starsUsed in 1 repo~471 tokens
    Auto-check: notes

Questions about Report Stock

What does Report Stock do?

Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis. Report Stock is an agent skill from staskh/trading_skills.

When should I use Report Stock?

Report Stock fits situations like: tasks that involve Stock and market analysis; tasks that involve PDF.

How do I install Report Stock in Claude Code?

Run `npx skills add staskh/trading_skills --skill report-stock -a claude-code`. Or copy the skill folder (.claude/skills/report-stock in staskh/trading_skills) into .claude/skills/report-stock in your project. Claude Code loads it when a task matches its description.

How do I install Report Stock in Codex?

Run `npx skills add staskh/trading_skills --skill report-stock -a codex`. Or copy the skill folder (.claude/skills/report-stock in staskh/trading_skills) into .agents/skills/report-stock in your project. Codex loads it when a task matches its description.

Can I use Report Stock in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add staskh/trading_skills --skill report-stock -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/report-stock, .gemini/skills/report-stock, .github/skills/report-stock and .opencode/skills/report-stock in your project.

What does Report Stock need to run?

Going by SKILL.md and its folder, Report Stock needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Report Stock access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Report Stock safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Report Stock use?

Report Stock is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Report Stock use?

About 880 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Report Stock?

Skills that share tags, products or a category with Report Stock: Finance Report (AojdevStudio/Finance-Guru, 322 stars), Market Data (zhongkaifu/TensorSharp, 557 stars), Breadth Chart Analyst (tradermonty/claude-trading-skills, 3k stars) and Initiating Coverage (rongxinzy/RongxinAI, 154 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Report Stock?

staskh (a GitHub user) maintains it in staskh/trading_skills, which has 374 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on September 28, 2026.

Source: staskh/trading_skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.