MCPInstall

trader-screener

by jakeschincariolData & Databases

The Stock Screener. Checks a list of companies against the user's own rules (revenue growth, margins, EPS, P/E, earnings yield, sector, anything in the metrics file), says exactly which rule each company passes or fails and by how much, and ranks the ones that pass into a shortlist. Reads the metrics /trader-analyst writes from SEC filings, or any CSV. Use when the user says "screen for stocks", "find me companies that", "filter my watchlist", "which of these pass my rules", "shortlist candidates", "rank these stocks", or "growing companies under 30 times earnings".

Installs
42
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/jakeschincariol/trader-skill --skill trader-screener
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads trader-screener automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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):

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

{"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.

  2. 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.

  3. Run the screen:

    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.

  4. 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.

FAQ

What does the trader-screener skill do?

The Stock Screener. Checks a list of companies against the user's own rules (revenue growth, margins, EPS, P/E, earnings yield, sector, anything in the metrics file), says exactly which rule each company passes or fails and by how much, and ranks the ones that pass into a shortlist. Reads the metrics /trader-analyst writes from SEC filings, or any CSV. Use when the user says "screen for stocks", "find me companies that", "filter my watchlist", "which of these pass my rules", "shortlist candidates", "rank these stocks", or "growing companies under 30 times earnings".

How do I install trader-screener?

Run npx skills add https://github.com/jakeschincariol/trader-skill --skill trader-screener in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/trader-screener/ (personal) or .claude/skills/trader-screener/ (project).

Which AI agents can use trader-screener?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is trader-screener safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains trader-screener?

It is published by jakeschincariol in jakeschincariol/trader-skill. It has 42 recorded installs.

More from jakeschincariol/trader-skill

View all →

trader-analyst

jakeschincariol/trader-skill

Open the skill to read its SKILL.md instructions.

42 installs

trader-budget

jakeschincariol/trader-skill

Open the skill to read its SKILL.md instructions.

41 installs

trader-pelosi

jakeschincariol/trader-skill

Open the skill to read its SKILL.md instructions.

41 installs

trader-tax

jakeschincariol/trader-skill

Open the skill to read its SKILL.md instructions.

41 installs

trader-rebalance

jakeschincariol/trader-skill

Rebalancer. Brings the portfolio back to its target weights when it drifts: values every holding at current prices, works out each stock's drift from its target in percentage points, trades only the stocks outside a band (default 5 points), keeps the cash buffer and the per-stock cap, skips tiny trades, lists sells before buys, and writes the trades to trader/orders.json as proposals. Use when the user says "rebalance", "my portfolio drifted", "bring it back to the targets", "I added money", "the new 13F changed the weights", "am I overweight", or on a schedule (monthly or quarterly) after /trader-copycat updates the targets.

Business & Finance41 installs

trader-copycat

jakeschincariol/trader-skill

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.

Business & Finance41 installs

Popular data & databases skills

View category →

supabase-postgres-best-practices

supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pgcron, pgmq), vector/semantic search (pgvector), and restoring dumps (pgrestore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query.

OfficialData & Databases462.2K installs

prisma-client-api

prisma/skills

Prisma Client API reference covering model queries, filters, operators, and client methods. Use when writing database queries, using CRUD operations, filtering data, or configuring Prisma Client. Triggers on "prisma query", "findMany", "create", "update", "delete", "$transaction".

OfficialData & Databases393.5K installs

prisma-database-setup

prisma/skills

Deprecated compatibility name for prisma-orm-setup. Use only when a user or existing integration explicitly invokes prisma-database-setup; otherwise select prisma-orm-setup.

OfficialData & Databases392.3K installs

prisma-cli

prisma/skills

Prisma ORM 7 CLI reference for existing Prisma 7 applications or explicitly selected Prisma 7 workflows. Covers prisma init, generate, migrate, db, dev, studio, and mcp. For setup, connection repair, or Prisma 8, use prisma-orm-setup; not the Prisma Platform CLI.

OfficialData & Databases390.8K installs

prisma-postgres

prisma/skills

Deprecated compatibility name for prisma-postgres-setup. Use only when a user or existing integration explicitly invokes prisma-postgres; otherwise select prisma-postgres-setup.

OfficialData & Databases384.4K installs

prisma-driver-adapter-implementation

prisma/skills

Required reference for Prisma ORM 7 SQL driver adapter work. Use when implementing or modifying adapters, adding database drivers, or touching SqlDriverAdapter, Transaction, savepoint, result mapping, or DriverAdapterError behavior. Covers current transaction lifecycle, optional savepoint hooks, original database-error preservation, and verification.

OfficialData & Databases378.9K installs