# us-stock

Fetches US stock fundamentals, insider filings, institutional holders, and quotes via yfinance with TwelveData fallback.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 134 installs · ★ 33 repo stars
- Author: Starchild-ai-agent
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/us-stock/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/us-stock

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/us-stock/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/us-stock/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/us-stock/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/us-stock/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills us-stock
```

2. **Manually: put the files in place**
- File: `.github/skills/us-stock/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path us-stock
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/us-stock/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill us-stock -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/us-stock/SKILL.md

## When to use it
- 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
- Show recent insider trades for NVDA
- Run get_full_report for MSFT
- Check institutional ownership and dividend yield for AAPL

## Similar
- [stock-correlation](https://affpapa.org/en/nevibecode/skills/stock-correlation.md) — skill · 4000 installs
- [stock-liquidity](https://affpapa.org/en/nevibecode/skills/stock-liquidity.md) — skill · 3600 installs
- [stock-info-explorer](https://affpapa.org/en/nevibecode/skills/stock-info-explorer.md) — skill · 509 installs
- [alphaear-stock](https://affpapa.org/en/nevibecode/skills/alphaear-stock.md) — skill · 1300 installs
- [stock-market-pro](https://affpapa.org/en/nevibecode/skills/stock-market-pro.md) — skill · 4100 installs
- [Stock Screener](https://affpapa.org/en/nevibecode/mcp/stock-screener.md) — MCP server · ★ 424 repo stars

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
