Agent skill

Debt Management

by JoelLewis in JoelLewis/finance_skills

Provide frameworks for managing and paying off personal debt effectively.

MITAuto-check passedBusiness, Finance & HR

Install Debt Management

skills CLI
$ npx skills add JoelLewis/finance_skills --skill debt-management -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JoelLewis/finance_skills debt-management --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JoelLewis/finance_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/wealth-management/skills/debt-management .claude/skills/debt-management && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debt-management
GitHub stars
206
Token cost
~2.5k tokens
SKILL.md length
1,252 words
Files
2 (incl. scripts)
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Provide frameworks for managing and paying off personal debt effectively.

  • Works in 5 steps: Pay minimums on all ($375/mo). Extra… → Credit card ($5K at 22%, $600/mo): paid… → Freed payment rolls to the personal loan… → …
  • The user asks about debt payoff strategies (avalanche vs snowball)
  • SKILL.md covers Core Concepts, Key Formulas, Worked Examples and Common Pitfalls, plus 2 more sections
  • Runs Python scripts from its folder; calls uv, python3 and python

What it does

Debt Management is an agent skill from JoelLewis/finance_skills. 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.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/debt_management.py`).

It sits in Business, Finance & HR, covering Real estate. The repository describes itself as: Claude Code skill plugins for financial services — 81 skills across 7 domain plugins covering investment management, compliance, advisory practice, trading, and operations. The licence is MIT.

When your agent uses it

  • The user asks about debt payoff strategies (avalanche vs snowball)
  • Refinancing decisions
  • Debt consolidation
  • Debt-to-income ratios

Example prompts

  • “which debt to pay first”
  • “should I refinance”
  • “credit card debt”
  • “/debt-management”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Pay minimums on all ($375/mo). Extra $500 goes to credit card ($600/mo total to CC).
  2. Credit card ($5K at 22%, $600/mo): paid off in month 10, ~$476 interest.
  3. Freed payment rolls to the personal loan ($75 + $600 = $675/mo to PL): paid off in month 14, ~$408 interest.
  4. 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…
  5. Total: 26 months, ~$1,946 total interest.

What it can do on your machine

Read from SKILL.md and the folder at commit 5c498ea. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • python3
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Debt Management loads about 2.5k tokens when it runs. Until then it costs about 129 tokens; SKILL.md has 1,252 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~129
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from JoelLewis/finance_skills at commit 5c498ea, republished under its MIT licence (© JoelLewis). 1,252 words, ~2,492 tokens.

Download SKILL.mdSave it as .claude/skills/debt-management/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
debt-management
description
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.

Debt Management

Core Concepts

Debt Avalanche

Pay minimum payments on all debts, then direct all extra payment to the debt with the highest interest rate first:

  • Mathematically optimal: Minimizes total interest paid over the life of all debts
  • Once the highest-rate debt is paid off, the freed-up payment rolls to the next highest rate
  • Requires discipline — the highest-rate debt may also be the largest balance, meaning slow visible progress initially
  • Always saves money compared to snowball, though the difference varies by debt profile
Debt Snowball

Pay minimum payments on all debts, then direct all extra payment to the debt with the smallest balance first:

  • Psychologically effective: Quick wins build momentum and motivation
  • Research (Kellogg School) shows people are more likely to stick with snowball and actually become debt-free
  • May cost more in total interest than avalanche, but adherence is higher
  • Best for individuals who need motivational wins to stay committed
Debt-to-Income Ratio (DTI)

Total monthly debt payments expressed as a percentage of gross monthly income:

  • Front-end DTI (housing ratio): Monthly housing costs (PITI: principal, interest, taxes, insurance) / gross monthly income
    • Guideline: < 28%
  • 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
  • Consider risk tolerance: guaranteed 3.5% return (debt payoff) vs variable 7-10% (investing)
Debt Payoff Timeline

Amortization calculation with extra payments:

  • Standard amortization: n = -ln(1 - (P×r)/PMT) / ln(1+r)
  • With extra payment: replace PMT with PMT + extra, recalculate n
  • Total interest = (n × PMT) - P (adjusting for extra payments)

Key Formulas

FormulaExpressionUse Case
Front-end DTIHousing payments / gross monthly incomeMortgage qualification
Back-end DTIAll debt payments / gross monthly incomeOverall debt health
Refinance breakevenClosing costs / monthly savingsMonths to recoup refi costs
Months to payoffn = -ln(1 - Pr/PMT) / ln(1+r)Debt payoff timeline
Total interest paid(n × PMT) - PrincipalCost of borrowing
Effective rate (after tax)r × (1 - marginal_tax_rate)Tax-deductible debt comparison

Worked Examples

Show full SKILL.md (635 more words)Show less
Example 1: Avalanche vs snowball comparison

Given: Three debts with $500/month available for extra payments (above minimums):

  • Credit card: $5,000 balance, 22% APR, $100 minimum
  • Student loan: $12,000 balance, 6% APR, $200 minimum
  • Personal loan: $3,000 balance, 15% APR, $75 minimum

Calculate: Order of payoff, total months, and total interest for each strategy (month-by-month simulation; see scripts/debt_management.py). Solution — Avalanche (highest rate first: 22% → 15% → 6%):

  1. Pay minimums on all ($375/mo). Extra $500 goes to credit card ($600/mo total to CC).
  2. Credit card ($5K at 22%, $600/mo): paid off in month 10, ~$476 interest.
  3. Freed payment rolls to the personal loan ($75 + $600 = $675/mo to PL): paid off in month 14, ~$408 interest.
  4. 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).
  5. Total: 26 months, ~$1,946 total interest.

Solution — Snowball (smallest balance first: $3K → $5K → $12K):

  1. Extra $500 goes to personal loan ($575/mo total to PL).
  2. Personal loan ($3K at 15%, $575/mo): paid off in month 6, ~$123 interest.
  3. Freed payment rolls to the credit card ($100 + $575 = $675/mo): paid off in month 14, ~$911 interest.
  4. All payments roll to the student loan: paid off in month 26, ~$1,071 interest.
  5. 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. Solution:

  1. Monthly savings: $2,028 - $1,838 = $190/month.
  2. Breakeven: $6,000 / $190 = 31.6 months ≈ 32 months (2 years 8 months).
  3. If staying in the home beyond 32 months, refinancing saves money.
  4. Total payments (old): 25 × 12 × $2,028 = $608,400 → total interest = $608,400 - $300,000 = $308,400.
  5. Total payments (new): 25 × 12 × $1,838 + $6,000 = $557,400 → total interest = $557,400 - $300,000 = $257,400.
  6. 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

bash
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.

© JoelLewis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in plugins/wealth-management/skills/debt-management of JoelLewis/finance_skills.

  • SKILL.md
  • scripts/debt_management.py

Open the folder on GitHubat commit 5c498ea

Compare with similar skills

Debt Management next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debt Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debt Management this skillJoelLewis/finance_skills206—~2.5kAutomated safety check: PassMIT
Thue Tncn Vietnamdotanminh/thue-tncn-vietnam241—~2.8kAutomated safety check: PassNone
Apartment Finderhanzili/hanzi-browse177—~2.1kAutomated safety check: PassCustom licence
Realestate Commercialzubair-trabzada/ai-realestate-claude179—~3.2kAutomated safety check: PassMIT
Vet PRetewiah/awesome-real-estate375—~1.5kAutomated safety check: PassCC0-1.0
Realestate Comparezubair-trabzada/ai-realestate-claude179—~3.7kAutomated safety check: PassMIT

Similar skills

  • Thue Tncn Vietnam

    dotanminh/thue-tncn-vietnam

    A skill your agent uses when user asks about Vietnamese personal income tax (TNCN), tax finalization (quyet toan), dependent deductions (giam tru gia canh), freelancer/KOL/online seller tax, eTax…

    241 GitHub stars~2.8k tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check passed
  • Apartment Finder

    hanzili/hanzi-browse

    Search for apartments across multiple real estate platforms, compare listings side by side, and help submit inquiries or applications.

    177 GitHub stars~2.1k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Realestate Commercial

    zubair-trabzada/ai-realestate-claude

    Commercial Property Analysis — NOI, cap rate, expense ratio, tenant mix, vacancy, debt coverage, replacement cost, and lease analysis with Commercial Score (0-100)

    179 GitHub stars~3.2k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Vet PR

    etewiah/awesome-real-estate

    Rigorous checklist for triaging PRs on the awesome-real-estate list.

    375 GitHub stars~1.5k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Realestate Compare

    zubair-trabzada/ai-realestate-claude

    Side-by-Side Property Comparison — takes two addresses and compares across price, specs, rental income, neighborhood, and investment potential with a winner per category and overall recommendation

    179 GitHub stars~3.7k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Taichung Land Parcel Query

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when an architect receives just an address or lot number (地號) for a site in Taichung City, Taiwan, and needs the land's basic data — zoning, registered land area, land…

    158 GitHub stars~1.9k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed

More from JoelLewis/finance_skills

All 91 skills in this repo
  • Asset Allocation

    JoelLewis/finance_skills

    Determine how to distribute capital across asset classes using strategic and tactical allocation frameworks.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Bet Sizing

    JoelLewis/finance_skills

    Determine how much capital to allocate to individual positions within a portfolio.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Commodities

    JoelLewis/finance_skills

    Analyze commodity markets including futures curve dynamics, roll yield, and supply/demand fundamentals.

    206 GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Currencies And Fx

    JoelLewis/finance_skills

    Analyze currency markets, exchange rate mechanics, and FX risk management for international portfolios.

    206 GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Diversification

    JoelLewis/finance_skills

    Build diversified portfolios using correlation analysis, efficient frontier construction, and factor-based diversification.

    206 GitHub stars~2.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Emergency Fund

    JoelLewis/finance_skills

    Size and structure an emergency fund based on individual circumstances, income stability, and expense profile.

    206 GitHub stars~2.7k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Debt Management

What does Debt Management do?

Provide frameworks for managing and paying off personal debt effectively. Debt Management is an agent skill from JoelLewis/finance_skills. Provide frameworks for managing and paying off personal debt effectively.

When should I use Debt Management?

Debt Management fits situations like: the user asks about debt payoff strategies (avalanche vs snowball); refinancing decisions; debt consolidation; debt-to-income ratios.

How do I install Debt Management in Claude Code?

Run `npx skills add JoelLewis/finance_skills --skill debt-management -a claude-code`. Or copy the skill folder (plugins/wealth-management/skills/debt-management in JoelLewis/finance_skills) into .claude/skills/debt-management in your project. Claude Code loads it when a task matches its description.

How do I install Debt Management in Codex?

Run `npx skills add JoelLewis/finance_skills --skill debt-management -a codex`. Or copy the skill folder (plugins/wealth-management/skills/debt-management in JoelLewis/finance_skills) into .agents/skills/debt-management in your project. Codex loads it when a task matches its description.

Can I use Debt Management in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JoelLewis/finance_skills --skill debt-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debt-management, .gemini/skills/debt-management, .github/skills/debt-management and .opencode/skills/debt-management in your project.

What does Debt Management need to run?

Going by SKILL.md and its folder, Debt Management needs Python for the scripts in its folder and the command-line tools its instructions call (uv, python3 and python). Our summary lists: Python 3.

Does Debt Management access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Debt Management safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Debt Management use?

Debt Management is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Debt Management use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Debt Management?

Skills that share tags, products or a category with Debt Management: Thue Tncn Vietnam (dotanminh/thue-tncn-vietnam, 241 stars), Apartment Finder (hanzili/hanzi-browse, 177 stars), Realestate Commercial (zubair-trabzada/ai-realestate-claude, 179 stars) and Vet PR (etewiah/awesome-real-estate, 375 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debt Management?

JoelLewis (a GitHub user) maintains it in JoelLewis/finance_skills, which has 206 GitHub stars. The repository holds 91 skills in this directory. The repository was last updated on July 18, 2026.

Source: JoelLewis/finance_skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.