us-stock — Claude Code skill: what it does, how to install
Fetches US stock fundamentals, insider filings, institutional holders, and quotes via yfinance with TwelveData fallback.
no license 134 installs ★ 33 updated 2026-10-22
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a claude-codeWhat us-stock does
The skill analyzes US equities by ticker. Its exports.py script routes quote lookups to TwelveData, falling back to yfinance on errors. Fundamentals like balance sheets, institutional ownership, and Form 4 insider transactions come directly from yfinance.
Most calls return a standardized dictionary envelope. The get_full_report helper aggregates quotes, business metrics, and recent news into one payload. Importing via core.skill_tools prevents file collisions with cn-stock in the same runtime.
Setup requires Python and the yfinance library. Yahoo caps aggressive requests at roughly 2000 calls per hour, so batch runs require pacing between tickers. Missing values convert directly to null.
What it helps with
- fetch balance sheet and cash flow statements for US equities
- review recent Form 4 insider purchases and sales
- inspect top institutional and mutual fund shareholdings
- track upcoming earnings dates alongside EPS estimates
- pull valuation multiples, margins, and dividend history
Example prompts for the agent
- Show recent insider trades for NVDA
- Run get_full_report for MSFT
- Check institutional ownership and dividend yield for AAPL
How to install us-stock
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a claude-code2Manually: put the files in place
~/.claude/skills/us-stock/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/us-stock/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a codex2Manually: put the files in place
.agents/skills/us-stock/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a cursor2Manually: put the files in place
.cursor/skills/us-stock/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Starchild-ai-agent/official-skills us-stock2Manually: put the files in place
.github/skills/us-stock/SKILL.md1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a gemini-cli2Platform CLI
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path us-stockManually: put the files in place
.devin/skills/us-stock/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about us-stock
How to install us-stock in Claude Code?
Run npx skills add Starchild-ai-agent/official-skills --skill us-stock -a claude-code. The command configures the skill at ~/.claude/skills/us-stock/SKILL.md.
What does us-stock do?
It retrieves US equity metrics, including financials, ownership breakdown, insider filings, analyst targets, and real-time quotes.
What are the dependencies for us-stock?
You need Python and the yfinance library installed via pip. It can also route price lookups to a local TwelveData skill if present.