Provide frameworks for managing and paying off personal debt effectively. Use when the user asks about debt payoff strategies (avalanche vs snowball), refinancing decisions, debt consolidation, debt-to-income ratios, or the opportunity cost of paying off debt vs investing. Also trigger when users mention 'which debt to pay first', 'should I refinance', 'credit card debt', 'student loan payoff', 'DTI for mortgage', 'balance transfer', 'good debt vs bad debt', or ask how to get out of debt faster.
8k tokens
context cost
the whole folder, loaded on every use
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
161
stars on the repo
on the repository, not the skill itself
Install
one command, takes just this skill from the repository
Back-end DTI (total debt ratio): All monthly debt payments (housing + car + student loans + credit cards + other) / gross monthly income
Guideline: < 36% (conventional), up to 43% (FHA), some lenders allow up to 50% for qualified borrowers
DTI is a key factor in mortgage qualification and overall financial health assessment
Refinancing Analysis
Compare the total cost of the existing loan vs the new loan, accounting for closing costs:
Monthly savings: Old payment - new payment
Breakeven months: Total closing costs / monthly savings
Total cost comparison: Sum of all remaining payments (old) vs sum of all payments (new) + closing costs
If you plan to keep the loan beyond the breakeven point, refinancing saves money
Consider: remaining term, resetting the amortization clock, and cash-out implications
Debt Consolidation
Combine multiple debts into a single loan, ideally at a lower interest rate:
Potential benefits: Lower rate, single payment, simplified management
Risks: Longer term may increase total interest even at lower rate; freed-up credit lines may tempt new borrowing
Evaluate: Compare total interest paid (all debts independently) vs total interest paid (consolidated loan)
Balance transfer cards (0% intro rate) can be effective but require payoff before the rate expires
Good Debt vs Bad Debt
Good debt: Low interest rate, potentially tax-deductible, finances an appreciating asset or increases earning power (mortgage, student loans, business loans)
Bad debt: High interest rate, finances depreciating assets or consumption (credit cards, payday loans, auto loans on luxury vehicles)
The line is not absolute — a low-rate auto loan for a reliable commuter car can be reasonable
Opportunity Cost Analysis
When debt carries a low interest rate, paying it off aggressively may not be optimal:
Decision rule: If expected after-tax investment return > after-tax debt interest rate, investing the extra cash may build more wealth
Example: 3.5% mortgage (2.5% after tax deduction) vs 7-10% expected equity returns — investing likely wins mathematically
Caveats: Investment returns are uncertain, debt payoff is guaranteed; psychological benefit of being debt-free has real value
Pay minimums on all ($375/mo). Extra $500 goes to credit card ($600/mo total to CC).
Credit card ($5K at 22%, $600/mo): paid off in month 10, ~$476 interest.
Freed payment rolls to the personal loan ($75 + $600 = $675/mo to PL): paid off in month 14, ~$408 interest.
All payments roll to the student loan ($200 + $675 = $875/mo): paid off in month 26, ~$1,062 interest (the 6% loan accrues interest on its full $12K balance throughout the earlier phases, not just at the end).
Extra $500 goes to personal loan ($575/mo total to PL).
Personal loan ($3K at 15%, $575/mo): paid off in month 6, ~$123 interest.
Freed payment rolls to the credit card ($100 + $575 = $675/mo): paid off in month 14, ~$911 interest.
All payments roll to the student loan: paid off in month 26, ~$1,071 interest.
Total: 26 months, ~$2,104 total interest.
Comparison: Avalanche saves ~$158 in interest; both finish in 26 months. The difference is modest because the highest-rate debt is not the largest. Snowball gives a quicker first win (month 6 vs month 10 to first payoff) — for many people that motivational difference is worth $158.
Example 2: Refinance breakeven
Given: Current mortgage: $300K remaining, 6.5%, 25 years left, payment $2,028/mo. New offer: 5.5%, 25 years, closing costs $6,000, payment $1,838/mo.
Calculate: Breakeven period and total interest savings.
Total interest savings: $308,400 - $257,400 = $51,000.
Common Pitfalls
Ignoring psychological factors — snowball works better for many people despite costing slightly more in interest
Not including all closing costs in refinancing analysis (origination fees, appraisal, title insurance, points)
Consolidation at a lower rate but longer term may cost more in total interest — always compare total cost
Paying off low-rate debt instead of investing (opportunity cost) without considering risk tolerance and guaranteed vs uncertain returns
Not considering tax deductibility of mortgage or student loan interest when comparing effective rates
Making only minimum payments on high-interest debt while saving in low-yield accounts
Consolidation freeing up credit lines that lead to new debt accumulation
Ignoring the amortization reset: refinancing to a new 30-year term extends the payoff date
Cross-References
lending (wealth-management plugin): mortgage analysis, loan terms, and amortization calculations
emergency-fund (wealth-management plugin): adequate emergency fund prevents taking on new high-interest debt during crises
savings-goals (wealth-management plugin): debt payoff competes with savings goals for cash flow allocation
tax-efficiency (wealth-management plugin): tax deductibility of certain debt interest affects optimal payoff order
liquidity-management (wealth-management plugin): debt payments are fixed obligations in cash flow planning
financial-planning-workflow (advisory-practice plugin): debt payoff strategies are evaluated during the cash flow and recommendation phases of financial planning
insurance-planning (wealth-management plugin): outstanding debt balances are a direct input to life insurance needs analysis
Running the Script
uv run scripts/debt_management.py # run the demo (uses PEP 723 inline deps)
uv run scripts/debt_management.py --verify # check demo outputs against the worked examples (exit 1 on mismatch)
python3 scripts/debt_management.py # alternative (requires: pip install numpy)
The demo prints the calculations covered above; its values match the worked examples in this skill. Run --help for a list of the classes and functions. For programmatic use, import the module rather than running it — the demo only executes under python debt_management.py.
How to use it
Copy the folder
Take joellewis/debt-management from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
Check the name does not clash
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
Install what it needs
The instructions reference pip.
Without those the skill loads but fails at the first command.