# AI Trading Skill

> Explainable trading intelligence framework. Run multi-layer market analysis, generate structured trade rationales, backtest strategies, evaluate risk profiles, and manage automated execution on Hyperliquid.

- Skill: `rigneshroot/ai-trading-skill-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rigneshroot/ai-trading-skill-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rigneshroot/ai-trading-skill-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rigneshroot (https://skillmd.com/u/rigneshroot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rigneshroot/ai-trading-skill-3

---


# Explainable Trading Intelligence Skill

This skill equips any agent with the ability to run market analysis, generate explainable trade rationales, backtest strategies, evaluate risk, and manage execution on the Hyperliquid exchange.

---

## Prerequisite Setup

Before running any script, activate the workspace environment:

```bash
# Navigate to the project root
cd <project-root>

# Activate the virtual environment
source .venv/bin/activate
```

User must configure private keys in `.env` for active trades. See `.env.example` for required fields.

---

## Core Operations

### 1. Run Market Analysis with Trade Rationale
Generates a structured, explainable trade breakdown covering trend, volatility, momentum, key levels, sizing, and invalidity conditions.

```bash
# Default analysis (BTC, moderate risk profile)
python3 analyze.py

# Custom asset, interval, and risk profile
python3 analyze.py --symbol ETH --interval 5m --risk-profile conservative

# Adjust per-trade risk percentage
python3 analyze.py --symbol SOL --account-risk-pct 0.5
```

Available risk profiles: `conservative`, `moderate`, `aggressive`

Output includes:
- Strategy scoring matrix (all 5 analysis layers)
- Trade Rationale Engine output (structured breakdown)
- Risk Assessment (profile-adjusted sizing and warnings)
- Institutional Context (macro positioning data)

### 2. Run Automated Tests
```bash
python3 -m unittest tests/test_strategies.py
```

### 3. Run Historical Backtests
Walk-forward simulation with no lookahead bias:
```bash
python3 backtest.py
python3 backtest.py --days 60 --confidence 75 --min-agree 4
```

### 4. Evaluate Position Sizing Models
```bash
python3 pnl_calc.py
```

### 5. View Signals Breakdown
```bash
python3 show_signals.py
```

### 6. Run Execution Orchestrator
Full execution loop with safety gates, risk circuit breakers, and LLM audit:
```bash
# One-shot dry tick
python3 main.py

# Continuous polling loop
python3 main.py --loop
```

---

## Configuration

Edit `config.yaml` to adjust:
- `agree_threshold`: Minimum confidence for a strategy to count as agreeing (default: 50)
- `min_agree`: Minimum strategies required for consensus (default: 4)
- `symbol`: Asset to analyze (default: BTC)
- `interval`: Candle timeframe (default: 15m)
- Individual strategy parameters under the `strategies` section