Professional investment analysis and stock evaluation skills for Claude Code.

📖 English | 繁體中文版 (Traditional Chinese)

📚 View Documentation Website

• 📝 Blog Post: InvestSkill - Claude Code Financial Analysis Plugin
• 📊 Example Output: Comprehensive Analysis Report (PLTR)

claude

# add to marketplace
/plugin marketplace add yennanliu/InvestSkill


# install
/plugin install us-stock-analysis


# check installed list

/plugin list

# test
- /us-stock-analysis:fundamental-analysis AAPL # - For fundamental analysis
- /us-stock-analysis:technical-analysis AAPL # - For technical analysis
- /us-stock-analysis:economics-analysis # - For economic context

• Local dev

claude

# Add local marketplace
/plugin marketplace add /Users/yennanliu/InvestSkill

# Install plugin
/plugin install us-stock-analysis@invest-skill

InvestSkill is a comprehensive Claude Code plugin marketplace that provides professional-grade skills for US stock market analysis, including fundamental analysis, technical analysis, economic assessment, and portfolio management.

• Stock Evaluation: Comprehensive analysis with Piotroski F-Score, ROIC/WACC, DCF framework, and risk matrix
• Economics Analysis: US macro indicators with yield curve, credit spreads, and recession probability scoring
• Fundamental Analysis: Deep-dive financial statement analysis with visualizations
• Technical Analysis: Chart patterns, multi-timeframe analysis, Volume Profile, and Ichimoku Cloud
• Portfolio Review: Performance analysis and optimization
• Sector Analysis: Sector rotation and market positioning
• Interactive Reports: Generate HTML/PDF reports with visualizations and signal blocks
• Earnings Call Analysis: Analyze earnings call transcripts for sentiment and insights
• Insider Trading Tracking: Monitor insider buying/selling activity from SEC filings
• Institutional Ownership: Track smart money moves from 13F filings
• Dividend Analysis: Dividend safety scoring, yield trap detection, and income projections
• Short Interest Analysis: Squeeze scoring, borrow rates, bearish thesis evaluation
• Options Analysis: Greeks, IV analysis, strategy selector, and earnings plays
• Research Bundle: Full multi-skill analysis chained into a unified investment thesis
• DCF Valuation: Intrinsic value modeling with sensitivity tables and margin of safety
• Competitor Analysis: Economic moat scoring, Porter's Five Forces, competitive benchmarking
• Standardized Signals: All 16 skills output a unified BULLISH/NEUTRAL/BEARISH signal block

Add the marketplace and install the plugin:

# Add marketplace from GitHub
/plugin marketplace add yennanliu/InvestSkill

# Install the plugin
/plugin install us-stock-analysis@invest-skill

# Add local marketplace
/plugin marketplace add /Users/yennanliu/InvestSkill

# Install plugin
/plugin install us-stock-analysis@invest-skill

• /stock-eval - Evaluate US stocks with Piotroski F-Score, ROIC/WACC, DCF framework, and risk matrix
• /economics-analysis - Analyze US economic indicators, yield curve, credit spreads, and recession probability
• /fundamental-analysis - Deep fundamental analysis using financials (with --visual flag)
• /technical-analysis - Technical chart analysis with MTF, Volume Profile, Ichimoku (with --chart flag)
• /portfolio-review - Portfolio performance and optimization review
• /sector-analysis - US market sector analysis and rotation

• /report-generator - Generate professional HTML/PDF reports with interactive charts and signal blocks
• /earnings-call-analysis - Analyze earnings call transcripts for sentiment, themes, and management tone
• /insider-trading - Track insider buying/selling activity from SEC Form 4 filings
• /institutional-ownership - Monitor institutional holdings changes from 13F filings

• /dividend-analysis - Dividend safety scoring, Chowder Rule, yield trap detection, income projections
• /short-interest - Short squeeze scoring, borrow rates, bearish thesis evaluation
• /options-analysis - Greeks analysis, IV rank, strategy selector, earnings play setup
• /research-bundle - Full multi-skill research chained into a unified investment thesis with composite score
• /dcf-valuation - Intrinsic value DCF model with 3-scenario sensitivity table and margin of safety
• /competitor-analysis - Economic moat scoring, Porter's Five Forces, competitive benchmarking

# Evaluate a specific stock
/stock-eval AAPL

# Get economic outlook
/economics-analysis

# Deep dive into fundamentals
/fundamental-analysis MSFT

# Deep dive with visualizations
/fundamental-analysis NVDA --visual

# Technical chart analysis
/technical-analysis TSLA

# Technical analysis with chart generation
/technical-analysis GOOGL --chart

# Review portfolio
/portfolio-review [paste your holdings]

# Analyze sectors
/sector-analysis

# Generate HTML/PDF report with visualizations
/report-generator --type comprehensive --data [paste analysis results]

# Analyze earnings call transcript
/earnings-call-analysis AAPL [paste transcript or provide URL]

# Track insider trading activity
/insider-trading TSLA

# Monitor institutional ownership changes
/institutional-ownership MSFT

# Track specific institutional investors
/institutional-ownership META --smart-money

# Dividend safety and income analysis
/dividend-analysis JNJ
/dividend-analysis --portfolio [list of tickers]

# Short squeeze potential
/short-interest GME
/short-interest --scan squeeze-potential

# Options strategy selection
/options-analysis AAPL --strategy bullish
/options-analysis NVDA --earnings
/options-analysis TSLA --iv

# Comprehensive research bundle (chains all skills)
/research-bundle AAPL
/research-bundle NVDA --quick
/research-bundle AAPL,MSFT,GOOGL --compare

# DCF intrinsic value model
/dcf-valuation MSFT
/dcf-valuation NVDA --scenarios
/dcf-valuation GOOGL --visual

# Competitive moat analysis
/competitor-analysis AAPL
/competitor-analysis NVDA --peers AMD,INTC,QCOM
/competitor-analysis GOOGL --moat-only

# Step 1: Run fundamental analysis with visualization
/fundamental-analysis AAPL --visual

# Step 2: Generate HTML report from the analysis
/report-generator --type comprehensive

# Step 3: Open HTML file in browser and export to PDF
# The report includes interactive charts and can be printed to PDF

InvestSkill/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace configuration
├── plugins/
│   └── us-stock-analysis/
│       ├── .claude-plugin/
│       │   └── plugin.json       # Plugin manifest
│       ├── skills/
│       │   ├── stock-eval/
│       │   │   └── SKILL.md
│       │   ├── economics-analysis/
│       │   │   └── SKILL.md
│       │   ├── fundamental-analysis/
│       │   │   └── SKILL.md      # Enhanced with visualization support
│       │   ├── technical-analysis/
│       │   │   └── SKILL.md      # Enhanced with chart generation
│       │   ├── portfolio-review/
│       │   │   └── SKILL.md
│       │   ├── sector-analysis/
│       │   │   └── SKILL.md
│       │   ├── report-generator/
│       │   │   └── SKILL.md      # New: Generate HTML/PDF reports
│       │   ├── earnings-call-analysis/
│       │   │   └── SKILL.md      # New: Earnings call analysis
│       │   ├── insider-trading/
│       │   │   └── SKILL.md      # New: Insider transaction tracking
│       │   ├── institutional-ownership/
│       │   │   └── SKILL.md      # New: 13F filings analysis
│       │   ├── dividend-analysis/
│       │   │   └── SKILL.md      # New v1.2.0: Dividend safety and income analysis
│       │   ├── short-interest/
│       │   │   └── SKILL.md      # New v1.2.0: Short squeeze and bearish positioning
│       │   ├── options-analysis/
│       │   │   └── SKILL.md      # New v1.2.0: Greeks, IV, and strategy selection
│       │   ├── research-bundle/
│       │   │   └── SKILL.md      # New v1.2.0: Multi-skill research orchestration
│       │   ├── dcf-valuation/
│       │   │   └── SKILL.md      # New v1.2.0: DCF intrinsic value modeling
│       │   └── competitor-analysis/
│       │       └── SKILL.md      # New v1.2.0: Moat and competitive positioning
│       └── README.md
├── LICENSE
└── README.md

InvestSkill v1.1.0 introduces professional report generation capabilities with interactive visualizations.

• HTML Reports: Standalone HTML files with embedded Chart.js visualizations
• PDF Export: Print-to-PDF support via browser or command-line tools
• Interactive Charts: Line charts, bar charts, candlestick charts, and more
• Professional Styling: Financial report-grade formatting and layout
• Mobile Responsive: Works on desktop and mobile devices

1. Run Analysis with Visualization

   /fundamental-analysis AAPL --visual

   This generates analysis with chart data tables

2. Generate HTML Report

   /report-generator --type comprehensive

   Creates investment-report-AAPL-20260217-143022.html

3. Export to PDF

   • Browser: Open HTML → Print → Save as PDF
   • Command Line: wkhtmltopdf report.html report.pdf
   • Node.js: Use Playwright or Puppeteer

• Executive Summary: 1-2 pages, key metrics and charts
• Comprehensive Analysis: 5-10 pages, full detailed analysis
• Portfolio Review: Multi-stock comparison and allocation

• Revenue/earnings growth trends (line charts)
• Profit margin comparisons (line charts)
• Balance sheet composition (stacked bar charts)
• Cash flow waterfalls (waterfall charts)
• Valuation multiples (grouped bar charts)
• Price charts with indicators (candlestick + overlays)
• Volume analysis (bar charts)
• Technical indicators (RSI, MACD panels)

This project includes comprehensive GitHub Actions workflows for quality assurance and automated releases.

Validation (validate.yml)

• Runs on every push and PR to main/develop branches
• Validates JSON structure (marketplace.json, plugin.json)
• Checks required files and fields
• Validates SKILL.md frontmatter
• Ensures version consistency across files

PR Checks (pr-check.yml)

• Quick validation on pull requests
• JSON syntax checking
• Required fields validation
• SKILL.md file linting

Auto Release (release.yml)

• Triggers on version tags (v*)
• Creates distribution packages (.tar.gz)
• Generates SHA256 checksums
• Creates GitHub releases with artifacts
• Extracts release notes from CHANGELOG.md

Auto Labeling (label-pr.yml)

• Automatically labels PRs based on changed files
• Adds size labels (small/medium/large)
• Helps with PR organization and review

First-Time Contributor Greetings (greetings.yml)

• Welcomes new contributors
• Provides helpful information for first-time issues/PRs

To create a new release:

1. Update version numbers:

   # Update plugins/us-stock-analysis/.claude-plugin/plugin.json
   # Update .claude-plugin/marketplace.json

2. Update CHANGELOG.md:

   ## [1.1.0] - 2026-02-16
   ### Added
   - New feature description

3. Commit changes:

   git add .
   git commit -m "chore: bump version to 1.1.0"
   git push origin main

4. Create and push tag:

   git tag v1.1.0
   git push origin v1.1.0

5. GitHub Actions will automatically:

   • Validate the plugin structure
   • Create distribution packages
   • Generate release notes
   • Publish the release with artifacts

Add these badges to show build status (update username/repo):

![Validate](https://github.com/yennanliu/InvestSkill/actions/workflows/validate.yml/badge.svg)
![Release](https://github.com/yennanliu/InvestSkill/actions/workflows/release.yml/badge.svg)

Contributions are welcome! Please read our Contributing Guide for detailed information.

Quick Start:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'feat: add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines on:

• Adding new skills
• Creating plugins
• Testing changes
• Commit message format
• Version numbering

To share this marketplace with others:

1. Push to GitHub:

git add .
git commit -m "Initial plugin marketplace setup"
git push origin main

2. Users can then add your marketplace:

/plugin marketplace add yennanliu/InvestSkill

• Add options analysis skill (v1.2.0)
• Add DCF valuation skill (v1.2.0)
• Add dividend analysis skill (v1.2.0)
• Add competitor/moat analysis (v1.2.0)
• Add crypto analysis skill
• Add earnings calendar integration
• Add news sentiment analysis
• Add risk management calculator (VaR, stress testing)
• Add backtesting capabilities
• Add international market skills (EU, Asia)
• Add real-time data API integrations

MIT License - see LICENSE file for details.

This plugin provides educational analysis and is not financial advice. Always consult with qualified financial advisors before making investment decisions. Past performance does not guarantee future results.

• Claude Code Documentation
• Plugin Development Guide
• Marketplace Guide

For issues, questions, or suggestions, please open an issue on GitHub.