CtrlK
BlogDocsLog inGet started
Tessl Logo

value-dividend-screener

Screen US stocks for high-quality dividend opportunities combining value characteristics (P/E ratio under 20, P/B ratio under 2), attractive yields (3% or higher), and consistent growth (dividend/revenue/EPS trending up over 3 years). Supports two-stage screening using FINVIZ Elite API for efficient pre-filtering followed by FMP API for detailed analysis. Use when user requests dividend stock screening, income portfolio ideas, or quality value stocks with strong fundamentals.

62

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/value-dividend-screener/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill body delivers a clear, well-sequenced two-stage workflow with real executable commands and strong troubleshooting feedback loops, and its references are valid one-level-deep files. Its weaknesses are repetition (cost/API analysis and methodology summaries appear twice), inlining of content that belongs in the reference files, and customization guidance whose line numbers and parameter values do not match the actual script.

Suggestions

Fix the customization guidance to match the actual script: the screen_stocks call is at line ~1052 (not 383-388), the dividend CAGR check at ~1139 (not 423), and the script uses dividend_yield_min=3.0 and a 4.0% CAGR threshold (not 3.5/5.0) — prefer referencing function/parameter names over line numbers so the guidance survives edits.

De-duplicate the API-usage and cost content: Step 2's "API Usage Comparison" and the "Performance & Cost Optimization" section cover the same ground; keep one and cut the other.

Move the ~90-line markdown report template to a reference file (e.g., references/report_template.md) and the Phase 1-3 methodology details to a pointer into references/screening_methodology.md, keeping only the section skeleton and load instructions inline.

DimensionReasoningScore

Conciseness

The ~560-line body is mostly operational but noticeably padded: the API-usage/cost analysis appears twice ("API Usage Comparison" in Step 2 and the "Performance & Cost Optimization" section), the Phase 1-3 methodology bullets duplicate references/screening_methodology.md content in both Step 5 and Resources, and the full ~90-line markdown report template is inlined. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than the efficient anchors at 4-5.

3 / 5

Actionability

Script invocation commands and flags (e.g., "python3 scripts/screen_dividend_stocks.py --use-finviz --top 50") are concrete and copy-paste ready, but the customization guidance is inaccurate: the cited "Line 383-388" for screen_stocks is actually at line 1052, "Line 423" for the dividend CAGR check is at line 1139, and the documented parameters (dividend_yield_min=3.5, div CAGR < 5.0) contradict the actual script (3.0 and 4.0). Per the rubric's instruction to evaluate what is written, these incorrect key details land at 'Some concrete guidance but incomplete; missing key details', not the mostly-executable anchor at 4.

3 / 5

Workflow Clarity

The six-step workflow is clearly sequenced with an upfront API-key verification checkpoint, and the Troubleshooting section provides genuine feedback loops for this batch operation (automatic rate-limit retry, "Try FMP-only method as fallback", criteria-relaxation steps), so the batch-operation cap at 3 does not apply. It is not a 5 because intermediate result validation (e.g., checking the JSON output parsed correctly or the stock count is plausible before report generation) is left implicit.

4 / 5

Progressive Disclosure

The bundle structure is sound — references/fmp_api_guide.md, references/screening_methodology.md, and scripts/screen_dividend_stocks.py all exist and are referenced one level deep — but substantial content that belongs in those files is inlined in SKILL.md: the full report template, the detailed cost analysis, and per-phase methodology summaries that duplicate screening_methodology.md. This matches 'Some structure but could be better organized... content that should be separate is inline' rather than the well-placed-content anchor at 4.

3 / 5

Total

13

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, quantified criteria, explicit two-stage method, and a clear 'Use when' clause with concrete triggers. The only gap is modest synonym coverage (e.g., high-yield, income investing, dividend growth) in the trigger phrasing.

DimensionReasoningScore

Specificity

The description states concrete capabilities with quantified criteria — "Screen US stocks", "P/E ratio under 20, P/B ratio under 2", "yields (3% or higher)", "dividend/revenue/EPS trending up over 3 years", plus the two-stage "pre-filtering followed by FMP API for detailed analysis". It comprehensively covers what the skill does without padding, matching the anchor 'Lists multiple specific concrete actions; comprehensive coverage'.

5 / 5

Completeness

It explicitly answers both questions: the 'what' (screening with specific valuation, yield, and growth criteria via FINVIZ/FMP) and the 'when' ("Use when user requests dividend stock screening, income portfolio ideas, or quality value stocks with strong fundamentals") with concrete trigger phrases, matching the top anchor exactly. Not a 4 because the 'when' clause is explicit and lists multiple concrete triggers rather than being merely serviceable.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "dividend stock screening", "income portfolio ideas", "quality value stocks with strong fundamentals" — which users would plausibly say. Common synonyms like "high-yield stocks", "dividend growth", "income investing", or "dividend picks" are missing, so it falls just short of the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (US dividend value screening with named FINVIZ Elite/FMP APIs and specific thresholds) with triggers unlikely to fire for unrelated skills. It clearly matches 'Clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (563 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
tradermonty/claude-trading-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.