Skip to main content
skill CX Codex

trader-news — Claude Code skill: news and install

trader-news is a Claude Code skill that tracks stock headlines, 8-K filings, and price moves. It runs for ticker questions, morning briefs, and checks after /trader-scanner.

MIT ★ 9,067 updated 2026-10-20

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Jakeschincariol/day-trader-skill
/plugin install day-trader-skill@day-trader-skill
Open on GitHub

What trader-news does

trader-news collects current Yahoo Finance headlines, SEC EDGAR 8-K filings, and each stock’s distance from the previous close. It returns only unseen items, sorts them by New York time, applies tags, and marks moves of 3 % or more with MOVING.

The check uses python3 "${CLAUDE_SKILL_DIR}/news.py"; tickers can be passed with --tickers, while --json returns machine-readable output. Stories and filings are opened before they are summarized. The skill stores displayed items in trader/state/news.json, so the same item is not reported again.

SEC filings require sec_user_agent in trader/config.json or the SEC_USER_AGENT environment variable; without it, filings are skipped. The script uses Python’s standard library, and Yahoo Finance’s unofficial quote endpoint can lag. The skill only reads and reports data. Orders belong to /trader-broker after /trader-risk passes and the user gives explicit confirmation.

What it helps with

  • check fresh headlines for watchlist tickers
  • find new 8-K filings about earnings, deals, or officer changes
  • compare a news item with the move from yesterday’s close
  • remove stories already shown in earlier checks
  • prepare a morning or pre-market market brief

Example prompts for the agent

  • Show the latest news for TSLA and explain what is moving the stock.
  • Check my watchlist for new 8-K filings and tag the important items.
  • Run a morning briefing after /trader-scanner and flag moving tickers.

How to install trader-news

1Plugin marketplace

/plugin marketplace add Jakeschincariol/day-trader-skill
/plugin install day-trader-skill@day-trader-skill

This installs the whole day-trader-skill plugin with all its skills

2Skills CLI (Vercel)

npx skills add Jakeschincariol/day-trader-skill --skill trader-news -a claude-code

3Manually: put the files in place

~/.claude/skills/trader-news/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/trader-news/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about trader-news

How do I install trader-news in Claude Code?

Run /plugin marketplace add Jakeschincariol/day-trader-skill, then run /plugin install day-trader-skill@day-trader-skill.

What does trader-news do?

It reads Yahoo Finance headlines, SEC EDGAR 8-K filings, and the current price against yesterday’s close. The skill reports unseen items with tags and does not predict prices or place trades.

What does trader-news need to work?

Python with its standard library is required. SEC filing checks require sec_user_agent in trader/config.json or the SEC_USER_AGENT environment variable; otherwise filings are skipped.

Source text

SKILL.md · MIT
---
name: trader-news
description: >-
  News Monitor. Tracks breaking news on every stock you watch and flags what
  moves it: Yahoo Finance headlines per ticker, each company's 8-K filings on
  SEC EDGAR (earnings, CEO changes, deals, restatements, bankruptcy) and how
  far each stock is from yesterday's close. Shows only what is new since the
  last check, newest first, in New York time, tags each item (earnings,
  analyst, deal, halt, regulatory, macro...) and never repeats one. Use when
  the user says "any news on TSLA", "why is this moving", "what's the news on
  my watchlist", "morning briefing", "pre-market news", "monitor the news",
  "did anything break", "check the 8-Ks", or after /trader-scanner finds setups.
argument-hint: "[tickers]"
---

# trader-news

A chart can look perfect and still be about to gap on an earnings date, a
halt or a lawsuit. Before a setup becomes a trade, this skill reads the two
feeds that carry those first, for every stock on the watchlist, and tells you
only what is new. It also prints how far each stock has moved today, so a
headline and a move sit side by side.

Tool in this folder (standard library Python, no keys):

```bash
python3 "${CLAUDE_SKILL_DIR}/news.py"                         # watchlist + plan + portfolio
python3 "${CLAUDE_SKILL_DIR}/news.py" --tickers TSLA NVDA --hours 12
python3 "${CLAUDE_SKILL_DIR}/news.py" --no-sec --json
```

## What it reads and writes

| file / feed | what |
| --- | --- |
| `--tickers`, else `trader/watchlist.json` | the scanner's hits (trader-scanner) |
| `trader/plan.json` | the trade you are planning (trader-exit) |
| `trader/portfolio.json` | what you hold (trader-broker records fills there) |
| Yahoo Finance headline RSS | `https://feeds.finance.yahoo.com/rss/2.0/headline?s=TSLA&region=US&lang=en-US` |
| Yahoo Finance chart endpoint | the last price against yesterday's close (unofficial, can lag) |
| SEC EDGAR company Atom feed | 8-K by default (`--forms 8-K,10-Q` for more); needs `sec_user_agent` in `trader/config.json` or `SEC_USER_AGENT`, else filings are skipped with a note |
| `trader/state/news.json` | what has been shown (kept 30 days) and each ticker's CIK |

## The rules

- **Headlines are leads, not facts.** Before telling the user something
  happened, open the story or the filing and read it. Quote the source and
  link it. Never summarise a paywalled story you could not read: say so.
- **Filings beat headlines.** If an 8-K and a headline disagree, the 8-K is
  what the company told the SEC.
- **Say what it touches.** Every item lists the tickers it touches and its
  tags: earnings, analyst, legal, deal, capital, people, risk, halt,
  regulatory, macro. Filings marked `!` carry an important 8-K item: earnings
  results (2.02), an officer change (5.02), an impairment (2.06), a delisting
  notice (3.01), past financials no longer reliable (4.02), bankruptcy (1.03)
  or a cyber incident (1.05).
- **MOVING** marks a stock 3 % or more from yesterday's close (`--move-pct`).
  A move with no headline is worth saying out loud too.
- **No predictions.** Report what was published and how far the price is from
  yesterday's close. Never say what the stock will do next.

## Steps

1. Run the check: `python3 "${CLAUDE_SKILL_DIR}/news.py"`. Exit code 1 means
   nothing new. `--all` shows items already seen, `--json` gives everything
   machine readable, `--dry-run` leaves the state alone.
2. Read the items that matter: every `!` filing, anything tagged earnings,
   halt, legal, regulatory or risk, and every MOVING ticker first.
3. Write a short brief, per ticker: what happened, the source and link, the
   move, and one line on why it matters to the setup (for example "earnings
   are this week: an overnight gap can jump past any stop").
4. If a story changes the picture, say so before `/trader-entry` and
   `/trader-exit`: an earnings date inside the trade, a halt, an offering.
   Never act on a headline alone.

During the session: `/loop 15m /trader-news`, or a scheduled task each
morning before the open.

## Example: the reel

Monday 2026-10-19, TSLA broke its opening range at 10:15 AM ET. The check at
10:15 (Yahoo Finance's TSLA feed, 16 headlines since 8:00) leads with the
morning's real stories: "Meta and Musk earnings and September pending home
sales: What to Watch" (8:00, earnings), "Tesla-SpaceX Merger Mania Strikes
Wall Street Ahead of Earnings" (8:04, earnings, deal), "Tech Stock Rebound
Nudges US Equity Futures Mostly Higher Pre-Bell" (8:02, macro). The brief:
"Tesla reports this week, so the stock can gap overnight; today's trade is
in and out before the close. No new 8-K." At 10:52 the price line reads
`TSLA 366.48 +3.31% vs yesterday's close 354.72 at 10:52 ET  MOVING`. When a
ticker has no news, say so rather than padding the brief.

## What it never does

- Never invents or embellishes a story, a quote or a number.
- Never trades on news, and never tells the user to buy or sell because of a
  headline.
- Never hammers a server: one request per feed per ticker, a pause between
  calls, and SEC's 10 requests a second limit stays far away.

## Safety

Education and tooling, not financial advice. This skill only reads and
reports. Nothing places an order except `/trader-broker`, after
`/trader-risk` passes and the user types an explicit yes for that order.

© Jake Schincariol · MIT · Jakeschincariol/day-trader-skill

Similar skills

All skills for Finance and business →

From the same set12

The whole set →
day-trader-skill The day-trader-skill plugin for Claude Code runs eleven day trading tools including a chart scanner, news monitor, entry timer, and trade outcome simulator. ★ 9,067repo stars trader-analyst trader-analyst is a Claude Code skill that reads company filings directly from SEC EDGAR. It compares revenue, margins, and EPS year over year before earnings trades. CX Codex +1 ★ 9,067repo stars trader-exit trader-exit is a Claude Code skill that sets stops and profit targets before entering long day trades. Triggers automatically after trader-entry or on prompts like "where's my stop". CX Codex +1 ★ 9,067repo stars trader-pelosi trader-pelosi is a Claude Code skill that monitors stock trades disclosed by members of US Congress. It checks House Clerk PTR index files and extracts transactions from filed PDFs. CX Codex +1 ★ 9,067repo stars trader-entry trader-entry is a Claude Code skill that watches market bars and names an entry after a close above a level. It starts from requests to watch a ticker or check a breakout. CX Codex +1 ★ 9,067repo stars trader-alerts trader-alerts is a Claude Code skill that tracks stock prices, stop levels, and NYSE session times. Triggers when checking quotes, watching stops, or right after generating a trade plan. CX Codex +1 ★ 9,067repo stars trader-budget trader-budget is a Claude Code skill that sizes positions from a budget and per-trade loss limit. It runs on share-count requests or after trader-exit writes a plan. CX Codex +1 ★ 9,067repo stars trader-risk trader-risk is a Claude Code skill that inspects proposed orders against risk limits before passing them to the broker. It blocks entries lacking stops or exceeding daily loss caps. CX Codex +1 ★ 9,067repo stars

Project sponsors

Companies that keep this analytics open