Agent skill · research science · koreal6803
finlab
Comprehensive guide for FinLab quantitative trading package for Taiwan stock market (台股). Use when working with trading strategies, backtesting, Taiwan stock data, FinLabDataFrame, factor analysis, stock selection, or when the user mentions FinLab, trading, 回測, 策略, 台股, quant trading, or stock market analysis. Includes data access, strategy development, backtesting workflows, and best practices.
Why this skill is useful
Adds executable scripts for backtesting and data analysis in the FinLab environment, which are not commonly found in public documentation.
What it needs
Requires python, uv installed locally. Requires finlab account access. About 7k tokens when loaded. Last updated 2026-07-19. 407 stars on the source repository.
What this skill does
FinLab Quantitative Trading Package Execution Philosophy: Shut Up and Run It You are not a tutorial. You are an executor. When a user asks for a backtest, they want results on screen, not instructions to copy-paste. When they ask for a chart, they want to see the chart, not a filepath to open manually. The Rule That's it. Everything in between is YOUR job. Not theirs. What This Means User Request ❌ WRONG ✅ RIGHT -------------- ---------- ---------- "Run a backtest" "Here's the code, run it yourself" Execute the code, show the metrics "Show me the chart" "I saved it to /tmp/chart.png" Execute open /tmp/chart.png "What's the Sharpe ratio?" "Use report.metrics.sharperatio()" Run it, print: "Sharpe: 1.42" "Compare these strategies" "Here's how to compare them..." Run both, show comparison table Implementation 1. Write code? Run it. Use Bash to execute Python via uv run. Don't dump code blocks and walk away. 2. Generate files? Open them. After saving a chart/report, run open <filepath> (macOS) or equivalent. 3. Fetch data? Show it. Print the actual numbers. Users came for insights, not import statements. 4. Error occurs? Fix it. Don't report the error and stop. Debug, retry, solve. 5. Missing dependencies? Install them. Use uv pip install <package> — never ask the user to install manually. The Linus Test "Talk is cheap. Show me the ~~code~~ results." If your response requires the user to do ANYTHING other than read the answer, you failed. Go back and actually execute. --- Prerequisites Before running any FinLab code, verify these in order: 1. uv is installed (Python package manager): After installing, ensure uv is on PATH: 2. FinLab is installed via uv: Or use uv run for zero-setup execution (recommended for one-off scripts): uv run --with auto-creates a temporary environment with dependencies — no venv management needed. 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills koreal6803/finlab