Agent skill

ESG Stock Screener

by Geeksfino in Geeksfino/finskills

Screens US stocks through an ESG lens, applies optional exclusion lists, scores the environmental, social and governance pillars and judges whether ESG quality is improving.

Apache-2.0Auto-check passedBusiness, Finance & HR

Install ESG Stock Screener

skills CLI
$ npx skills add Geeksfino/finskills --skill esg-screener -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Geeksfino/finskills esg-screener --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Geeksfino/finskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/US-market/esg-screener .claude/skills/esg-screener && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
esg-screener
GitHub stars
282
Token cost
~1.4k tokens
SKILL.md length
601 words
Files
4 (incl. references)
Skills in repo
30
Repo updated
First seen
Licence
Apache-2.0

At a glance

Screens US stocks through an ESG lens, applies optional exclusion lists, scores the environmental, social and governance pillars and judges whether ESG quality is improving.

  • Works in 7 steps: Define Criteria → Apply Exclusion Screen (if applicable) → ESG Scoring → …
  • Screening a stock universe for ESG leaders and laggards
  • SKILL.md covers Workflow, Data Enhancement and Important Guidelines
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent acts as a sustainable investing analyst and starts by confirming the criteria with you: the universe (S&P 500 by default, or Russell 1000 or a custom list), the ESG approach (sector leaders by default, or exclusion, integration or thematic), the pillars in focus, the sector, any exclusions, how many companies to return (top 10 by default) and the comparison group.

It can then apply an exclusion screen covering categories such as tobacco, weapons, fossil fuels, adult entertainment, gambling, private prisons and severe controversies. Each company is scored from 0 to 100 on the environmental, social and governance pillars, weighted roughly a third each, and an ESG momentum step checks whether emissions, controversies, disclosure and targets are improving or deteriorating. References include an ESG framework and an output template, and the excerpt is cut off in the momentum step.

When your agent uses it

  • Screening a stock universe for ESG leaders and laggards
  • Applying an exclusion list for sectors an investor wants to avoid
  • Scoring a company or portfolio on environmental, social and governance criteria
  • Checking whether a company's ESG record is improving

Example prompts

  • “Screen the S&P 500 for the top 10 ESG leaders, excluding tobacco and weapons.”
  • “Score these five utilities on environmental, social and governance pillars against their sector peers.”
  • “Is this company's ESG momentum improving, judging by emissions and controversy trends?”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Define Criteria
  2. Apply Exclusion Screen (if applicable)
  3. ESG Scoring
  4. ESG Momentum
  5. Controversy Check
  6. Financial Integration
  7. Present Results

What it can do on your machine

Read from SKILL.md and the folder at commit 8722415. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

ESG Stock Screener loads about 1.4k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 117 tokens; SKILL.md has 601 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~117
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Geeksfino/finskills at commit 8722415, republished under its Apache-2.0 licence (© Geeksfino). 601 words, ~1,442 tokens.

Download SKILL.mdSave it as .claude/skills/esg-screener/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
esg-screener
description
Screen and analyze stocks through an ESG (Environmental, Social, Governance) lens, evaluating sustainability practices, controversy exposure, and responsible investing criteria. Use when the user asks about ESG investing, sustainable investing, socially responsible investing (SRI), impact investing, green stocks, carbon footprint analysis, governance quality assessment, controversy screening, exclusion lists, or ESG scoring of companies or portfolios.
license
Apache-2.0

ESG & Responsible Investing Screener

Act as a sustainable investing analyst. Screen and evaluate companies through Environmental, Social, and Governance criteria — identifying leaders, laggards, controversies, and ESG momentum to support responsible investment decisions.

Workflow

Step 1: Define Criteria

Confirm with the user:

InputOptionsDefault
UniverseS&P 500 / Russell 1000 / CustomS&P 500
ESG approachBest-in-class / Exclusion / Integration / ThematicBest-in-class
Focus pillarsE, S, G, or allAll three
SectorAll or specific sectorAll
ExclusionsControversial sectors to excludeNone
ResultsNumber of companiesTop 10
ComparisonBenchmark or peer groupSector peers
Step 2: Apply Exclusion Screen (if applicable)

Common exclusion categories:

CategoryWhat Gets Excluded
TobaccoManufacturers (>10% revenue)
WeaponsControversial weapons (cluster munitions, landmines, nuclear)
Fossil fuelsCoal mining, oil sands, Arctic drilling
Adult entertainmentProducers (>5% revenue)
GamblingOperators (>10% revenue)
Private prisonsOperators and significant revenue from
Severe controversiesCompanies with unresolved severe ESG controversies
Step 3: ESG Scoring

Score each company across E, S, and G pillars. See references/esg-framework.md for detailed criteria.

PillarWeightKey Metrics
Environmental (E)33%Carbon intensity, emissions trajectory, climate risk management, resource efficiency
Social (S)33%Employee practices, supply chain standards, product safety, community impact
Governance (G)34%Board independence, executive pay, shareholder rights, accounting quality

Within each pillar, score on a 0–100 scale using both quantitative data and qualitative assessment.

Step 4: ESG Momentum

Assess whether ESG quality is improving or deteriorating:

SignalImprovingDeteriorating
Emissions trajectoryDeclining YoYIncreasing YoY
Controversy trendFewer/lower severityMore/higher severity
ESG disclosure qualityImproving, more metrics reportedStagnant or withdrawing
Target settingScience-Based Targets, net-zero commitmentsNo targets or missed targets
ESG rating changesUpgrades from major ratersDowngrades
Step 5: Controversy Check

Screen for active ESG controversies:

SeverityExamplesImpact
CriticalEnvironmental disasters, systematic fraudExclude or major negative score adjustment
HighSignificant labor violations, data breachesMajor negative adjustment
MediumRegulatory fines, product recallsModerate adjustment
LowMinor incidents, resolved issuesMinimal impact
Step 6: Financial Integration

Assess whether strong ESG correlates with financial quality:

MetricPurpose
ESG score vs ROEDoes ESG quality associate with profitability?
Controversy exposure vs volatilityDo controversies predict risk?
Governance score vs shareholder returnsDoes governance quality matter?
Carbon intensity vs cost structureIs carbon a financial risk?

Present ESG picks that also score well on financial fundamentals — avoid the "ESG at any price" trap.

Show full SKILL.md (209 more words)Show less
Step 7: Present Results

Format per references/output-template.md:

  1. Screening Criteria Summary — Approach, exclusions, parameters
  2. Top ESG Picks — Ranked with pillar scores and composite
  3. ESG Momentum Dashboard — Improving vs deteriorating companies
  4. Controversy Monitor — Active controversies for top picks
  5. Financial Integration — ESG quality vs financial quality comparison
  6. Sector ESG Landscape — Best and worst ESG companies by sector
  7. Individual Company Cards — Detailed ESG profile per company
  8. Disclaimers

Data Enhancement

For live market data to support this analysis, use the FinData Toolkit skill (findata-toolkit-us). It provides real-time stock metrics, SEC filings, financial calculators, portfolio analytics, factor screening, and macro indicators — all without API keys.

Important Guidelines

  • ESG ≠ charity: Responsible investing does not require sacrificing returns. Present ESG as a risk management and quality screening framework.
  • Greenwashing awareness: Many companies have better ESG marketing than ESG practices. Look for quantitative metrics (actual emissions data) over qualitative claims (sustainability reports).
  • Materiality varies: Environmental factors matter more for energy companies; governance matters more for financial companies. Weight pillars by sector materiality.
  • Data limitations: ESG data is inconsistent across providers. Disclose data sources and limitations.
  • Evolving standards: ESG frameworks are rapidly evolving. Note when standards or regulations may change.
  • Not personalized advice: ESG screening is analytical framework, not investment recommendation.

© Geeksfino, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in US-market/esg-screener of Geeksfino/finskills.

  • SKILL.md
  • LICENSE.txt
  • references/esg-framework.md
  • references/output-template.md

Open the folder on GitHubat commit 8722415

Compare with similar skills

ESG Stock Screener next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

ESG Stock Screener compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
ESG Stock Screener this skillGeeksfino/finskills282—~1.4kAutomated safety check: PassApache-2.0
AI-Trader Market IntelHKUDS/AI-Trader23k—~1.1kAutomated safety check: PassNone
Eastmoney Market DataHKUDS/Vibe-Trading35k—~1kAutomated safety check: PassMIT
Stock Deep Analysis Workflowwbh604/UZI-Skill7.1k—~9.1kAutomated safety check: NotesMIT
Zhengxi Fund Manager Views Librarylyra81604/zhengxi-views1.8k—~1.6kAutomated safety check: PassMIT
SEC EDGAR Filings FetcherHKUDS/Vibe-Trading35k—~1.4kAutomated safety check: PassMIT

Similar skills

  • AI-Trader Market Intel

    HKUDS/AI-Trader

    Reads AI-Trader's read-only market snapshots, grouped financial news and events board through its market-intel endpoints, for context before trading or posting.

    23k GitHub stars~1.1k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Eastmoney Market Data

    HKUDS/Vibe-Trading

    Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.

    35k GitHub stars~1k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Runs a staged deep analysis of a single stock on China A-share, Hong Kong and US markets, ending in an HTML report with valuation models and investor-panel scores.

    7.1k GitHub stars~9.1k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check: notes
  • Zhengxi Fund Manager Views Library

    lyra81604/zhengxi-views

    Answers questions with sourced quotes from one Chinese fund manager's public writings, applies his stated investment method and compares his words with real fund holdings.

    1.8k GitHub stars~1.6k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • SEC EDGAR Filings Fetcher

    HKUDS/Vibe-Trading

    Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.

    35k GitHub stars~1.4k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Scans a long-running industry trend for supply chain chokepoints, aiming to find second- and third-layer suppliers that the market has not yet priced in.

    17k GitHub stars~2.6k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed

More from Geeksfino/finskills

All 30 skills in this repo
  • US Market Data Toolkit

    Geeksfino/finskills

    Free Python scripts that fetch US stock data, SEC filings, insider trades and macro indicators, and run financial score calculators and portfolio analytics.

    282 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Runs a forensic review of one company's financial statements covering DuPont profitability, earnings quality, financial health scores and fraud-risk signals.

    282 GitHub stars~1.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Quantitative Factor Screener

    Geeksfino/finskills

    Screens a stock universe with a six-factor model, scores value, momentum, quality, low volatility, size and growth, ranks by composite score and notes which factors suit the macro regime.

    282 GitHub stars~1.3k tokensUpdated 7 mo ago
    Auto-check passed
  • Tech Hype vs Fundamentals

    Geeksfino/finskills

    Compares leading tech stocks to separate hype-driven valuations from fundamentally justified ones and to flag undervalued names the market overlooks.

    282 GitHub stars~1.3k tokensUpdated 7 mo ago
    Auto-check passed
  • Analyze Dividend Aristocrats (25+ years of consecutive dividend increases) for income reliability and total return.

    282 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Event Driven Detector

    Geeksfino/finskills

    Identify and analyze corporate events that create mispricing opportunities, including M&A, spinoffs, buybacks, restructurings, and index changes.

    282 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check passed

Questions about ESG Stock Screener

What does ESG Stock Screener do?

Screens US stocks through an ESG lens, applies optional exclusion lists, scores the environmental, social and governance pillars and judges whether ESG quality is improving. The agent acts as a sustainable investing analyst and starts by confirming the criteria with you: the universe (S&P 500 by default, or Russell 1000 or a custom list), the ESG approach (sector leaders by default, or exclusion, integration or thematic), the pillars in focus, the sector, any exclusions, how many companies to return (top 10 by default) and the comparison group.

When should I use ESG Stock Screener?

ESG Stock Screener fits situations like: screening a stock universe for ESG leaders and laggards; applying an exclusion list for sectors an investor wants to avoid; scoring a company or portfolio on environmental, social and governance criteria; checking whether a company's ESG record is improving.

How do I install ESG Stock Screener in Claude Code?

Run `npx skills add Geeksfino/finskills --skill esg-screener -a claude-code`. Or copy the skill folder (US-market/esg-screener in Geeksfino/finskills) into .claude/skills/esg-screener in your project. Claude Code loads it when a task matches its description.

How do I install ESG Stock Screener in Codex?

Run `npx skills add Geeksfino/finskills --skill esg-screener -a codex`. Or copy the skill folder (US-market/esg-screener in Geeksfino/finskills) into .agents/skills/esg-screener in your project. Codex loads it when a task matches its description.

Can I use ESG Stock Screener in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Geeksfino/finskills --skill esg-screener -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/esg-screener, .gemini/skills/esg-screener, .github/skills/esg-screener and .opencode/skills/esg-screener in your project.

What does ESG Stock Screener need to run?

SKILL.md names no scripts, command-line tools or credentials: ESG Stock Screener is instructions for the agent only.

Does ESG Stock Screener access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is ESG Stock Screener safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does ESG Stock Screener use?

ESG Stock Screener is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does ESG Stock Screener use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.6k tokens, read only when the agent opens those files.

What are the alternatives to ESG Stock Screener?

Skills that share tags, products or a category with ESG Stock Screener: AI-Trader Market Intel (HKUDS/AI-Trader, 23k stars), Eastmoney Market Data (HKUDS/Vibe-Trading, 35k stars), Stock Deep Analysis Workflow (wbh604/UZI-Skill, 7.1k stars) and Zhengxi Fund Manager Views Library (lyra81604/zhengxi-views, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains ESG Stock Screener?

Geeksfino (a GitHub user) maintains it in Geeksfino/finskills, which has 282 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on March 5, 2026.

Source: Geeksfino/finskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.