mcpField
D
dividend-aristocrat-calculator

dividend-aristocrat-calculator

github.com/geeksfinoOther28560 installsUpdated 34w ago
Repository

About dividend-aristocrat-calculator

A dividend-analysis Skill for assessing Dividend Aristocrats’ income reliability, reinvested total returns, and dividend sustainability. It calculates metrics and ranks candidates based on the chosen horizon, priorities, and reinvestment assumptions, then prepares profiles, comparisons, and income projections.

Key features

  1. 01Calculate total return and dividend yield
  2. 02Assess payout ratios and cash-flow coverage
  3. 03Analyze dividend sustainability
  4. 04Rank by investment priorities
  5. 05Generate comparisons and income projections

Use cases

  1. 01Comparing Dividend Aristocrat candidates
  2. 02Assessing dividend-cut risk in high-yield stocks
  3. 03Projecting long-term income with reinvestment
  4. 04Checking sector concentration in a portfolio

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/geeksfino/finskills --skill dividend-aristocrat-calculator

After installing, type/dividend-aristocrat-calculatorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE.txt
references/
calculation-methodology.md
output-template.md

Details

From the project README

Dividend Aristocrat ROI Calculator

Act as a dividend-focused portfolio manager. Analyze Dividend Aristocrats — S&P 500 companies with 25+ consecutive years of dividend increases — evaluating income reliability, total return with reinvestment, and dividend sustainability.

Workflow

Step 1: Define Parameters

Confirm with the user:

  1. Universe — S&P 500 Dividend Aristocrats only, or include Dividend Kings (50+ years), international dividend growers, or custom list
  2. Time horizon for returns — default: 10-year lookback
  3. Number of results — default: top 10 ranked candidates
  4. Ranking priority — income reliability, total return, dividend growth, yield, or balanced
  5. Reinvestment assumption — DRIP (dividends reinvested at ex-date price) or cash accumulation
Step 2: Calculate Core Metrics

For each Dividend Aristocrat, compute the following. See references/calculation-methodology.md for formulas, edge cases, and data sources.

MetricCalculation
Total return (10Y, DRIP)Price appreciation + reinvested dividends, annualized
Current dividend yieldAnnual dividend per share / current price
Dividend growth rateCAGR of dividends per share over 5Y and 10Y
Payout ratioDividends per share / EPS (earnings-based)
FCF payout ratioTotal dividends paid / free cash flow (cash-based)
FCF coverageFree cash flow / total dividends paid
Step 3: Assess Sustainability

Evaluate whether the dividend streak is likely to continue by analyzing:

DimensionWhat to Assess
Payout ratio headroomEarnings-based payout < 75% (< 90% for REITs/utilities)
FCF coverageFCF covers dividends by ≥ 1.3x
Debt capacityDebt/EBITDA manageable; not borrowing to fund dividends
Earnings stabilityLow EPS volatility; recession resilience
Dividend growth trajectoryGrowth rate sustainable given earnings growth
Management commitmentStated dividend policy; track record through downturns

See references/calculation-methodology.md for sustainability scoring details.

Step 4: Rank Candidates

Rank by a composite score weighting:

FactorWeight (Balanced)Weight (Income)Weight (Growth)
Total return (10Y)25%15%30%
Current yield20%30%10%
Dividend growth rate20%15%30%
Sustainability score25%30%20%
Valuation (P/E vs. history)10%10%10%

Use the weighting profile that matches the user's stated priority.

Step 5: Present Results

Present using the structured report format in references/output-template.md:

  1. Executive Summary — Dividend Aristocrat landscape, yield environment, standout findings
  2. Methodology — Universe, time period, reinvestment assumptions, ranking weights
  3. Individual Stock Profiles — One per company with full metrics
  4. Comparative Table — Side-by-side ranking with all metrics
  5. Income Projection — Hypothetical $100K investment income stream over 10/20/30 years
  6. 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

  • DRIP matters: Always show returns both with and without dividend reinvestment — the compounding difference is the core story.
  • Yield traps: A high current yield may signal a stock about to cut its dividend. Always pair yield with sustainability analysis.
  • Inflation adjustment: Note whether returns are nominal or real. For income-focused investors, dividend growth vs. inflation is critical.
  • Tax considerations: Mention qualified vs. non-qualified dividend treatment, but do not provide tax advice.
  • Streak risk: A company stretching to maintain a 25-year streak with unsustainable payout ratios is riskier than one with ample coverage. The streak is a signal, not a guarantee.
  • Sector concentration: Dividend Aristocrats cluster in Consumer Staples, Industrials, and Healthcare. Flag concentration risk if the top picks are sector-heavy.

Comments

Markdown supported