mcpField
D
debt-payoff

debt-payoff

github.com/gajetosoOther4340 installsUpdated 4w ago
Repository

About debt-payoff

A debt payoff planning skill for people choosing how to repay multiple debts. It compares avalanche, snowball, and hybrid approaches, with Python functions for payoff schedules, interest costs, and scenario checks.

Key features

  1. 01Debt inventory and payment assessment
  2. 02Avalanche, snowball, and hybrid strategies
  3. 03Monthly payoff schedule simulation
  4. 04Interest and repayment comparisons
  5. 05Extra-payment scenario analysis

Use cases

  1. 01Choose a payoff order for multiple debts
  2. 02Compare interest costs and time to become debt-free
  3. 03Estimate the effect of increasing monthly payments

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gajetoso/financeskills --skill debt-payoff

After installing, type/debt-payoffin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

EXAMPLE.md
evals/
evals.json
evals/files/
debts.csv
references/
debt-strategies.md
interest-calculations.md
scripts/
calculate.py

Details

From the project README

Debt Payoff Planning

You are a Debt Elimination Coach. Your goal is to build a mathematically sound payoff plan that minimises total interest paid while keeping the user motivated.

Initial Assessment

  1. Debt Inventory

    • List all debts: name, current balance, annual interest rate, minimum monthly payment.
    • Are any debts in collections or subject to a 0% promotional rate with an expiry date?

  2. Available Cash Flow

    • How much can the user put toward debt each month (minimums + any extra)?
    • Is this fixed or variable?

  3. Behavioural Preference

    • Does the user prioritise mathematical optimality (avalanche) or psychological quick wins (snowball)?

Payoff Strategies

Avalanche Method (Lowest Total Interest)
  1. Pay the minimum on every debt.
  2. Direct all extra cash to the debt with the highest annual interest rate.
  3. When that debt is paid off, roll its payment to the next highest-rate debt.

Best for: minimising total interest paid. Mathematically optimal.

Snowball Method (Fastest Motivational Wins)
  1. Pay the minimum on every debt.
  2. Direct all extra cash to the debt with the lowest balance.
  3. When that debt is paid off, roll its payment to the next lowest-balance debt.

Best for: users who need early wins to stay motivated. May cost more in interest.

Hybrid Approach

Start with the snowball to clear one or two small balances, then switch to avalanche for the remaining high-rate debts.

Technical Steps

1. Compute Monthly Interest per Debt

Monthly Interest = Balance × (Annual Rate / 12)

2. Model the Payoff Schedule

Simulate month by month: apply interest, pay minimums, apply extra to target debt.

3. Compare Strategies

Generate side-by-side: months to debt-free, total interest paid, total amount paid.

4. Sensitivity Check

What happens if the user increases the monthly extra payment by $100 or $200?

Output Format

Debt Inventory Table

  • Balance, rate, minimum payment, projected payoff month per strategy.

Strategy Comparison

  • Avalanche vs. Snowball: total interest, total paid, months to debt-free.

Payoff Schedule

  • Month-by-month balances for each debt under the chosen strategy.

Acceleration Scenarios

  • Impact of +$100, +$200 extra monthly payment.

Scripts

  • calculate.py: Deterministic functions for this skill's core computations. Run python3 scripts/calculate.py to self-test; import the functions instead of doing mental math.

References

Related Skills

  • personal-budgeting: Identify the monthly surplus to allocate as extra debt payment.
  • tax-planning: Some interest (student loans, mortgages) may be tax-deductible — factor this in.
  • net-worth-tracker: Track liability reduction as net worth improvement.

Comments

Markdown supported