# Financial Skills

Multi-agent stock analysis workflow for agents.

## Requirements

- Any agent supporting the [Agent Skills specification](https://agentskills.io/specification) (Claude Code CLI recommended)
- Alpha Vantage API key (for market data)

## Installation

```bash
npx skills add luohy15/financial-skills  # select alphavantage & trading-agents
```

Set your Alpha Vantage API key ([get free key](https://www.alphavantage.co/support/#api-key)):
```bash
# Option 1: Add to .env file in running directory
echo "ALPHAVANTAGE_API_KEY=your_api_key_here" >> .env

# Option 2: Export as environment variable
export ALPHAVANTAGE_API_KEY=your_api_key_here
```

## Usage

```bash
# Alpha Vantage data queries
/alphavantage AAPL daily prices
/alphavantage NVDA company overview
/alphavantage TIME_SERIES_DAILY symbol=TSLA

# Trading agents - full workflow
/trading-agents NVDA

# Specific phase
/trading-agents AAPL analysis

# Single skill
/trading-agents TSLA news-analyst
```

## Skills

### alphavantage

Direct data queries: stock prices, fundamentals, technicals, news, crypto, forex, commodities, economic indicators.

### trading-agents

```
Analysis (parallel) → Research Debate → Trading → Risk Analysis
     ↓                      ↓              ↓            ↓
 4 analysts            bull/bear       trader      3 risk views
                        debate        proposal     → final decision
```

| Phase | Skills |
|-------|--------|
| Analysis | `news-analyst`, `market-analyst`, `fundamentals-analyst`, `social-analyst` |
| Research | `bull-researcher`, `bear-researcher`, `research-manager` |
| Trading | `trader` |
| Risk | `risk-debate`, `risk-manager` |

## Output

Reports saved to `report/<TICKER>/<DATE>/<RANK>/`

## Credits

trading-agents based on [TradingAgents](https://github.com/TauricResearch/TradingAgents)