trader-screener
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.
Install / Use
npx skills add Jakeschincariol/trader-skill --skill trader-screenerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Tags
Our assessment of trader-screener
trader-screener scores 86/100 on our quality scale, 434th of 603 Data & Analytics skills we index.
Its SKILL.md is 4.5 KB long, split into 7 sections with 3 code examples: a solid amount of guidance for an agent.
With 1,772 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 34 days ago, so trader-screener is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
trader-screener compared with similar skills
All 4 of these similar skills score higher than trader-screener; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| trader-screener (this skill)by Jakeschincariol | 86 | 1.8k | 34d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 56d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 56d ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 6d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install trader-screener?
- Run
npx skills add Jakeschincariol/trader-skill --skill trader-screener. The install tabs above show the steps for each supported agent. - Which AI agents does trader-screener work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is trader-screener safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is trader-screener still maintained?
- The repository was last updated 34 days ago, so trader-screener is actively maintained.
Skill content
View source on GitHubname: trader-screener description: >- 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". argument-hint: "[metrics file] [--rules rules.json]"
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.jsonfrom/trader-analyst(facts.py --metrics), or any JSON list or CSV with atickercolumn. CSV numbers may carry$,%and commas. - Prices (optional):
trader/prices.json({"prices": {"AAPL": 341.27}}, any source;/trader-alertswrites it). With prices it addsprice,pe(price / trailing EPS, only when EPS is positive) andearnings_yield. - Rules: a JSON file,
rules.example.jsonin this folder to start from. - Writes
trader/shortlist.jsonwith--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
-
Turn the user's words into rules. Ask when a threshold is vague ("cheap" means what P/E?). Write them to
trader/rules.json. -
Get metrics for the candidates: run
/trader-analyston them with--metrics trader/metrics.json(itsfacts.py AAPL AXP GOOGL KO BAC --metrics trader/metrics.json), or use the user's own CSV. Prices fromtrader/prices.jsonif P/E matters. -
Run the screen:
python3 "${CLAUDE_SKILL_DIR}/screen.py" trader/metrics.json --rules trader/rules.json \ --prices trader/prices.json --out trader/shortlist.jsonExit code 1 means nothing passed: say so and show the closest misses.
-
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-analyston 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-budgetor 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.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
