Agent skill

Market and Stock Deep Research

by okikusan-public in 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.

No licenceAuto-check passedBusiness, Finance & HR

SKILL.md written in Japanese; this summary is our English description.

Install Market and Stock Deep Research

skills CLI
$ npx skills add okikusan-public/stock_skills --skill market-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install okikusan-public/stock_skills market-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/okikusan-public/stock_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/market-research .claude/skills/market-research && rm -rf skills-src

Use ~/.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/

Facts

Skill name
market-research
GitHub stars
135
Token cost
~739 tokens
SKILL.md length
143 words
Files
2 (incl. scripts)
Skills in repo
9
Repo updated
First seen
Licence
None found

At a glance

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.

  • Works in 2 steps: Layer 1 (yfinance):… → Layer 2 (Grok API): XAI_API_KEY…
  • Researching a listed company's valuation, news and market sentiment
  • SKILL.md covers 実行コマンド, 自然言語ルーティング, リサーチタイプ別の出力 and API について, plus 3 more sections
  • Runs Python scripts from its folder; calls python3; needs XAI_API_KEY

What it does

Research type and target are inferred from the request, then scripts/run_research.py runs with one of four commands. A stock report combines basic information and valuation from yfinance, the latest news, sentiment on X from the Grok API and a deeper analysis of news, earnings drivers, analyst views and competitors. An industry report covers trends, key players, growth drivers, risks and regulation, and a market report covers price moves, macro factors, sentiment, notable events and sector rotation.

A business model report describes what the company earns from, its segment mix and revenue model, competitive advantages, key KPIs, growth strategy and structural risks. The data has two layers: yfinance is always available for fundamentals and prices, while the Grok layer requires the XAI_API_KEY variable; without it stock reports use yfinance only and the other three types report that Grok is needed. Each report ends with a Grok API status line covering normal, not set, auth error, rate limit and timeout cases.

After showing the script output, the agent adds commentary, for example checking that fundamentals agree with the Grok findings, noting Japan-specific context for industries, and linking results to the user's holdings, earlier research, notes and watchlist if that context exists. It also offers to record a thesis as an investment note. This is research support, not investment advice, and the SKILL.md is in Japanese.

When your agent uses it

  • Researching a listed company's valuation, news and market sentiment
  • Getting an overview of an industry's players, drivers and risks
  • Understanding a company's segments, revenue model and competitive advantages

Example prompts

  • “Do a deep-dive research report on AAPL.”
  • “Research the semiconductor industry: trends, main players and regulation.”
  • “Analyze the business model of 7203.T, including segments and KPIs.”

Requirements

  • Python 3 to run run_research.py
  • yfinance for price and fundamentals data
  • An XAI_API_KEY for the Grok API layer
  • Pre-approved tools (allowed-tools): Bash(python3 *)

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Layer 1 (yfinance): 常に利用可能(ファンダメンタルズ・株価データ)
  2. Layer 2 (Grok API): XAI_API_KEY 設定時(X投稿・Web検索による深掘り分析)

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

Market and Stock Deep Research loads about 739 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 143 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~739

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 143 words (~739 tokens).

name
market-research
allowed-tools
Bash(python3 *)
argument-hint
[stock|industry|market|business] [対象] 例: stock 7203.T, industry 半導体, market 日経平均, business 7751.T

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in .claude/skills/market-research of okikusan-public/stock_skills.

  • SKILL.md
  • scripts/run_research.py

Open the folder on GitHubat commit 6bc1be2

Compare with similar skills

Market and Stock Deep Research 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.

Market and Stock Deep Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Market and Stock Deep Research this skillokikusan-public/stock_skills135—~739Automated safety check: PassNone
Yahoo Finance24mlight/StockClaw1012 repos~1.1kAutomated safety check: NotesMIT
Stock Analysisliusai0820/Stock-Analysis-Skill141—~904Automated safety check: NotesNone
US Market Data ToolkitGeeksfino/finskills282—~1.2kAutomated safety check: PassApache-2.0
yfinance Market DataHKUDS/Vibe-Trading35k—~2.2kAutomated safety check: PassMIT
AKShare Financial DataHKUDS/Vibe-Trading35k—~777Automated safety check: PassMIT

Similar skills

  • Yahoo Finance

    24mlight/StockClaw

    Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance.

    101 GitHub starsUsed in 2 repos~1.1k tokens
    Business, Finance & HRAuto-check: notes
  • Stock Analysis

    liusai0820/Stock-Analysis-Skill

    股票智能分析技能。输入股票代码(A股/港股/美股),自动完成: 1. An agent skill from liusai0820/Stock-Analysis-Skill.

    141 GitHub stars~904 tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check: notes
  • 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.

    282 GitHub stars~1.2k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • yfinance Market Data

    HKUDS/Vibe-Trading

    Pulls price history and company research data for US, Hong Kong and Canadian stocks, ETFs and indices from Yahoo Finance, with no API key.

    35k GitHub stars~2.2k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • 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.

    35k GitHub stars~777 tokensUpdated today
    Business, Finance & HRAuto-check passed
  • 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.

    35k GitHub stars~1.7k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from okikusan-public/stock_skills

All 9 skills in this repo
  • Value Stock Screener

    okikusan-public/stock_skills

    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.

    135 GitHub stars~2.4k tokensUpdated 5 mo ago
    Auto-check passed
  • 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.

    135 GitHub stars~2.4k tokensUpdated 5 mo ago
    Auto-check passed
  • 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.

    135 GitHub stars~814 tokensUpdated 5 mo ago
    Auto-check passed
  • 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.

    135 GitHub stars~370 tokensUpdated 5 mo ago
    Auto-check passed
  • 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.

    135 GitHub stars~2.5k tokensUpdated 5 mo ago
    Auto-check passed
  • Graph Query

    okikusan-public/stock_skills

    知識グラフへの自然言語クエリ。過去のレポート・スクリーニング・取引・リサーチ・市況を検索. An agent skill from okikusan-public/stock_skills.

    135 GitHub stars~153 tokensUpdated 5 mo ago
    Auto-check passed

Questions about Market and Stock Deep Research

What does Market and Stock Deep Research do?

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. py runs with one of four commands. A stock report combines basic information and valuation from yfinance, the latest news, sentiment on X from the Grok API and a deeper analysis of news, earnings drivers, analyst views and competitors.

When should I use Market and Stock Deep Research?

Market and Stock Deep Research fits situations like: researching a listed company's valuation, news and market sentiment; getting an overview of an industry's players, drivers and risks; understanding a company's segments, revenue model and competitive advantages.

How do I install Market and Stock Deep Research in Claude Code?

Run `npx skills add okikusan-public/stock_skills --skill market-research -a claude-code`. Or copy the skill folder (.claude/skills/market-research in okikusan-public/stock_skills) into .claude/skills/market-research in your project. Claude Code loads it when a task matches its description.

How do I install Market and Stock Deep Research in Codex?

Run `npx skills add okikusan-public/stock_skills --skill market-research -a codex`. Or copy the skill folder (.claude/skills/market-research in okikusan-public/stock_skills) into .agents/skills/market-research in your project. Codex loads it when a task matches its description.

Can I use Market and Stock Deep Research 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 market-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/market-research, .gemini/skills/market-research, .github/skills/market-research and .opencode/skills/market-research in your project.

What does Market and Stock Deep Research need to run?

Going by SKILL.md and its folder, Market and Stock Deep Research 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 to run run_research.py; yfinance for price and fundamentals data; An XAI_API_KEY for the Grok API layer. Its frontmatter pre-approves these tools: Bash(python3 *).

Does Market and Stock Deep Research 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 Market and Stock Deep Research 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 Market and Stock Deep Research use?

No licence was found for Market and Stock Deep Research or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Market and Stock Deep Research use?

About 739 tokens (SKILL.md is roughly 3k 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 Market and Stock Deep Research?

Skills that share tags, products or a category with Market and Stock Deep Research: Yahoo Finance (24mlight/StockClaw, 101 stars), Stock Analysis (liusai0820/Stock-Analysis-Skill, 141 stars), US Market Data Toolkit (Geeksfino/finskills, 282 stars) and yfinance Market Data (HKUDS/Vibe-Trading, 35k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Market and Stock Deep Research?

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.