← Back to Skills Marketplace
Top Performer Scanner
by
tltby12341
· GitHub ↗
· v1.0.0
· MIT-0
162
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install top-performer-scanner
Description
Find the true top-performing US stocks per year by downloading all NASDAQ-listed symbols, filtering by liquidity (Top 500 daily dollar volume), and ranking b...
Usage Guidance
This package appears to do what it says: download NASDAQ symbol data and Yahoo Finance prices, compute liquidity-ranked universes per year, and report top performers. Before installing/running: (1) run in a controlled environment (virtualenv) and install requirements from requirements.txt; (2) be aware it needs internet access and may download large amounts of historical data (yfinance batch downloads can be heavy and rate-limited); (3) verify outputs before using for trading — the author also warns about data gaps/adjustments; (4) note small doc mismatches (expected output filename differs from SKILL.md) and the ticker filter (alphabetic tickers with length <=4) which may exclude some valid modern tickers — review/adjust filters if you need broader universes; (5) review and, if necessary, adjust date ranges and --min-price to match your analysis needs.
Capability Analysis
Type: OpenClaw Skill
Name: top-performer-scanner
Version: 1.0.0
The skill bundle provides tools for historical stock performance analysis by downloading market data from the NASDAQ FTP server and Yahoo Finance. The Python scripts (get_true_top_500.py and analyze_feasibility.py) perform legitimate data processing, liquidity filtering, and return calculations as described in the documentation, with no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (finding top-performing US stocks by liquidity-ranked universe) match the included scripts and declared dependencies (pandas, yfinance). The required binaries (python3, pip3) are appropriate. Small documentation mismatches exist (SKILL.md mentions output file 'nasdaq_top500_performers.csv' while the script default is 'top_performers.csv'), but this is a correctness/documentation issue, not a security mismatch.
Instruction Scope
SKILL.md instructs the agent to run the two included Python scripts and explicitly states network access to NASDAQ FTP and Yahoo Finance is required. The scripts only access the declared endpoints (ftp://ftp.nasdaqtrader.com and Yahoo Finance via yfinance) and perform local data processing; they do not read unrelated system files, environment variables, or send data to unexpected external endpoints.
Install Mechanism
No install spec is provided (instruction-only install), which is low risk. A requirements.txt lists pandas and yfinance, matching the SKILL.md pip install suggestion. No remote arbitrary binary downloads, no extract-from-URL behavior, and no unusual install locations.
Credentials
The skill requests no environment variables or credentials. The external network access (NASDAQ FTP and Yahoo Finance) is necessary for the task and is declared in SKILL.md. No unrelated secrets or service tokens are requested.
Persistence & Privilege
always:false and the skill does not request or attempt to modify other skills or system-wide agent settings. It does not request persistent privileges or background execution.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install top-performer-scanner - After installation, invoke the skill by name or use
/top-performer-scanner - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of top-performer-scanner:
- Finds the true top-performing US stocks per year, filtering by liquidity (Top 500 daily dollar volume) with no survivorship bias.
- Downloads all NASDAQ-listed symbols, filters out ETFs/test issues, and gathers full historical price data (2019–2026).
- Ranks stocks annually by returns within the top liquidity universe and outputs Top 15 performers per year.
- Includes feasibility analysis to test stock selection filters against historical explosive movers.
- Excludes penny stocks and illiquid names; applies liquidity filter dynamically by year.
- Requires Python 3, pip3, pandas, and yfinance. Internet access is required for data download.
Metadata
Frequently Asked Questions
What is Top Performer Scanner?
Find the true top-performing US stocks per year by downloading all NASDAQ-listed symbols, filtering by liquidity (Top 500 daily dollar volume), and ranking b... It is an AI Agent Skill for Claude Code / OpenClaw, with 162 downloads so far.
How do I install Top Performer Scanner?
Run "/install top-performer-scanner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Top Performer Scanner free?
Yes, Top Performer Scanner is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Top Performer Scanner support?
Top Performer Scanner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Top Performer Scanner?
It is built and maintained by tltby12341 (@tltby12341); the current version is v1.0.0.
More Skills