jakeschincariol/trader-skill

trader-screener

The Stock Screener.

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/jakeschincariol/trader-skill --skill trader-screener

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

trader-screener

A screen turns "I want profitable companies that are still growing and not too expensive" into rules a computer can check, and shows its work: every pass and every fail comes with the number and the threshold.

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

bash
python3 "${CLAUDE_SKILL_DIR}/screen.py" --help

What it reads and writes

  • Metrics: trader/metrics.json from /trader-analyst (facts.py --metrics),

or any JSON list or CSV with a ticker column. CSV numbers may carry $, % and commas.

  • Prices (optional): trader/prices.json ({"prices": {"AAPL": 341.27}},

any source; /trader-alerts writes it). With prices it adds price, pe (price / trailing EPS, only when EPS is positive) and earnings_yield.

  • Rules: a JSON file, rules.example.json in this folder to start from.
  • Writes trader/shortlist.json with --out: who passed, their score and

why, who failed and why.

The rules file

json
{"name": "Growing, profitable, not priced for perfection",
 "rules": [{"metric": "revenue_growth_yoy", "op": ">=", "value": 10},
           {"metric": "operating_margin", "op": ">=", "value": 25},
           {"metric": "pe", "op": "<=", "value": 35}],
 "rank":  [{"metric": "revenue_growth_yoy", "order": "desc", "weight": 2},
           {"metric": "pe", "order": "asc", "weight": 1}],
 "missing": "fail"}

Ops: >, >=, <, <=, ==, !=, between ([low, high]), in and not in (a list, for tickers or sectors to leave out). "missing": "fail" fails a company that lacks a metric a rule needs (banks have no operating margin in SEC's facts); "skip" ignores that rule for it and says so. Ranking scores each passing company 0 to 1 per rank metric and takes the weighted average.

Steps

  1. Turn the user's words into rules. Ask when a threshold is vague ("cheap"

means what P/E?). Write them to trader/rules.json.

  1. Get metrics for the candidates: run /trader-analyst on them with

--metrics trader/metrics.json (its facts.py AAPL AXP GOOGL KO BAC --metrics trader/metrics.json), or use the user's own CSV. Prices from trader/prices.json if P/E matters.

  1. Run the screen:
bash
   python3 "${CLAUDE_SKILL_DIR}/screen.py" trader/metrics.json --rules trader/rules.json \
     --prices trader/prices.json --out trader/shortlist.json

Exit code 1 means nothing passed: say so and show the closest misses.

  1. Report the shortlist with the reasons, the misses with the numbers that

failed, and the dates the numbers are from (the latest quarter end per company, the price date). Suggest /trader-analyst on the top names before anything else.

Example: the reel's five

Metrics from SEC for AAPL, AXP, GOOGL, KO and BAC, prices at the 2026-10-13 close, and rules.example.json:

Growing, profitable, not priced for perfection: 2 of 5 companies pass.
 1. PASS GOOGL  Alphabet Inc.  score 0.75   (growth 24.2, P/E 17.8)
 2. PASS KO     COCA COLA CO   score 0.25   (growth 12.1, P/E 28.3)
    FAIL AAPL   pe 39.2, needs <= 35
    FAIL BAC    operating_margin is missing
    FAIL AXP    revenue_growth_yoy 8.6, needs >= 10; operating_margin is missing

Then the caveats a careful analyst adds: Alphabet's latest quarter has net income above operating income (gains outside the business), and Coca-Cola's numbers stop at the quarter ending 2026-04-03 because SEC's facts lag its latest 10-Q.

What it never does

  • Never calls a passing company a buy. A screen is a filter on reported

numbers, not a recommendation.

  • Never fills in a missing number or guesses a metric: missing means missing.
  • Never sends anything to /trader-budget or an order path by itself.

Safety

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

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
jakeschincariol
Społeczność

trader-alerts

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", "pr

Instalacje / 1h
1
GitHub Stars
913
Aktualizacja
14 paź
jakeschincariol
Społeczność

trader-analyst

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", "wh

Instalacje / 1h
1
GitHub Stars
913
Aktualizacja
14 paź
jakeschincariol
Społeczność

trader-broker

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 placestockorder, 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 appr

Instalacje / 1h
1
GitHub Stars
913
Aktualizacja
14 paź
jakeschincariol
Społeczność

trader-budget

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 placestockorder (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

Instalacje / 1h
1
GitHub Stars
913
Aktualizacja
14 paź