trading-skills

trading-skills

Comprehensive financial data CLI for Tushare Pro | 7+ trading skill modules | 52+ data tools | Production-ready

A professional-grade skill development and training project featuring comprehensive tools for financial data querying, analysis, and trading strategy development. Built with a modular skill architecture, complete CLI implementation, and extensive test coverage.

---

📋 Features

• 7 Specialized Skill Modules: Stock, Futures, Index, Forex, Alpha, Concepts, Financial
• 52+ Data Query Tools: Full parity with Tushare Pro API coverage
• Production CLI: Type-safe command-line client with caching and multiple output formats
• Comprehensive Testing: 992+ tests covering CLI, cache, config, and data output
• Skill-Based Learning: Modular knowledge base for understanding trading concepts and data
• Git-Based Configuration: Configuration management via version control

---

📁 Project Structure

trading-skills/
├── skills/                      # Trading skill modules (7 categories)
│   ├── tushare-stock/          # Stock trading fundamentals and techniques
│   ├── tushare-futures/        # Futures contracts and strategies
│   ├── tushare-index/          # Index data and analysis
│   ├── tushare-forex/          # Foreign exchange trading
│   ├── tushare-alpha/          # Alpha factor generation
│   ├── tushare-concepts/       # Key trading and financial concepts
│   └── tushare-financial/      # Financial statement analysis
├── tools/tushare_cli/          # CLI implementation
│   ├── src/                    # Python package
│   │   └── tushare_cli/        # Main CLI code
│   │       ├── commands/       # Command modules by category
│   │       ├── api.py          # Tushare API wrapper
│   │       ├── cache.py        # Response caching layer
│   │       ├── config.py       # Configuration management
│   │       ├── output.py       # Output formatting (JSON, CSV, Table)
│   │       └── main.py         # CLI entry point
│   └── pyproject.toml          # Package configuration
├── tests/                       # Test suite (992+ tests)
│   └── tushare_cli/           # CLI tests
│       ├── test_cache.py       # Cache functionality tests
│       ├── test_commands_*.py  # Command tests by category
│       ├── test_config.py      # Configuration tests
│       ├── test_main.py        # CLI entry point tests
│       └── test_output.py      # Output format tests
└── docs/plans/                 # Design and implementation plans

---

🚀 Quick Start

1. Install the CLI

# Clone the repository
git clone git@github.com:oopslink/trading-skills.git
cd trading-skills

# Install the CLI in development mode
pip install -e tools/tushare_cli/

2. Set Up Your Tushare Token

Get your token at Tushare Pro

# Option 1: Config file (recommended, persists across sessions)
tushare-cli config set-token YOUR_TOKEN

# Option 2: Environment variable
export TUSHARE_TOKEN=YOUR_TOKEN

# Option 3: Command-line flag
tushare-cli --token YOUR_TOKEN stock daily --ts-code 000001.SZ

3. Set Up Skills in Claude Code (Optional)

If you want to use the trading skills in Claude Code:

/plugin marketplace add oopslink/trading-skills
/plugin install trading-skills@trading-skills

This will install all 7 trading skill modules, making them available as reference knowledge in Claude Code conversations.

4. Try Your First Query

# Get stock daily data
tushare-cli stock daily --ts-code 000001.SZ

# Get in JSON format
tushare-cli stock daily --ts-code 000001.SZ --format json

# Get with caching enabled
tushare-cli --cache stock daily --ts-code 000001.SZ

---

📚 API Categories

Category	Skills	Commands	Data Tools
Stock	tushare-stock	8+ commands	Daily, Adj, Weekly, Monthly, Quotes
Futures	tushare-futures	7+ commands	Daily, Continuous, Margin
Index	tushare-index	6+ commands	Daily, Weekly, Constituents
Forex	tushare-forex	4+ commands	Daily, OHLC
Alpha	tushare-alpha	5+ commands	Factors, Scoring, Backtesting
Concepts	tushare-concepts	3+ commands	Concept Stocks, Updates
Financial	tushare-financial	6+ commands	Income, Balance, Cashflow, Indicators

---

🛠️ Usage Examples

Query Stock Data

# Daily prices for a stock
tushare-cli stock daily --ts-code 000001.SZ --start-date 20240101

# Weekly prices
tushare-cli stock weekly --ts-code 000001.SZ