← Back to Skills Marketplace
finskills

value-dividend-screener

by finskills · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
85
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install value-dividend-screener
Description
Screen US equities for value and dividend quality using multi-factor scoring across P/E, P/B, dividend yield, and payout sustainability via the Finskills API.
Usage Guidance
This skill appears coherent and limited to calling finskills.net with your FINSKILLS_API_KEY to fetch financials and compute scores. Before installing: (1) Confirm the finskills.net service and the GitHub repo referenced in the SKILL.md/README are legitimate and match the registry entry (there are minor version/homepage mismatches). (2) Understand that screening the S&P 500 may trigger many API requests — check rate limits, costs, and whether you need a Pro plan for some endpoints. (3) Keep your FINSKILLS_API_KEY secret; the skill needs it to call the API but nothing in the files suggests it transmits it to other endpoints. (4) If you are uncomfortable with autonomous agent invocation, restrict the skill or disable autonomous invocation in your agent settings. If you want higher assurance, inspect the upstream GitHub repo (or contact the publisher) for any hidden code before adding any install that would pull and run external scripts.
Capability Analysis
Type: OpenClaw Skill Name: value-dividend-screener Version: 1.0.1 The Value & Dividend Screener skill is a legitimate financial analysis tool designed to score stocks based on fundamental data. It interacts exclusively with the Finskills API (finskills.net) to retrieve financial statements, dividend history, and market quotes. The instructions in SKILL.md are strictly focused on financial modeling and reporting, with no evidence of malicious intent, data exfiltration, or unauthorized system access.
Capability Tags
cryptocan-make-purchasesrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The name/description (value + dividend screener) match the runtime instructions (calls to finskills.net endpoints and multi-factor scoring). The only minor inconsistency is metadata/version/homepage discrepancies between registry (no homepage, version 1.0.1) and the SKILL.md/README (homepage GitHub, version 1.0.2), which may just be a packaging/metadata mismatch and not a functional problem.
Instruction Scope
SKILL.md confines actions to HTTP GET calls to finskills.net endpoints, computing derived financial ratios, scoring, and producing ranked output. It does not instruct reading local files, other env vars, or transmitting data to unrelated third parties. Note: full-screening the S&P500 will trigger many API calls — the doc explicitly warns about this and recommends pre-filters.
Install Mechanism
This is an instruction-only skill with no install spec or archived downloads, which is low risk. The README shows an example 'npx skills add https://github.com/finskills/value-dividend-screener' command pointing to a GitHub repo; since the package in the registry contains only SKILL.md and README, verify the referenced GitHub repo and its contents before running any install that pulls code.
Credentials
Only one required environment variable (FINSKILLS_API_KEY) is declared and used; this is proportional to a skill that calls the Finskills API. The README/SKILL.md note that some endpoints require a Pro plan — users should be aware that use may require a paid plan and/or incur rate limits or usage costs. Treat the API key as a secret.
Persistence & Privilege
always is false and the skill does not request persistent system privileges or access to other skills' configs. Model invocation is allowed (the platform default) — this is expected for a functional skill and not problematic by itself.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install value-dividend-screener
  3. After installation, invoke the skill by name or use /value-dividend-screener
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated skill metadata for improved environment variable handling and compatibility. - No changes to the screening logic, scoring methodology, or output format. - API usage and operational workflow remain unchanged.
v1.0.0
Initial release of the Value & Dividend Screener skill. - Enables screening of US equities for value and dividend quality using multi-factor scoring via the Finskills API. - Implements industry-standard value (P/E, P/B) and dividend (yield, payout, growth) criteria, plus financial health checks. - Provides a ranked and scored output with per-stock rationales, risk flags, and analyst estimate support. - Supports custom universes or default S&P 500 screening, with smart pre-filtering to optimize API usage. - Output includes a detailed summary table, highlighted pick, and screening summary for easy analysis.
Metadata
Slug value-dividend-screener
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is value-dividend-screener?

Screen US equities for value and dividend quality using multi-factor scoring across P/E, P/B, dividend yield, and payout sustainability via the Finskills API. It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.

How do I install value-dividend-screener?

Run "/install value-dividend-screener" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is value-dividend-screener free?

Yes, value-dividend-screener is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does value-dividend-screener support?

value-dividend-screener is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created value-dividend-screener?

It is built and maintained by finskills (@finskills); the current version is v1.0.1.

💬 Comments