trader-screener SKILL.md skillA

trader-screener from jakeschincariol/trader-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jakeschincariol/trader-skill/trader-screener@git:20261014.5189e79

Pins git:20261014.5189e79 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jakeschincariol/trader-skill
Path
trader-screener/SKILL.md
Versions recorded
1
Latest version
git:20261014.5189e79, committed Oct 14, 2026
Size
4,630 bytes
Repository stars
1,388
License
MIT

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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},
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jakeschincariol/trader-skill/trader-screener@sha256:058e1167d494bc19

The line at the top of this page pins the label git:20261014.5189e79, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_4hk3vrkyp2beqpn3.svg)](https://markdownregistry.com/a/art_4hk3vrkyp2beqpn3)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 14, 2026.

versioncommittedcommitsizeaudit
git:20261014.5189e79 latest2026-10-14 5189e79 4,630 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4630 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jakeschincariol/trader-skill · 1,388 stars · license MIT · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4hk3vrkyp2beqpn3
GET https://markdownregistry.com/api/v1/resolve?ref=jakeschincariol/trader-skill/trader-screener
GET https://markdownregistry.com/api/v1/blob/058e1167d494bc190c8485dd9160b774a9f35a7b533e8e3b8396099fa7d972f0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jakeschincariol/trader-skill

trader-alerts SKILL.md skill
jakeschincariol/trader-skill · trader-alerts/SKILL.md · Price Alerts. Rings when a price target, a stop or the opening bell hits: above / below / stop rules, percent moves…
git:20261014.5189e79 · audit A · 1,388 stars
trader-analyst SKILL.md skill
jakeschincariol/trader-skill · trader-analyst/SKILL.md · The Earnings Analyst. Reads a company's reported numbers straight from SEC EDGAR (XBRL company facts from its 10-Qs and…
git:20261014.5189e79 · audit A · 1,388 stars
trader-broker SKILL.md skill
jakeschincariol/trader-skill · trader-broker/SKILL.md · Order Executor. Places APPROVED orders through your brokerage connector, one at a time, and never without your explicit…
git:20261014.5189e79 · audit A · 1,388 stars
trader-budget SKILL.md skill
jakeschincariol/trader-skill · trader-budget/SKILL.md · Budget Manager. Sizes every position to your budget before anything is bought: keeps a cash buffer, caps any one stock…
git:20261014.5189e79 · audit A · 1,388 stars
trader-copycat SKILL.md skill
jakeschincariol/trader-skill · trader-copycat/SKILL.md · The Reverse Engineer. Reads a famous investor's public SEC filings (the quarterly 13F-HR, plus Form 4 if you want the…
git:20261014.5189e79 · audit A · 1,388 stars
trader-news SKILL.md skill
jakeschincariol/trader-skill · trader-news/SKILL.md · The News Monitor. Watches breaking market news and SEC filings for the stocks you hold (or are about to copy): Yahoo…
git:20261014.5189e79 · audit A · 1,388 stars
trader-pelosi SKILL.md skill
jakeschincariol/trader-skill · trader-pelosi/SKILL.md · The Pelosi Tracker. Watches the stock trades members of Congress must disclose under the STOCK Act: reads the House…
git:20261014.5189e79 · audit A · 1,388 stars
trader-rebalance SKILL.md skill
jakeschincariol/trader-skill · trader-rebalance/SKILL.md · Rebalancer. Brings the portfolio back to its target weights when it drifts: values every holding at current prices…
git:20261014.5189e79 · audit A · 1,388 stars
trader-risk SKILL.md skill
jakeschincariol/trader-skill · trader-risk/SKILL.md · Risk Manager. Checks every proposed order against your limits before it can reach the broker and blocks anything over…
git:20261014.5189e79 · audit A · 1,388 stars
trader-tax SKILL.md skill
jakeschincariol/trader-skill · trader-tax/SKILL.md · Tax Optimizer. Tracks cost-basis lots for every position (FIFO, highest cost first, or specific lots), shows unrealized…
git:20261014.5189e79 · audit A · 1,388 stars

Every file in jakeschincariol/trader-skill

Browse by kind, by grade A, or by owner.