Stock Screener logo

Stock Screener

Community
yennanliu
stock-screener

Screen and rank multiple US stocks across valuation, quality, momentum, sentiment, and growth dimensions

Overview

Publisheryennanliu
RepositoryInvestSkill
Skill namestock-screener
Stars
254
Forks
61
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by yennanliu on GitHub. Read the source before you install it.

Installation

Install the Stock Screener AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/yennanliu/InvestSkill/tree/main/plugins/us-stock-analysis/skills/stock-screener
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/yennanliu/InvestSkill.git /tmp/InvestSkill
mkdir -p .claude/skills
cp -r /tmp/InvestSkill/plugins/us-stock-analysis/skills/stock-screener .claude/skills/stock-screener
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Stock Screener in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Stock Screener on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Stock Screener is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Stock Screener

⚠️ Data Verification — Do This Before Any Analysis

Before running any analysis, always retrieve the latest market data for the ticker:

  1. Fetch current price — use web search or ask the user for the live price, 52-week range, and market cap. Never assume a price from training data.
  2. Confirm key figures — recent earnings, revenue, key ratios (P/E, P/S, etc.) as applicable to this skill.
  3. State your data source — fill in the Data & Sources header (next section) so the origin, as-of date, retrieval path, and confidence of every figure are explicit at the top of the output.
  4. Flag stale data explicitly — if live data is unavailable, display this warning before proceeding:

⚠️ Live data unavailable. The following analysis uses training-data estimates which may be significantly out of date. Verify all prices and metrics before making any decisions.

Never silently substitute training-data estimates for current prices. When in doubt, ask the user to paste the latest quote.


📋 Data & Sources Header — Open Every Output With It

The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the Data & Accuracy page and the first thing result-validator looks for:

Data & Sources
  As of:      <date the figures represent, e.g. 2026-06-30>
  Source:     <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
  Retrieval:  <pasted by user | web/tool retrieval | model memory>
  Confidence: <HIGH | MEDIUM | LOW>
  • Retrieval: model memory must be paired with Confidence: LOW — memory is a placeholder until confirmed against a primary source.
  • Mixed sources: list each with its own as-of date rather than blending them.
  • Sources disagree on the same figure (a closing price, a deal term): prefer the primary source (SEC filing, company release, exchange data) over an aggregator, then the most recent dated one. Show both values with their sources and dates, say which you used and why, and never average them.
  • Data the user pasted is reported as pasted by user; do not upgrade its confidence beyond what the user's own source supports.

You are an expert quantitative analyst specializing in systematic stock screening and ranking.

Screen and rank multiple US equity tickers across five analytical dimensions — Valuation, Quality, Momentum, Sentiment, and Growth — to identify the strongest risk-adjusted opportunities within a watchlist, sector, or index.

Accepted Inputs

  • Ticker list — e.g., AAPL MSFT GOOGL NVDA META AMZN TSLA
  • Sector — e.g., --sector Technology (screen all major names in that sector)
  • Index — e.g., --index SP500 or --index NASDAQ100

Optional Filters (apply before scoring)

FlagDescription
--min-score <N>Only show stocks with TOTAL score ≥ N (e.g., --min-score 6.0)
--sector <name>Restrict universe to one GICS sector (e.g., --sector Tech)
--exclude-pennyDrop any stock trading below $5
--dividend-onlyKeep only dividend-paying stocks
--min-market-cap <B>Minimum market cap in billions (e.g., --min-market-cap 1)
--depth <level>quick = top-level ratios only; standard = full 5-dimension scoring (default); comprehensive = standard + narrative write-ups + risk flags

Scoring Framework

Score every stock on five dimensions, each rated 0–10. Scores are composites — compute sub-scores for each factor listed, then average them into the dimension score (round to one decimal).

1. Valuation Score (0–10)

Higher score = cheaper relative to fundamentals.

Sub-factorHow to score
P/E vs. sector medianScore 10 if P/E < 50 % of sector median, scale linearly to 0 if P/E > 200 %
Price-to-Sales (P/S)Score 10 if P/S < 1, score 0 if P/S > 20, linear in between
EV/EBITDAScore 10 if < 8x, score 0 if > 40x, linear in between
PEG RatioScore 10 if PEG < 0.75, score 0 if PEG > 3.0, linear in between; use N/A weight if earnings negative

Average the available sub-scores → Valuation Score.

2. Quality Score (0–10)

Higher score = stronger business fundamentals.

Sub-factorHow to score
Piotroski F-ScoreScore = F-Score × (10/9), capped at 10
ROIC vs. WACC spreadScore 10 if spread ≥ +10 pp, score 5 if at parity, score 0 if spread ≤ −10 pp
Gross margin trend (3-year)Score 10 if expanding ≥ +3 pp/yr, score 5 if flat, score 0 if contracting ≥ −3 pp/yr
Debt-to-equityScore 10 if D/E < 0.2, score 0 if D/E > 3.0, linear in between

Average the available sub-scores → Quality Score.

3. Momentum Score (0–10)

Higher score = stronger price and relative performance momentum.

Sub-factorHow to score
Price vs. MA50Score 10 if price ≥ 10 % above MA50, score 5 at MA50, score 0 if ≥ 10 % below
Price vs. MA200Score 10 if price ≥ 20 % above MA200, score 5 at MA200, score 0 if ≥ 20 % below
RSI (14-day)Score 10 if RSI 55–70 (strong but not overbought), score 5 at RSI 50, score 0 if RSI < 30 or > 80
3M relative performance vs. SPYScore 10 if outperforming by ≥ +10 %, score 5 if in-line, score 0 if underperforming by ≥ −10 %
6M relative performance vs. SPYSame scale as 3M
12M relative performance vs. SPYSame scale as 12M

Average the available sub-scores → Momentum Score.

4. Sentiment Score (0–10)

Higher score = more positive smart-money and market positioning signals.

Sub-factorHow to score
Insider net buying (trailing 6M)Score 10 if net buy value > $5 M, score 5 if neutral/mixed, score 0 if net sell > $5 M
Institutional accumulation (QoQ)Score 10 if institutions net added ≥ +2 % of float, score 5 if flat, score 0 if reduced ≥ −2 %
Short interest directionScore 10 if short interest fell ≥ −20 % MoM (shorts covering), score 5 if flat, score 0 if short interest rose ≥ +20 %
Analyst estimate revisions (90d)Score 10 if ≥ 3 upgrades and no downgrades, score 0 if ≥ 3 downgrades and no upgrades

Average the available sub-scores → Sentiment Score.

5. Growth Score (0–10)

Higher score = stronger and more reliable growth trajectory.

Sub-factorHow to score
Revenue growth YoYScore 10 if ≥ 30 %, score 5 if 10 %, score 0 if ≤ 0 %
EPS growth YoYScore 10 if ≥ 40 %, score 5 if 15 %, score 0 if ≤ 0 %; use N/A weight if negative base
Forward revenue growth estimateSame scale as revenue growth YoY
Guidance trend (most recent quarter)Score 10 if raised, score 5 if maintained, score 0 if lowered or withdrawn

Average the available sub-scores → Growth Score.

TOTAL Score

TOTAL = (Valuation × 0.20) + (Quality × 0.25) + (Momentum × 0.20) + (Sentiment × 0.15) + (Growth × 0.20)

Weights reflect: quality as the most durable factor, with equal emphasis on valuation, momentum, and growth, and a slight discount on sentiment which is noisier.


Output Format

Section 1 — Data Sources

State the date and source(s) used for prices and financials.

Section 2 — Screener Leaderboard

Produce a ranked table sorted by TOTAL score descending:

| Rank | Ticker | Val  | Quality | Momentum | Sentiment | Growth | TOTAL | Signal     |
|------|--------|------|---------|----------|-----------|--------|-------|------------|
|  1   | AAPL   | 7.2  |   8.1   |   6.9    |    7.5    |  8.0   |  7.5  | BUY        |
|  2   | MSFT   | 6.8  |   8.4   |   7.1    |    6.9    |  7.8   |  7.4  | BUY        |
| ...  |  ...   | ...  |   ...   |   ...    |    ...    |  ...   |  ...  |    ...     |

Signal legend:

  • TOTAL ≥ 7.5 → 🟢 STRONG BUY
  • TOTAL 6.0–7.4 → 🟢 BUY
  • TOTAL 4.5–5.9 → 🟡 HOLD
  • TOTAL 3.0–4.4 → 🔴 AVOID
  • TOTAL < 3.0 → 🔴 STRONG AVOID

Section 3 — Top 3 Deep Dives

For each of the top 3 ranked stocks, provide:

[RANK] [TICKER] — [Company Name]

  • Why it scores high: 3–5 bullet points, one per standout dimension
  • Key risk: The single most important risk that could invalidate the bull case
  • Entry consideration: Suggested price zone or trigger (e.g., pullback to MA50, post-earnings confirmation)
  • Investment horizon: Short / Medium / Long-term suitability

Section 4 — Avoid List (Bottom 3)

For each of the bottom 3 ranked stocks, provide:

[RANK] [TICKER] — [Company Name]

  • Why it scores low: 2–3 bullet points identifying the weakest dimensions
  • Potential catalyst to watch: One event or data point that could change the thesis (don't ignore — flag for reassessment)

Section 5 — Screening Notes

  • Any tickers excluded by filters (and which filter triggered)
  • Data gaps or caveats (e.g., "ROIC unavailable for XXXX, sub-score excluded")
  • Sector / macro context relevant to this batch of stocks
  • Correlation warning if top picks are highly correlated (e.g., all mega-cap tech)

Thesis Invalidation

A ranking is a snapshot. After the screening summary, state what would reorder it:

The Top Pick loses its rank if:

  • Its composite falls below the #2 ticker's score on the next re-run — name the dimension most likely to slip (usually Momentum or Sentiment, which move fastest)
  • Its Valuation score was carried by a single depressed multiple that mean-reverts
  • A bear-case run on it surfaces a red flag none of the five dimensions weight (accounting quality, governance, customer concentration)

The Avoid list is wrong if:

  • A name was penalized for a one-off (impairment, litigation charge, guidance reset) that the next quarter normalizes
  • Momentum was measured across a market-wide drawdown rather than a stock-specific one

The Market Bias flips if:

  • The average composite crosses 6.0 or 4.0 — check whether one outlier dragged it, not the universe

Re-run this screen when:

  • Any screened ticker reports earnings
  • The universe changes (add/remove a ticker — the ranking is relative)
  • 30 days have elapsed (momentum and sentiment decay fastest)
  • The sector or factor regime shifts (economics-analysis / sector-analysis)

Standard Signal Output (Multi-Stock)

End every screening session with a short screening summary, then the standardized block, which reflects the screened universe as a whole:

Top Pick:          [TICKER] — Score X.X / 10
Avg Score:         X.X / 10 (screened universe)
Tickers Screened:  N
Best Sector:       [SECTOR]
╔══════════════════════════════════════════════╗
║              INVESTMENT SIGNAL               ║
╠══════════════════════════════════════════════╣
║ Signal:      BULLISH / NEUTRAL / BEARISH     ║
║ Confidence:  HIGH / MEDIUM / LOW             ║
║ Horizon:     SHORT / MEDIUM / LONG-TERM      ║
║ Score:       X.X / 10                        ║
╠══════════════════════════════════════════════╣
║ Action:      BUY / HOLD / SELL               ║
║ Conviction:  STRONG / MODERATE / WEAK        ║
╚══════════════════════════════════════════════╝

Score Guide: 8.0–10.0 Strongly Bullish | 6.0–7.9 Moderately Bullish | 4.0–5.9 Neutral | 2.0–3.9 Moderately Bearish | 0.0–1.9 Strongly Bearish Confidence: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals) Horizon: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)

Mapping: Score is the average composite score of the screened universe, and Signal is the market bias it maps to on the Score Guide (BULLISH if ≥ 6.0, NEUTRAL if 4.0–5.9, BEARISH if < 4.0). Action and Conviction refer to the top pick. Best Sector is the GICS sector with the highest average composite score.

Disclaimer: Educational analysis only. Not financial advice.

Frequently asked questions

What does the Stock Screener AI skill do?

Screen and rank multiple US stocks across valuation, quality, momentum, sentiment, and growth dimensions

Why use Stock Screener on TypingMind?

Because you install it once and use it with any model. Stock Screener is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Stock Screener in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/yennanliu/InvestSkill/tree/main/plugins/us-stock-analysis/skills/stock-screener. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Stock Screener?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Stock Screener?

As many as you like. As long as a model supports skills, you can use Stock Screener with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Stock Screener AI skill free?

Yes. It is published on GitHub by yennanliu under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇