US Market Data Toolkit
Geeksfino/finskills
Free Python scripts that fetch US stock data, SEC filings, insider trades and macro indicators, and run financial score calculators and portfolio analytics.
Screens for undervalued stocks across about 60 regions with yfinance's EquityQuery, using ratios such as PER, PBR, dividend yield and ROE, with optional theme filters.
SKILL.md written in Japanese; this summary is our English description.
Install Value Stock Screener
$ npx skills add okikusan-public/stock_skills --skill screen-stocks -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install okikusan-public/stock_skills screen-stocks --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/okikusan-public/stock_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/screen-stocks .claude/skills/screen-stocks && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "screen-stocks" agent skill from https://github.com/okikusan-public/stock_skills/tree/main/.claude/skills/screen-stocks into .claude/skills/screen-stocks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "screen-stocks", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/okikusan-public/stock_skills/tree/main/.claude/skills/screen-stocksType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add okikusan-public/stock_skills --skill screen-stocks -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install okikusan-public/stock_skills screen-stocks --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/okikusan-public/stock_skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/screen-stocks .agents/skills/screen-stocks && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "screen-stocks" agent skill from https://github.com/okikusan-public/stock_skills/tree/main/.claude/skills/screen-stocks into .agents/skills/screen-stocks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "screen-stocks", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add okikusan-public/stock_skills --skill screen-stocks -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install okikusan-public/stock_skills screen-stocks --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/okikusan-public/stock_skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/screen-stocks .cursor/skills/screen-stocks && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "screen-stocks" agent skill from https://github.com/okikusan-public/stock_skills/tree/main/.claude/skills/screen-stocks into .cursor/skills/screen-stocks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "screen-stocks", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/okikusan-public/stock_skills.git --path .claude/skills/screen-stocks--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add okikusan-public/stock_skills --skill screen-stocks -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install okikusan-public/stock_skills screen-stocks --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/okikusan-public/stock_skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/screen-stocks .gemini/skills/screen-stocks && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "screen-stocks" agent skill from https://github.com/okikusan-public/stock_skills/tree/main/.claude/skills/screen-stocks into .gemini/skills/screen-stocks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "screen-stocks", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install okikusan-public/stock_skills screen-stocksInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add okikusan-public/stock_skills --skill screen-stocks -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/okikusan-public/stock_skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/screen-stocks .github/skills/screen-stocks && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "screen-stocks" agent skill from https://github.com/okikusan-public/stock_skills/tree/main/.claude/skills/screen-stocks into .github/skills/screen-stocks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "screen-stocks", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add okikusan-public/stock_skills --skill screen-stocks -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install okikusan-public/stock_skills screen-stocks --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/okikusan-public/stock_skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/screen-stocks .opencode/skills/screen-stocks && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "screen-stocks" agent skill from https://github.com/okikusan-public/stock_skills/tree/main/.claude/skills/screen-stocks into .opencode/skills/screen-stocks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "screen-stocks", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
screen-stocks- GitHub stars
- 135
- Token cost
- ~2.4k tokens
- SKILL.md length
- 436 words
- Files
- 2 (incl. scripts)
- Skills in repo
- 9
- Repo updated
- First seen
- Licence
- None found
At a glance
Screens for undervalued stocks across about 60 regions with yfinance's EquityQuery, using ratios such as PER, PBR, dividend yield and ROE, with optional theme filters.
- Works in 3 steps: Grok API がX/Webから注目テーマを3〜5つ検出（信頼度付き） → themes.yaml… → 各テーマで指定プリセットのスクリーニングを実行
- Finding undervalued stocks by PER, PBR, dividend yield or ROE
- SKILL.md covers 実行コマンド, 自然言語ルーティング, 利用可能な地域コード（yfinance EquityQuery） and 利用可能な取引所コード, plus 8 more sections
- Runs Python scripts from its folder; calls python3; needs XAI_API_KEY
What it does
The agent works out the region, preset and sector from your request and then runs `scripts/run_screen.py` with matching options. Screening uses the EquityQuery API in yfinance, so no list of tickers is needed, and the default query mode covers every region quickly. The skill lists region codes such as jp, us, sg, hk, kr and tw, and exchange codes for Tokyo, NASDAQ, NYSE, Singapore, Thailand, Malaysia, Indonesia, the Philippines, Hong Kong, Korea and Taiwan.
A `--theme` option narrows any preset except trending, pullback and alpha to a theme such as AI, EV, cloud and SaaS, cybersecurity, biotech, renewable energy, fintech, defense or healthcare, with definitions kept in `config/themes.yaml`. `--auto-theme` asks the Grok API to detect three to five trending themes from X and the web, matches them against that file and screens each one, and it cannot be combined with `--theme` and needs an `XAI_API_KEY`. The SKILL.md is written in Japanese, and its sample command points at the author's own local path.
When your agent uses it
- Finding undervalued stocks by PER, PBR, dividend yield or ROE
- Screening Japanese, US or other Asian markets without a ticker list
- Narrowing a value screen to a theme such as AI or biotech
Example prompts
- “Screen Japanese stocks for undervalued companies with the value preset.”
- “Find cheap US cybersecurity stocks using the theme option.”
- “Detect trending themes in Japan with auto-theme and screen each one.”
Requirements
- Python 3 with yfinance
- An XAI_API_KEY for the auto-theme option
- Pre-approved tools (allowed-tools): Bash(python3 *)
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Grok API がX/Webから注目テーマを3〜5つ検出（信頼度付き）
- themes.yaml のキーと照合し、有効テーマのみ実行（未対応テーマはスキップ通知）
- 各テーマで指定プリセットのスクリーニングを実行
What it can do on your machine
Read from SKILL.md and the folder at commit 6bc1be2. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
Bash(python3 *)
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
XAI_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Value Stock Screener loads about 2.4k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 436 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 436 words (~2,402 tokens).
- name
- screen-stocks
- allowed-tools
- Bash(python3 *)
- argument-hint
- [region] [preset] [--sector SECTOR] 例: japan value, us high-dividend, asean quality, hk value --sector Technology
Files
SKILL.md and 1 other file (scripts) in .claude/skills/screen-stocks of okikusan-public/stock_skills.
- SKILL.md
- scripts/run_screen.py
Open the folder on GitHubat commit 6bc1be2
Compare with similar skills
Value Stock Screener next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Value Stock Screener this skillokikusan-public/stock_skills | 135 | — | ~2.4k | Automated safety check: Pass | None | |
| US Market Data ToolkitGeeksfino/finskills | 282 | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | |
| AKShare Financial DataHKUDS/Vibe-Trading | 35k | — | ~777 | Automated safety check: Pass | MIT | |
| Fundamental Factor ScreeningHKUDS/Vibe-Trading | 35k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Yfinance Datahimself65/finance-skills | 3.4k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Fin Yfinance Datacriptogus/agent-evolve-network | 288 | — | ~806 | Automated safety check: Pass | MIT |
Similar skills
AKShare Financial Data
HKUDS/Vibe-Trading
Pulls free market data from the AKShare Python library: A-share, US and Hong Kong prices, futures, China macro series and forex, with notes on symbol formats and Chinese column names.
Fundamental Factor Screening
HKUDS/Vibe-Trading
Builds value or growth stock screens from PE, PB, ROE and financial statement fields for backtests, using tushare data for A-shares and yfinance for Hong Kong and US stocks.
Yfinance Data
himself65/finance-skills
Fetch financial and market data with the yfinance Python library (Yahoo Finance).
Fin Yfinance Data
criptogus/agent-evolve-network
Fetch market and fundamental data via the yfinance Python library — quotes, OHLC history, financial statements, holders, dividends, options, and more.
Eastmoney Market Data
HKUDS/Vibe-Trading
Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.
More from okikusan-public/stock_skills
All 9 skills in this repoMarket and Stock Deep Research
okikusan-public/stock_skills
Produces deep-dive reports on a stock, industry, market or business model by combining yfinance data with Grok API searches of X and the web.
Stock Portfolio Manager
okikusan-public/stock_skills
Manages a stock portfolio through a Python command line: snapshots with profit and loss, buy and sell records, structure analysis, health checks and trade reviews.
Portfolio Stress Test
okikusan-public/stock_skills
Stress-tests a stock portfolio: takes a list of holdings, applies macro scenarios and reports shock sensitivity, concentration, correlation, VaR and causal chains.
Stock and ETF Report
okikusan-public/stock_skills
Generates a financial report for one stock or ETF from its ticker, with valuation scores for stocks and expense ratio and fund-size ratings for ETFs.
Plan Mode Orchestrator
okikusan-public/stock_skills
Runs a seven-agent planning workflow, started by asking for plan mode, that designs, executes, loops and reviews analysis work for stock portfolio decisions.
Graph Query
okikusan-public/stock_skills
知識グラフへの自然言語クエリ。過去のレポート・スクリーニング・取引・リサーチ・市況を検索. An agent skill from okikusan-public/stock_skills.
Related
Categories
Questions about Value Stock Screener
What does Value Stock Screener do?
Screens for undervalued stocks across about 60 regions with yfinance's EquityQuery, using ratios such as PER, PBR, dividend yield and ROE, with optional theme filters. py` with matching options. Screening uses the EquityQuery API in yfinance, so no list of tickers is needed, and the default query mode covers every region quickly.
When should I use Value Stock Screener?
Value Stock Screener fits situations like: finding undervalued stocks by PER, PBR, dividend yield or ROE; screening Japanese, US or other Asian markets without a ticker list; narrowing a value screen to a theme such as AI or biotech.
How do I install Value Stock Screener in Claude Code?
Run `npx skills add okikusan-public/stock_skills --skill screen-stocks -a claude-code`. Or copy the skill folder (.claude/skills/screen-stocks in okikusan-public/stock_skills) into .claude/skills/screen-stocks in your project. Claude Code loads it when a task matches its description.
How do I install Value Stock Screener in Codex?
Run `npx skills add okikusan-public/stock_skills --skill screen-stocks -a codex`. Or copy the skill folder (.claude/skills/screen-stocks in okikusan-public/stock_skills) into .agents/skills/screen-stocks in your project. Codex loads it when a task matches its description.
Can I use Value Stock Screener in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add okikusan-public/stock_skills --skill screen-stocks -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/screen-stocks, .gemini/skills/screen-stocks, .github/skills/screen-stocks and .opencode/skills/screen-stocks in your project.
What does Value Stock Screener need to run?
Going by SKILL.md and its folder, Value Stock Screener needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named XAI_API_KEY. Our summary lists: Python 3 with yfinance; An XAI_API_KEY for the auto-theme option. Its frontmatter pre-approves these tools: Bash(python3 *).
Does Value Stock Screener access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Value Stock Screener safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Value Stock Screener use?
No licence was found for Value Stock Screener or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Value Stock Screener use?
About 2.4k tokens (SKILL.md is roughly 9.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Value Stock Screener?
Skills that share tags, products or a category with Value Stock Screener: US Market Data Toolkit (Geeksfino/finskills, 282 stars), AKShare Financial Data (HKUDS/Vibe-Trading, 35k stars), Fundamental Factor Screening (HKUDS/Vibe-Trading, 35k stars) and Yfinance Data (himself65/finance-skills, 3.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Value Stock Screener?
okikusan-public (a GitHub user) maintains it in okikusan-public/stock_skills, which has 135 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on April 25, 2026.
Source: okikusan-public/stock_skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.