Agent skill

Stock Analysis

by 24mlight in 24mlight/StockClaw

Analyze stocks and cryptocurrencies using Yahoo Finance data.

MITAuto-check: notesBusiness, Finance & HR

Install Stock Analysis

skills CLI
$ npx skills add 24mlight/StockClaw --skill stock-analysis -a claude-code

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

GitHub CLI
$ gh skill install 24mlight/StockClaw stock-analysis --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/24mlight/StockClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/stock-analysis .claude/skills/stock-analysis && 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
stock-analysis
GitHub stars
101
Used in
2 other repos
Token cost
~2k tokens
SKILL.md length
560 words
Files
17 (incl. scripts)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Analyze stocks and cryptocurrencies using Yahoo Finance data.

  • Works in 3 steps: Install bird: npm install -g… → Login to x.com in Safari/Chrome → Create .env with AUTH_TOKEN and CT0
  • Portfolio tracking
  • SKILL.md covers What's New in v6.2, What's in v6.1, What's in v6.0 and Quick Commands, plus 8 more sections
  • Runs Python scripts from its folder; calls uv, python3 and npm; needs AUTH_TOKEN

What it does

Stock Analysis is an agent skill from 24mlight/StockClaw. Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including scripts (for example `App-Plan.md`, `README.md` and `TODO.md`).

It sits in Business, Finance & HR, covering Stock and market analysis and Crypto and DeFi analysis. It works with yfinance and X (Twitter). The licence is MIT.

When your agent uses it

  • Portfolio tracking
  • Earnings reactions
  • Crypto monitoring
  • Trending stocks

Example prompts

  • “/stock-analysis”

Requirements

  • Python 3
  • Node.js
  • A credential in AUTH_TOKEN

Workflow steps

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

  1. Install bird: npm install -g @steipete/bird
  2. Login to x.com in Safari/Chrome
  3. Create .env with AUTH_TOKEN and CT0

What it can do on your machine

Read from SKILL.md and the folder at commit 7872331. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 7 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • python3
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AUTH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Stock Analysis loads about 2k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 560 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:154
    3. Create `.env` with `AUTH_TOKEN` and `CT0`

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

The full file from 24mlight/StockClaw at commit 7872331, republished under its MIT licence (© 24mlight). 560 words, ~2,022 tokens.

Download SKILL.mdSave it as .claude/skills/stock-analysis/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
stock-analysis
description
Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
version
6.2.0
homepage
https://finance.yahoo.com
commands
/stock - Analyze a stock or crypto (e.g., /stock AAPL), /stock_compare - Compare multiple tickers, /stock_dividend - Analyze dividend metrics, /stock_watch…

Stock Analysis v6.1

Analyze US stocks and cryptocurrencies with 8-dimension analysis, portfolio management, watchlists, alerts, dividend analysis, and viral trend detection.

What's New in v6.2

  • 🔮 Rumor Scanner — Early signals before mainstream news
    • M&A rumors and takeover bids
    • Insider buying/selling activity
    • Analyst upgrades/downgrades
    • Twitter/X "hearing that...", "sources say..." detection
  • 🎯 Impact Scoring — Rumors ranked by potential market impact

What's in v6.1

  • 🔥 Hot Scanner — Find viral stocks & crypto across multiple sources
  • 🐦 Twitter/X Integration — Social sentiment via bird CLI
  • 📰 Multi-Source Aggregation — CoinGecko, Google News, Yahoo Finance
  • ⏰ Cron Support — Daily trend reports

What's in v6.0

  • 🆕 Watchlist + Alerts — Price targets, stop losses, signal changes
  • 🆕 Dividend Analysis — Yield, payout ratio, growth, safety score
  • 🆕 Fast Mode — --fast skips slow analyses (insider, news)
  • 🆕 Improved Performance — --no-insider for faster runs

Quick Commands

Stock Analysis
bash
# Basic analysis
uv run {baseDir}/scripts/analyze_stock.py AAPL

# Fast mode (skips insider trading & breaking news)
uv run {baseDir}/scripts/analyze_stock.py AAPL --fast

# Compare multiple
uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL

# Crypto
uv run {baseDir}/scripts/analyze_stock.py BTC-USD ETH-USD
Dividend Analysis (NEW v6.0)
bash
# Analyze dividends
uv run {baseDir}/scripts/dividends.py JNJ

# Compare dividend stocks
uv run {baseDir}/scripts/dividends.py JNJ PG KO MCD --output json

Dividend Metrics:

  • Dividend Yield & Annual Payout
  • Payout Ratio (safe/moderate/high/unsustainable)
  • 5-Year Dividend Growth (CAGR)
  • Consecutive Years of Increases
  • Safety Score (0-100)
  • Income Rating (excellent/good/moderate/poor)
Watchlist + Alerts (NEW v6.0)
bash
# Add to watchlist
uv run {baseDir}/scripts/watchlist.py add AAPL

# With price target alert
uv run {baseDir}/scripts/watchlist.py add AAPL --target 200

# With stop loss alert
uv run {baseDir}/scripts/watchlist.py add AAPL --stop 150

# Alert on signal change (BUY→SELL)
uv run {baseDir}/scripts/watchlist.py add AAPL --alert-on signal

# View watchlist
uv run {baseDir}/scripts/watchlist.py list

# Check for triggered alerts
uv run {baseDir}/scripts/watchlist.py check
uv run {baseDir}/scripts/watchlist.py check --notify  # Telegram format

# Remove from watchlist
uv run {baseDir}/scripts/watchlist.py remove AAPL

Alert Types:

  • 🎯 Target Hit — Price >= target
  • 🛑 Stop Hit — Price <= stop
  • 📊 Signal Change — BUY/HOLD/SELL changed
Portfolio Management
bash
# Create portfolio
uv run {baseDir}/scripts/portfolio.py create "Tech Portfolio"

# Add assets
uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150
uv run {baseDir}/scripts/portfolio.py add BTC-USD --quantity 0.5 --cost 40000

# View portfolio
uv run {baseDir}/scripts/portfolio.py show

# Analyze with period returns
uv run {baseDir}/scripts/analyze_stock.py --portfolio "Tech Portfolio" --period weekly
🔥 Hot Scanner (NEW v6.1)
bash
# Full scan - find what's trending NOW
python3 {baseDir}/scripts/hot_scanner.py

# Fast scan (skip social media)
python3 {baseDir}/scripts/hot_scanner.py --no-social

# JSON output for automation
python3 {baseDir}/scripts/hot_scanner.py --json

Data Sources:

  • 📊 CoinGecko Trending — Top 15 trending coins
  • 📈 CoinGecko Movers — Biggest gainers/losers
  • 📰 Google News — Finance & crypto headlines
  • 📉 Yahoo Finance — Gainers, losers, most active
  • 🐦 Twitter/X — Social sentiment (requires auth)

Output:

  • Top trending by mention count
  • Crypto highlights with 24h changes
  • Stock movers by category
  • Breaking news with tickers

Twitter Setup (Optional):

  1. Install bird: npm install -g @steipete/bird
  2. Login to x.com in Safari/Chrome
  3. Create .env with AUTH_TOKEN and CT0
🔮 Rumor Scanner (NEW v6.2)
bash
# Find early signals, M&A rumors, insider activity
python3 {baseDir}/scripts/rumor_scanner.py

What it finds:

  • 🏢 M&A Rumors — Merger, acquisition, takeover bids
  • 👔 Insider Activity — CEO/Director buying/selling
  • 📊 Analyst Actions — Upgrades, downgrades, price target changes
  • 🐦 Twitter Whispers — "hearing that...", "sources say...", "rumor"
  • ⚖️ SEC Activity — Investigations, filings

Impact Scoring:

  • Each rumor is scored by potential market impact (1-10)
  • M&A/Takeover: +5 points
  • Insider buying: +4 points
  • Upgrade/Downgrade: +3 points
  • "Hearing"/"Sources say": +2 points
  • High engagement: +2 bonus

Best Practice: Run at 07:00 before US market open to catch pre-market signals.

Analysis Dimensions (8 for stocks, 3 for crypto)

Show full SKILL.md (230 more words)Show less
Stocks
DimensionWeightDescription
Earnings Surprise30%EPS beat/miss
Fundamentals20%P/E, margins, growth
Analyst Sentiment20%Ratings, price targets
Historical10%Past earnings reactions
Market Context10%VIX, SPY/QQQ trends
Sector15%Relative strength
Momentum15%RSI, 52-week range
Sentiment10%Fear/Greed, shorts, insiders
Crypto
  • Market Cap & Category
  • BTC Correlation (30-day)
  • Momentum (RSI, range)

Sentiment Sub-Indicators

IndicatorSourceSignal
Fear & GreedCNNContrarian (fear=buy)
Short InterestYahooSqueeze potential
VIX StructureFuturesStress detection
Insider TradesSEC EDGARSmart money
Put/Call RatioOptionsSentiment extreme

Risk Detection

  • ⚠️ Pre-Earnings — Warns if < 14 days to earnings
  • ⚠️ Post-Spike — Flags if up >15% in 5 days
  • ⚠️ Overbought — RSI >70 + near 52w high
  • ⚠️ Risk-Off — GLD/TLT/UUP rising together
  • ⚠️ Geopolitical — Taiwan, China, Russia, Middle East keywords
  • ⚠️ Breaking News — Crisis keywords in last 24h

Performance Options

FlagEffectSpeed
(default)Full analysis5-10s
--no-insiderSkip SEC EDGAR3-5s
--fastSkip insider + news2-3s

Supported Cryptos (Top 20)

BTC, ETH, BNB, SOL, XRP, ADA, DOGE, AVAX, DOT, MATIC, LINK, ATOM, UNI, LTC, BCH, XLM, ALGO, VET, FIL, NEAR

(Use -USD suffix: BTC-USD, ETH-USD)

Data Storage

FileLocation
Portfolios~/.clawdbot/skills/stock-analysis/portfolios.json
Watchlist~/.clawdbot/skills/stock-analysis/watchlist.json

Limitations

  • Yahoo Finance may lag 15-20 minutes
  • Short interest lags ~2 weeks (FINRA)
  • Insider trades lag 2-3 days (SEC filing)
  • US markets only (non-US incomplete)
  • Breaking news: 1h cache, keyword-based

Disclaimer

⚠️ NOT FINANCIAL ADVICE. For informational purposes only. Consult a licensed financial advisor before making investment decisions.

© 24mlight, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 16 other files (scripts) in skills/stock-analysis of 24mlight/StockClaw.

  • SKILL.md
  • App-Plan.md
  • README.md
  • TODO.md
  • _meta.json
  • docs/ARCHITECTURE.md
  • docs/CONCEPT.md
  • docs/HOT_SCANNER.md
  • docs/README.md
  • docs/USAGE.md
  • scripts/analyze_stock.py
  • scripts/dividends.py
  • scripts/hot_scanner.py
  • scripts/portfolio.py
  • scripts/rumor_scanner.py
  • scripts/test_stock_analysis.py
  • scripts/watchlist.py

Open the folder on GitHubat commit 7872331

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in 24mlight/StockClaw, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Stock Analysis 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.

Stock Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stock Analysis this skill24mlight/StockClaw1012 repos~2kAutomated safety check: NotesMIT
Stock Analysissundial-org/awesome-openclaw-skills663—~2.1kAutomated safety check: PassNone
Longbridge Researchhelsome/folio2693 repos~2.1kAutomated safety check: PassMIT
Regimejackson-video-resources/markov-hedge-fund-method483—~1.6kAutomated safety check: PassCustom licence
ApocdataApocData/ApocData-skill104—~1.9kAutomated safety check: PassApache-2.0
Bitget Walletbitget-wallet-ai-lab/bitget-wallet-skill245—~7.6kAutomated safety check: PassMIT

Similar skills

  • Stock Analysis

    sundial-org/awesome-openclaw-skills

    Analyze stocks and cryptocurrencies using Yahoo Finance data.

    663 GitHub stars~2.1k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Longbridge Research

    helsome/folio

    Institution ratings, consensus price targets, EPS/revenue forecasts, finance calendar, shareholder data, fund holders, insider trades (SEC Form 4), short interest, industry rankings, peer group…

    269 GitHub starsUsed in 3 repos~2.1k tokens
    Business, Finance & HRAuto-check passed
  • Regime

    jackson-video-resources/markov-hedge-fund-method

    Detect the market regime (Bull / Bear / Sideways) for ANY asset and turn it into a tradeable signal or a risk filter.

    483 GitHub stars~1.6k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Apocdata

    ApocData/ApocData-skill

    A-share data service with structured announcement parsing: every announcement carries an AI summary, category, importance level and sentiment, fully traceable to source.

    104 GitHub stars~1.9k tokensUpdated 23 days ago
    Business, Finance & HRAuto-check passed
  • Bitget Wallet

    bitget-wallet-ai-lab/bitget-wallet-skill

    Interact with Bitget Wallet API for crypto market data, token info, swap quotes, RWA (real-world asset) stock trading, and security audits.

    245 GitHub stars~7.6k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Stock Value Analyzer

    FunnyKun/stock-value-analyzer

    基于邱国鹭《投资中最简单的事》方法论的股票价值分析器(v2.0 双层架构)。通过"三好原则"(好行业、好公司、好价格)系统评估一只股票是否值得投资。v2.0 在原定性框架之上注入一套可量化、可复现的硬模型层——反向 DCF 反解市场隐含增速、情景概率加权估值、EPV 盈利能力价值、分行业估值路由、杜邦三/五因子分解、ROIC vs WACC、Piotroski F-Score、Beneish…

    140 GitHub stars~3.3k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed

More from 24mlight/StockClaw

  • 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
    Auto-check: notes
  • Technical Indicators

    24mlight/StockClaw

    Calculate technical analysis indicators for stock market analysis

    101 GitHub stars~592 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Stock Analysis

What does Stock Analysis do?

Analyze stocks and cryptocurrencies using Yahoo Finance data. Stock Analysis is an agent skill from 24mlight/StockClaw. Analyze stocks and cryptocurrencies using Yahoo Finance data.

When should I use Stock Analysis?

Stock Analysis fits situations like: portfolio tracking; earnings reactions; crypto monitoring; trending stocks.

How do I install Stock Analysis in Claude Code?

Run `npx skills add 24mlight/StockClaw --skill stock-analysis -a claude-code`. Or copy the skill folder (skills/stock-analysis in 24mlight/StockClaw) into .claude/skills/stock-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Stock Analysis in Codex?

Run `npx skills add 24mlight/StockClaw --skill stock-analysis -a codex`. Or copy the skill folder (skills/stock-analysis in 24mlight/StockClaw) into .agents/skills/stock-analysis in your project. Codex loads it when a task matches its description.

Can I use Stock Analysis 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 24mlight/StockClaw --skill stock-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/stock-analysis, .gemini/skills/stock-analysis, .github/skills/stock-analysis and .opencode/skills/stock-analysis in your project.

What does Stock Analysis need to run?

Going by SKILL.md and its folder, Stock Analysis needs Python for the scripts in its folder, the command-line tools its instructions call (uv, python3 and npm) and credentials named AUTH_TOKEN. Our summary lists: Python 3; Node.js; A credential in AUTH_TOKEN.

Does Stock Analysis access the network?

SKILL.md contains no URLs. Its commands use uv and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Stock Analysis safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Stock Analysis use?

Stock Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Stock Analysis use?

About 2k tokens (SKILL.md is roughly 8.1k 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 Stock Analysis?

Skills that share tags, products or a category with Stock Analysis: Stock Analysis (sundial-org/awesome-openclaw-skills, 663 stars), Longbridge Research (helsome/folio, 269 stars), Regime (jackson-video-resources/markov-hedge-fund-method, 483 stars) and Apocdata (ApocData/ApocData-skill, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stock Analysis?

24mlight (a GitHub user) maintains it in 24mlight/StockClaw, which has 101 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on March 15, 2026.

Source: 24mlight/StockClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.