Skip to content
cccskills
FreePublished on GitHub

trader-news

The News Monitor. Watches breaking market news and SEC filings for the stocks you hold (or are about to copy): Yahoo Finance headlines per ticker and each company's 8-K filings on SEC EDGAR (earnings, CEO changes, deals, restatements, bankruptcy). Shows only what is new since the last check, newest first, flags what touches your positions and why it matters, and never repeats an item. Use when the user says "any news on my stocks", "what's happening with Apple", "monitor the news", "watch my portfolio", "did anything break", "check the 8-Ks", or "morning briefing".

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (2)

  • SKILL.md4.7 KB
  • news.py17.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

trader-news

A position you hold can change in a minute: an earnings miss, a CEO leaving, a lawsuit, a restatement. This skill reads the two feeds that carry those first for each of your stocks and tells you only what is new.

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

python3 "${CLAUDE_SKILL_DIR}/news.py" --help

What it reads and writes

  • Your tickers: --tickers, else trader/portfolio.json positions, else trader/targets.json weights (so it works right after /trader-copycat).
  • Headlines: Yahoo Finance's public headline RSS, one feed per ticker (https://feeds.finance.yahoo.com/rss/2.0/headline?s=AAPL&region=US&lang=en-US).
  • Filings: SEC EDGAR's company Atom feed, 8-K by default (--forms 8-K,10-Q for more). Needs the SEC User-Agent from trader/config.json (sec_user_agent) or SEC_USER_AGENT. Without it, filings are skipped with a note and headlines still run.
  • Writes trader/state/news.json: what has been shown (kept 30 days) and the CIK for each ticker, so every item appears once.

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 it is paywalled.
  • 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 (the feed it came from plus any of your tickers or company names it mentions) and tags (earnings, analyst, legal, deal, capital, people, risk). 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).
  • No predictions. Report what was published. Never say what the stock will do next.

Steps

  1. Run the check:

    python3 "${CLAUDE_SKILL_DIR}/news.py"
    python3 "${CLAUDE_SKILL_DIR}/news.py" --tickers AAPL AXP GOOGL KO BAC --hours 24
    

    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, every item tagged earnings, legal or risk, and anything touching the biggest positions first.

  3. Write a short brief: per ticker, what happened, the source and link, and one line on why it matters to this portfolio (its weight, from trader/targets.json or trader/portfolio.json).

  4. If a story might change the plan (an 8-K 4.02 restatement, a delisting notice), say so and suggest /trader-analyst for the numbers or /trader-risk to recheck pending orders. Never act on a headline alone.

To run it on a schedule, use /loop 30m /trader-news during market hours or a scheduled task each morning.

Example: the reel's portfolio

The user copied Berkshire's top 5 (AAPL, AXP, GOOGL, KO, BAC). On Tuesday 2026-10-13 the check shows Apple headlines first ("Apple Introduces HomeView Smart Home Hub, Other Gadgets", "Judge orders OpenAI to turn over hiring records in Apple trade secrets case", tagged legal), Coca-Cola dividend pieces, and from SEC: Apple's 8-K of 2026-07-30 (item 2.02, earnings results) and Coca-Cola's of 2026-07-28 (2.02). Brief: "Apple (your biggest position, 30.7%) launched a $299 smart home hub; a court ruling in its trade secrets case against OpenAI. No new filings from your five companies this week." 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 SEC 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Price Alerts. Rings when a price target, a stop or the opening bell hits: above / below / stop rules, percent moves from the previous close, and the NYSE opening bell, each ringing once so you are not spammed. Knows NYSE hours with the 2026 and 2027 holidays and 1:00 p.m. early closes, fetches free delayed quotes (Yahoo chart JSON, Stooq CSV) one ticker at a time, and writes trader/prices.json for the other skills. Use when the user says "alert me when", "tell me if AAPL hits", "set a stop", "price target", "watch my stocks", "is the market open", "when does the market open", "get me prices", or to refresh prices before sizing, risk or tax.

The English summary is being prepared. Showing the original description.

Jakeschincariol/trader-skill450Updated Oct 15, 2026

The Earnings Analyst. Reads a company's reported numbers straight from SEC EDGAR (XBRL company facts from its 10-Qs and 10-Ks, plus the latest earnings 8-K and its press release) and sums up what changed: revenue, gross, operating and net margins, net income and diluted EPS, quarter by quarter, each against the same quarter a year earlier, with the trailing twelve months. Writes a metrics file the screener reads. Use when the user says "how did Apple's earnings look", "analyze the earnings", "what changed this quarter", "is revenue growing", "check the 10-Q", "compare margins", or "run the analyst on my holdings".

The English summary is being prepared. Showing the original description.

Jakeschincariol/trader-skill450Updated Oct 15, 2026

Order Executor. Places APPROVED orders through your brokerage connector, one at a time, and never without your explicit yes. Shows each order as a plain ticket plus the exact JSON for Alpaca's place_stock_order, records your yes word for word, then Claude's own Allow once / Deny card asks again. Covers setting up Alpaca's official MCP server in Claude Desktop (paper trading by default, keys in env vars, never in chat), the Interactive Brokers connector (orders go to your IBKR account for your approval), and setting order tools to "Needs approval". Use when the user says "place the orders", "buy it", "execute", "send it to my broker", "connect Alpaca", "connect Interactive Brokers", "set up paper trading", or after /trader-risk passes.

The English summary is being prepared. Showing the original description.

Jakeschincariol/trader-skill450Updated Oct 15, 2026

Budget Manager. Sizes every position to your budget before anything is bought: keeps a cash buffer, caps any one stock (the excess is shared out to the others), drops slices under your minimum order, rounds so every dollar is used, supports fractional or whole shares, and writes the proposed buy orders to trader/orders.json in the exact shape of Alpaca's place_stock_order (notional as a string). Nothing is placed. Use when the user says "I have $5,000", "size my trades", "how much of each should I buy", "manage my budget", "split my money", "keep 10% in cash", "no stock over 25%", "set my rules", or after /trader-copycat writes targets.

The English summary is being prepared. Showing the original description.

Jakeschincariol/trader-skill450Updated Oct 15, 2026

The Reverse Engineer. Reads a famous investor's public SEC filings (the quarterly 13F-HR, plus Form 4 if you want the insider trades) and rebuilds their portfolio as weights you can copy: every position, its share of the fund, what they bought, added, trimmed and sold since the last quarter, with tickers matched to every CUSIP. Then it writes trader/targets.json so the budget skill can size it to your money. Use when the user says "copy Buffett", "copy Berkshire", "what does Ackman own", "reverse engineer this investor", "show me their 13F", "what did they buy last quarter", "copy the top 5", or names any fund or famous investor.

The English summary is being prepared. Showing the original description.

Jakeschincariol/trader-skill450Updated Oct 15, 2026

The Pelosi Tracker. Watches the stock trades members of Congress must disclose under the STOCK Act: reads the House Clerk's public Periodic Transaction Reports (PTRs) as soon as they are posted, alerts once per new filing, and turns each PDF into clean rows (who, owner, stock, ticker, buy or sell, options strike and expiry, trade date, amount range, how many days it took to disclose). Flags trades in stocks you hold. Senate reports are covered by a documented manual route. Use when the user says "what is Pelosi buying", "track Nancy Pelosi", "Congress trades", "politician stock trades", "did any congressman buy X", "alert me when Pelosi files", or "run the Pelosi skill".

The English summary is being prepared. Showing the original description.

Jakeschincariol/trader-skill450Updated Oct 15, 2026

See all skills by Jakeschincariol

Report a problem with this skill