home / skills / gracefullight / stock-checker / trading-analysis

trading-analysis skill

safe

This skill generates institutional-grade investment reports for stocks and ETFs with real-time data, indicators, AI insights, and actionable recommendations.

npx playbooks add skill gracefullight/stock-checker --skill trading-analysis

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

3.9 KB

---
name: trading-analysis
description: Generate professional investment reports for stocks and ETFs. Use when user requests market analysis, investment reports, stock analysis, or trading recommendations for financial instruments (SPY, AAPL, TSLA, etc.). Creates institutional-grade reports with technical indicators, AI-powered insights, charts, and investment recommendations.
---

# Trading Analysis & Investment Report Generator

This skill generates comprehensive investment reports combining real-time market data, technical analysis, Claude AI insights, and professional visualizations.

## What This Skill Does

- Downloads real-time market data from Yahoo Finance
- Calculates 10+ technical indicators (RSI, MACD, Moving Averages, Bollinger Bands, etc.)
- Analyzes market conditions using Claude AI
- Generates 4 types of professional charts (price, indicators, volatility, dashboard)
- Creates institutional-grade investment reports in Markdown format
- Exports structured data in JSON format

## When to Use This Skill

Use this skill when the user requests:
- Investment reports or analysis for specific stocks/ETFs
- Market analysis with technical indicators
- Trading recommendations based on current market conditions
- Professional reports for clients or portfolio review
- Comparative analysis across multiple symbols

## Input Requirements

**Required:**
- `symbol`: Stock ticker (e.g., SPY, AAPL, TSLA, QQQ)

**Optional:**
- `client_name`: Name of the client/investor (default: "Institutional Investors")
- `report_title`: Custom report title (auto-generated if not provided)
- `period`: Historical data period (default: "6mo")

## Output Files

The skill generates the following files in the `reports/` directory:

1. **Markdown Report** (`{SYMBOL}_analysis_report_{timestamp}.md`)
   - Executive summary with sentiment and recommendation
   - Market overview with price tables
   - Technical analysis with indicators
   - AI-powered market intelligence
   - Investment recommendations with entry/exit criteria
   - Risk assessment
   - Chart references

2. **JSON Data** (`{SYMBOL}_analysis_report_{timestamp}_data.json`)
   - Structured data for programmatic access
   - All metrics and analysis results

3. **Charts** (PNG format, 300 DPI):
   - `{SYMBOL}_price_chart.png`: Price with moving averages
   - `{SYMBOL}_indicators_chart.png`: RSI and MACD
   - `{SYMBOL}_volatility_chart.png`: Historical volatility
   - `{SYMBOL}_summary_dashboard.png`: Performance dashboard

## Example Usage

**Simple request:**
"Generate an investment report for SPY"

**Detailed request:**
"Create a market analysis report for AAPL for Acme Capital with the title 'Q4 2025 AAPL Investment Strategy'"

**Multiple symbols:**
"Generate investment reports for SPY, QQQ, and DIA"

## Report Quality

- **Format**: Institutional-grade, suitable for client presentations
- **Data Accuracy**: Real-time market data with verified calculations
- **Visual Quality**: High-resolution charts (300 DPI, print-ready)
- **AI Analysis**: Claude-powered market sentiment and risk assessment
- **Completeness**: Executive summary, technical analysis, recommendations, disclaimers

## Technical Details

- **Data Source**: Yahoo Finance API
- **AI Model**: Claude 3.7 Sonnet (configurable)
- **Chart Resolution**: 300 DPI (print quality)
- **Report Format**: GitHub-flavored Markdown
- **Processing Time**: ~15-30 seconds per symbol

## Safety & Disclaimers

All reports automatically include:
- Investment disclaimer
- Risk warnings
- Clarification that this is informational, not financial advice
- Recommendation to consult qualified financial advisors

## Notes

- Requires valid Anthropic API key in `.env` file
- Requires internet connection for market data
- Historical data limited by Yahoo Finance availability
- AI analysis is based on technical data, not fundamental analysis

Overview

This skill generates institutional-grade investment reports for stocks and ETFs, combining real-time market data, technical indicators, AI-powered insights, and high-resolution charts. It automates analysis and exports professional Markdown reports, structured JSON data, and print-ready PNG charts for each symbol.

How this skill works

It fetches historical and real-time price data, calculates 10+ technical indicators (RSI, MACD, moving averages, Bollinger Bands, volatility, etc.), and runs AI-driven interpretation to summarize sentiment and risk. The skill produces four chart types, compiles an executive summary with entry/exit criteria and risk assessment, and saves both a Markdown report and a JSON data file for programmatic use.

When to use it

Generate single-symbol or multi-symbol investment reports (e.g., SPY, AAPL, TSLA).
Request technical analysis with indicators and trading signals for portfolio review or client presentations.
Create print-ready visualizations and dashboards for investment committees.
Automate daily CSV/JSON exports of indicator values for quantitative workflows.
Produce AI-enhanced market intelligence and risk summaries for short-term trading decisions.

Best practices

Provide a clear symbol list and desired historical period (default 6mo) to control scope and runtime.
Specify client_name and report_title when preparing client-facing documents to personalize output.
Treat AI insights as complementary to indicator-based signals; validate with fundamental or portfolio-level analysis.
Run reports during market hours with an internet connection for real-time pricing; allow 15–30 seconds per symbol.
Store the generated JSON for integration with downstream systems or backtests.

Example use cases

Create a daily monitoring report for SPY and QQQ to detect regime changes and volatility spikes.
Prepare a client presentation: AAPL investment strategy with entry/exit levels and printable charts.
Produce comparative analysis across a basket of ETFs to inform asset allocation decisions.
Automate generation of CSV/JSON indicator feeds for algorithmic trading systems.

FAQ

What inputs are required to generate a report?

You must provide the ticker symbol; period, client_name, and report_title are optional (default period is 6 months).

What output files are produced?

The skill saves a Markdown report, a structured JSON data file, and four PNG charts (price, indicators, volatility, dashboard) in the reports directory.

Does this provide financial advice?

No. Reports include disclaimers and risk warnings; the content is informational and should not replace qualified financial advice.