Skip to content

StanleyChanH/super-hedge-fund-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏦 Super Hedge Fund Skill

Super Hedge Fund Skill Banner

AI-Powered Multi-Agent Stock Analysis for Claude Code

License: MIT Claude Code Python 3.11+

Features β€’ Installation β€’ Usage β€’ Agents β€’ How It Works


πŸ“– Overview

Super Hedge Fund Skill is a Claude Code skill that transforms Claude into a multi-agent hedge fund analyst. It combines rule-based precision with Claude-powered insight to deliver comprehensive stock analysis.

User: "Analyze AAPL, MSFT, NVDA"

β†’ 8 AI Agents Analyze in Parallel
β†’ Risk-Adjusted Position Sizing
β†’ Comprehensive Markdown Report

⚠️ Disclaimer: Educational and research purposes only. NOT investment advice.


✨ Features

Feature Description
πŸ€– 8 Analysis Agents Fundamental, Technical, Valuation, Sentiment + 4 Investor Personas
πŸ“Š Rule-Based Precision Deterministic calculations for financial metrics
🧠 Claude-Powered Insight Interpretive analysis from famous investor perspectives
βš–οΈ Risk Management Volatility-based position sizing and limits
πŸ“ Professional Reports Markdown format with executive summary
πŸ”„ Multi-Source Data Yahoo Finance integration with caching

πŸš€ Installation

Quick Install

# Clone the repository
git clone https://github.com/StanleyChanH/super-hedge-fund-skill.git

# Copy to Claude Code skills directory
cp -r super-hedge-fund-skill/super-hedge-fund-skill ~/.claude/skills/

Manual Install

# Create skills directory if not exists
mkdir -p ~/.claude/skills

# Download and extract
curl -L https://github.com/StanleyChanH/super-hedge-fund-skill/archive/refs/heads/main.tar.gz | tar xz

# Install
cp -r super-hedge-fund-skill-main/super-hedge-fund-skill ~/.claude/skills/

πŸ’‘ Usage

Basic Usage

Simply mention stock tickers or investment questions in Claude Code:

User: Analyze AAPL
User: Should I buy TSLA?
User: What's the signal for NVDA and GOOGL?
User: Compare MSFT and AMZN

Advanced Usage

User: Analyze AAPL with brief mode
User: Full analysis for TSLA, NVDA, META with $100k portfolio
User: What would Warren Buffett think of NVDA?

Output Example

# 🏦 AI Hedge Fund Analysis Report

**Ticker**: AAPL
**Action**: 🟑 Hold
**Confidence**: 55%

## Agent Signals
| Agent | Signal | Confidence | Reasoning |
|-------|--------|------------|-----------|
| Fundamental | 🟒 Bullish | 82% | ROE 54%, Net Margin 25% |
| Technical | 🟑 Neutral | 52% | EMA trend mixed, RSI 55 |
| Valuation | πŸ”΄ Bearish | 68% | P/E 34x above historical |
| Buffett | 🟒 Bullish | 75% | Wide moat, excellent ROE |
| Wood | 🟑 Neutral | 60% | AI potential but expensive |
| Burry | πŸ”΄ Bearish | 70% | Overvalued, no catalyst |
| Lynch | 🟑 Neutral | 55% | PEG > 1, growth slowing |

**Consensus**: Neutral (Bullish: 2 / Bearish: 2 / Neutral: 3)

πŸ€– Agents

Rule-Based Analysts (Deterministic)

Agent Metrics Signal Logic
Fundamental ROE, Net Margin, Debt/Equity, Revenue Growth Score β‰₯ 60 β†’ Bullish
Technical EMA, RSI, MACD, Bollinger, Momentum Weighted signal aggregation
Valuation DCF, Owner Earnings, EV/EBITDA Gap > 15% from intrinsic value
Sentiment News headlines, Insider trades Weighted positive/negative

Claude-Powered Investor Personas (Interpretive)

Investor Philosophy Focus
🧠 Warren Buffett Value Investing Moat, ROE > 15%, Margin of Safety
πŸš€ Cathie Wood Growth Investing Disruptive Tech, AI, Innovation
πŸ“‰ Michael Burry Contrarian Investing Deep Value, Against Consensus
πŸ“Š Peter Lynch GARP PEG < 1, Understandable Business

βš™οΈ How It Works

Workflow

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Input     │────▢│ Fetch Data  │────▢│ Run Agents  β”‚
β”‚  (Tickers)  β”‚     β”‚(Price/Fin)  β”‚     β”‚(Rule+Claude)β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                               β”‚
                                               β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Output    │◀────│  Aggregate  │◀────│Risk Analysisβ”‚
β”‚  (Report)   β”‚     β”‚  Signals    β”‚     β”‚(Vol/Limits) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Signal Aggregation

# Count signals from all agents
bullish_count = count(bullish signals)
bearish_count = count(bearish signals)
neutral_count = count(neutral signals)

# Determine consensus
if bullish_count > bearish_count + 2:
    consensus = "BULLISH"
elif bearish_count > bullish_count + 2:
    consensus = "BEARISH"
else:
    consensus = "NEUTRAL"

Risk-Based Position Sizing

Volatility Risk Level Max Position
< 15% Low 25%
15-30% Medium 20%
30-50% High 15%
> 50% Very High 10%

πŸ“ Project Structure

super-hedge-fund-skill/
β”œβ”€β”€ README.md                          # This file
β”œβ”€β”€ README_CN.md                       # Chinese documentation
β”œβ”€β”€ super-hedge-fund-skill/            # Skill directory
β”‚   β”œβ”€β”€ SKILL.md                       # Main skill file
β”‚   β”œβ”€β”€ scripts/                       # Python modules
β”‚   β”‚   β”œβ”€β”€ analysts.py                # Rule-based analysts
β”‚   β”‚   β”œβ”€β”€ data_fetcher.py            # Data fetching
β”‚   β”‚   β”œβ”€β”€ investor_prompts.py        # Claude investor prompts
β”‚   β”‚   └── report_generator.py        # Report generation
β”‚   β”œβ”€β”€ references/                    # Reference docs
β”‚   β”‚   β”œβ”€β”€ investor-agents.md         # Investor personas
β”‚   β”‚   └── analysis-methods.md        # Analysis methods
β”‚   └── assets/                        # Output templates
β”‚       └── report-template.md         # Report template

πŸ”§ Configuration

Supported Tickers

Works with any US stock ticker available on Yahoo Finance:

  • Large Cap: AAPL, MSFT, GOOGL, AMZN, NVDA, TSLA, META
  • Mid/Small Cap: Most NYSE/NASDAQ listed stocks
  • ETFs: SPY, QQQ, IWM, etc.

Data Sources

Data Type Source Notes
Price Data Yahoo Finance OHLCV, 60+ days
Financials Yahoo Finance ROE, P/E, margins, debt
News Yahoo Finance Recent headlines

πŸ§ͺ Testing

# Run module tests
cd super-hedge-fund-skill/super-hedge-fund-skill/scripts
python -m analysts
python -m data_fetcher
python -m report_generator

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.


⚠️ Disclaimer

IMPORTANT: This software is for educational and research purposes only.

  • ❌ NOT financial advice
  • ❌ NOT a recommendation to buy or sell securities
  • ❌ NOT a guarantee of future performance

Investing involves substantial risk. Past performance is not indicative of future results. Always do your own research and consult with a qualified financial advisor before making investment decisions.


πŸ™ Acknowledgments


⬆ Back to Top

Made with ❀️ by StanleyChanH

About

Claude Code Skill that transforms Claude into a multi-agent hedge fund analyst with 8 AI agents for comprehensive stock analysis

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages