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.
87%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
This skill identifies high-quality dividend stocks that combine value characteristics, attractive income generation, and consistent growth using a two-stage screening approach:
Screen US equities based on quantitative criteria including valuation ratios, dividend metrics, financial health, and profitability. Generate comprehensive reports ranking stocks by composite quality scores with detailed fundamental analysis.
Efficiency Advantage: Using FINVIZ pre-screening can reduce FMP API calls by 90% and keeps API usage low. The stock-screener endpoint used by FMP-only mode is not on the free plan (2026-11); use --use-finviz or a plan that includes it (see docs/en/getting-started.md#fmp-plans).
Invoke this skill when the user requests:
FMP_API_KEY or pass --fmp-api-key. The stock-screener endpoint is not on the free plan (2026-11); use --use-finviz or an FMP plan that includes it (see docs/en/getting-started.md#fmp-plans).FINVIZ_API_KEY or pass --finviz-api-key and use --use-finviz for two-stage screening. Without it the screener runs FMP-only and uses more API calls.requests>=2.31.0 (see requirements.txt).RSI screening needs at least 20 returned closing-price observations. Every close
in that history must be numeric, finite and positive. A candidate with missing
or invalid closes is skipped with RSI unavailable on stderr; valid candidates
continue. The full chronology and raw-close price basis are preserved. This
exclusion means the candidate could not be evaluated, not that it passed or
failed the oversold test.
For Two-Stage Screening (Recommended):
Check if both API keys are available:
import os
fmp_api_key = os.environ.get('FMP_API_KEY')
finviz_api_key = os.environ.get('FINVIZ_API_KEY')If not available, ask user to provide API keys or set environment variables:
export FMP_API_KEY=your_fmp_key_here
export FINVIZ_API_KEY=your_finviz_key_hereFor FMP-Only Screening:
Check if FMP API key is available:
import os
api_key = os.environ.get('FMP_API_KEY')If not available, ask user to provide API key or set environment variable:
export FMP_API_KEY=your_key_hereFINVIZ Elite API Key:
Provide instructions from references/fmp_api_guide.md if needed.
Run the screening script with appropriate parameters:
Uses FINVIZ for pre-screening, then FMP for detailed analysis:
Default execution (Top 20 stocks):
python3 scripts/screen_dividend_stocks.py --use-finvizWith explicit API keys:
python3 scripts/screen_dividend_stocks.py --use-finviz \
--fmp-api-key $FMP_API_KEY \
--finviz-api-key $FINVIZ_API_KEYCustom top N:
python3 scripts/screen_dividend_stocks.py --use-finviz --top 50Custom output location:
python3 scripts/screen_dividend_stocks.py --use-finviz --output /path/to/results.jsonScript behavior (Two-Stage):
Expected runtime (Two-Stage): 2-3 minutes for 30-50 FINVIZ candidates (much faster than FMP-only)
Uses only FMP Stock Screener API (higher API usage):
Default execution:
python3 scripts/screen_dividend_stocks.pyWith explicit API key:
python3 scripts/screen_dividend_stocks.py --fmp-api-key $FMP_API_KEYScript behavior (FMP-Only):
Expected runtime (FMP-Only): 5-15 minutes for 100-300 candidates (rate limiting applies)
API Usage Comparison:
Read the generated JSON file:
import json
with open('dividend_screener_results.json', 'r') as f:
data = json.load(f)
metadata = data['metadata']
stocks = data['stocks']Key data points per stock:
symbol, company_name, sector, market_cap, pricedividend_yield, pe_ratio, pb_ratiodividend_cagr_3y, revenue_cagr_3y, eps_cagr_3ypayout_ratio, fcf_payout_ratio, fcf_amount, fcf_status, fcf_coverage_status, sustainability_basis, dividend_sustainable, sustainability_bonus, sustainability_notedebt_to_equity, current_ratio, financially_healthyroe, profit_margin, quality_scorecomposite_scoreCreate structured markdown report for user with following sections:
Read references/report_template.md for the full markdown report template.
In the human report, keep observed FCF and dividend coverage separate. Negative FCF means an observed shortfall; zero FCF means no cash coverage; MISSING_DATA means the source fields were unavailable. None proves a future dividend cut. AT_LIMIT means FCF equals dividends with no buffer and earns no bonus. For confirmed REITs, use FFO as the decision basis and show FCF status as context even when it is negative; do not apply FFO treatment to a company solely because its sector is Real Estate. Copy sustainability_note into the explanation rather than replacing an unknown status with a sustainability claim.
Reference screening methodology when explaining results:
Key concepts to explain:
Load references/screening_methodology.md to provide detailed explanations of:
Read references/follow_up_questions.md for answers to common follow-up questions.
Read references/resource_descriptions.md for the description of the screening script and of each reference file.
Read references/advanced_usage.md to customize criteria, screen a sector, exclude REITs and financials or export CSV.
The script prints this error to stderr and exits with status 2. The message includes the full path of this skill's requirements.txt, so the hint works from any directory.
Solution: Install the skill's dependencies
pip install -r skills/value-dividend-screener/requirements.txtSolution: Set environment variable or provide via command-line
export FMP_API_KEY=your_key_here
# OR
python3 scripts/screen_dividend_stocks.py --fmp-api-key your_key_hereSolution: Set environment variable or provide via command-line
export FINVIZ_API_KEY=your_key_here
# OR
python3 scripts/screen_dividend_stocks.py --use-finviz --finviz-api-key your_key_hereNote: FINVIZ Elite subscription required (~$40/month or ~$330/year)
Possible causes:
Solution:
Possible causes:
Solution:
python3 scripts/screen_dividend_stocks.pySolution: Script automatically retries after 60 seconds. If persistent:
Solution: Criteria may be too restrictive
Expected behavior: Script includes 0.3s delay between API calls for rate limiting
Read references/performance_and_cost.md for API call comparison and cost analysis.
FMP data access uses the bundled generated scripts/fmp_client.py. Existing CLI
key/environment precedence, financial calculations and successful output shapes
are preserved. The migrated paths use stable endpoints only; a denied or failed
stable request does not fall back to retired v3 URLs. The shared client masks raw
and URL-encoded key echoes, retries malformed JSON once, and retries a 429 once
with a 60-second wait before stopping on a repeated rate limit. FINVIZ, where
used, remains a separate client.
tradermonty/claude-trading-skills
a627d17
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.