Lending logo

Lending

Community
JoelLewis
lending

Analyze lending products including mortgages, HELOCs, and personal loans with amortization and comparison tools. Use when the user asks about mortgage comparison, fixed vs ARM rates, loan qualification, amortization schedules, extra payments, or buying points. Also trigger when users mention 'monthly payment calculation', '15-year vs 30-year mortgage', 'PMI', 'APR vs interest rate', 'HELOC', 'home equity', 'should I buy down the rate', 'biweekly payments', or ask how much house they can afford.

Overview

PublisherJoelLewis
Repositoryfinance_skills
Skill namelending
Stars
217
Forks
37
Bundled files
1
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 1 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by JoelLewis on GitHub. Read the source before you install it.

Installation

Install the Lending AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/JoelLewis/finance_skills/tree/main/plugins/wealth-management/skills/lending
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/JoelLewis/finance_skills.git /tmp/finance_skills
mkdir -p .claude/skills
cp -r /tmp/finance_skills/plugins/wealth-management/skills/lending .claude/skills/lending
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Lending in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Lending on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Lending is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Lending Analysis

Core Concepts

Fixed-Rate Mortgage

The interest rate and monthly payment remain constant for the life of the loan:

  • Advantages: Predictable payments, protection against rising rates, simpler budgeting
  • Disadvantages: Higher initial rate than ARM, no benefit if rates decline (must refinance)
  • Most common terms: 30-year and 15-year fixed

Adjustable-Rate Mortgage (ARM)

Rate is fixed for an initial period, then adjusts periodically based on an index plus a margin:

  • Notation: 5/1 ARM = fixed for 5 years, adjusts annually thereafter; 7/1, 10/1 similarly
  • Fully indexed rate: Index (e.g., SOFR, 1-year Treasury) + margin (e.g., 2.75%)
  • Rate caps protect against extreme adjustments:
    • Initial adjustment cap (e.g., 2%): maximum first adjustment
    • Periodic cap (e.g., 2%): maximum change per adjustment period
    • Lifetime cap (e.g., 5%): maximum total increase over initial rate
  • When ARM may be appropriate: Planning to sell or refinance before the fixed period ends, expecting rates to decline, or comfortable with rate variability

Monthly Payment Calculation

The standard amortization formula for a fixed-rate loan:

  • PMT = P × [r(1+r)^n] / [(1+r)^n - 1]
  • Where: P = principal (loan amount), r = monthly interest rate (annual rate / 12), n = total number of payments (term in months)
  • Each payment splits into interest (decreasing) and principal (increasing) components:
    • Interest portion: remaining balance × monthly rate
    • Principal portion: PMT - interest portion

Total Interest Paid

  • Total interest = (n × PMT) - P
  • For a $400K, 30-year loan at 6.5%: PMT = $2,528, total payments = $910,178, total interest = $510,178

Extra Payments

Additional principal payments reduce the outstanding balance, shorten the loan term, and reduce total interest:

  • Each extra dollar goes entirely to principal reduction
  • Impact compounds: earlier extra payments save more interest than later ones
  • Methods: lump sum, fixed monthly extra, biweekly payments (26 half-payments = 13 full payments per year)

Mortgage Points

Prepaid interest that reduces the loan's interest rate:

  • 1 point = 1% of the loan amount (e.g., 1 point on $400K = $4,000)
  • Typically reduces the rate by approximately 0.25% (varies by lender and market)
  • Breakeven calculation: Points cost / monthly savings = months to recoup
  • Points make sense when: planning to hold the loan beyond breakeven, itemizing deductions (points may be tax-deductible in year of purchase)

APR vs Interest Rate

  • Interest rate: The cost of borrowing the principal, expressed annually
  • APR (Annual Percentage Rate): Includes the interest rate plus certain fees and costs (origination fees, points, PMI), annualized over the loan term
  • APR > interest rate (always, when there are fees)
  • APR is the better metric for comparing loan offers with different fee structures

HELOC (Home Equity Line of Credit)

A revolving credit line secured by home equity:

  • Combined LTV (CLTV): (First mortgage balance + HELOC limit) / home value
    • Most lenders require CLTV ≤ 80-90%
  • Draw period (typically 10 years): borrow and repay flexibly, often interest-only payments
  • Repayment period (typically 20 years): no new draws, fully amortizing payments
  • Variable rate: Typically prime rate + margin; rate fluctuates with market
  • Use cases: Home improvements, debt consolidation, emergency backup (but not as primary emergency fund)
  • Risk: Home is collateral — default means foreclosure

Loan Qualification Criteria

  • FICO score: 620+ for conventional, 580+ for FHA, 700+ for best rates
  • DTI: Front-end ≤ 28%, back-end ≤ 36-43% (varies by program)
  • LTV (Loan-to-Value): Loan amount / property value; lower LTV = lower risk = better terms
  • Reserves: Months of payments held in liquid assets after closing (2-6 months typical)
  • Employment/income: Stable income history, typically 2 years documentation

PMI (Private Mortgage Insurance)

Required when conventional loan LTV exceeds 80%:

  • Cost: 0.5-1.5% of loan amount annually, added to monthly payment
  • Removal: Automatic at 78% LTV (based on original amortization), requestable at 80% LTV
  • Avoidance strategies: 20% down payment, piggyback loan (80/10/10), lender-paid PMI (higher rate), VA loan (no PMI)
  • PMI benefits the lender, not the borrower — it is pure cost to the borrower

15-Year vs 30-Year Comparison

  • 15-year: Higher monthly payment, lower interest rate (typically 0.5-0.75% less), dramatically less total interest, builds equity faster
  • 30-year: Lower required payment, more flexibility, higher total interest cost
  • Hybrid approach: Take a 30-year for flexibility, make extra payments as if it were a 15-year

Key Formulas

FormulaExpressionUse Case
Monthly paymentPMT = P × [r(1+r)^n] / [(1+r)^n - 1]Fixed-rate loan payment
Total interestn × PMT - PTotal cost of borrowing
Remaining balance after k paymentsB_k = P × [(1+r)^n - (1+r)^k] / [(1+r)^n - 1]Balance at any point
Points breakevenCost of points / monthly savingsMonths to recoup points
LTVLoan amount / property valueRisk and PMI assessment
CLTV(First mortgage + HELOC) / home valueCombined leverage
ARM fully indexed rateIndex + marginRate after fixed period

Worked Examples

Example 1: 30-year vs 15-year mortgage comparison

Given: Home price $500K, down payment $100K, loan amount $400K. 30-year rate: 6.5%. 15-year rate: 5.9%. Calculate: Monthly payments, total interest, and interest savings. Solution:

  1. 30-year monthly payment: PMT = $400,000 × [0.005417 × (1.005417)^360] / [(1.005417)^360 - 1]
    • r = 6.5%/12 = 0.005417, n = 360
    • PMT = $2,528/month
  2. 30-year total interest: 360 × $2,528 - $400,000 = $510,178
  3. 15-year monthly payment: PMT = $400,000 × [0.004917 × (1.004917)^180] / [(1.004917)^180 - 1]
    • r = 5.9%/12 = 0.004917, n = 180
    • PMT = $3,354/month
  4. 15-year total interest: 180 × $3,354 - $400,000 = $203,694
  5. Payment difference: $3,354 - $2,528 = $826/month more for 15-year.
  6. Interest savings: $510,178 - $203,694 = $306,484 saved by choosing 15-year.
  7. The 15-year costs 33% more per month but saves 60% in total interest.

Example 2: Extra payment impact

Given: $300K 30-year mortgage at 6.5% (payment = $1,896.20/month). Borrower adds $200/month extra to principal, making the total payment $2,096.20/month. Calculate: Time saved and interest saved. Solution:

  1. Without extra payments: 360 months, total interest = 360 × $1,896.20 - $300,000 = $382,633.
  2. New term (closed-form estimate): n = -ln(1 - P × r / PMT_total) / ln(1+r) with r = 0.065/12 = 0.005417:
    • n = -ln(1 - $300,000 × 0.005417 / $2,096.20) / ln(1.005417) ≈ 276.3 payments.
  3. Exact amortization (month-by-month simulation, final payment partial): payoff in 277 months = 23 years 1 month (~23.1 years), total interest = $279,185. The closed form and the exact schedule agree closely.
  4. Interest saved: $382,633 - $279,185 = $103,449.
  5. Time saved: 360 - 277 = 83 months ≈ 6.9 years.
  6. Total extra principal paid ≈ 276 × $200 = $55,200. Interest saved per dollar of extra payment: $103,449 / $55,200 ≈ $1.87.

Common Pitfalls

  • Comparing interest rate instead of APR — APR captures fees and gives a truer cost comparison
  • ARM teaser rates creating payment shock when the fixed period ends and rates adjust upward
  • Points breakeven: buying points is not worth it if selling or refinancing before the breakeven point
  • HELOC variable rate risk during rising rate environments — budget for rate increases
  • PMI costs making high-LTV loans more expensive than they appear — factor PMI into total monthly cost
  • Ignoring opportunity cost: extra mortgage payments at 3-4% vs investing at 7-10% expected return
  • Not shopping multiple lenders — rate quotes can vary 0.5%+ for the same borrower
  • Resetting to a 30-year term when refinancing — extends total payoff even if rate is lower
  • Ignoring closing costs in refinancing decisions (see debt-management refinance breakeven)

Cross-References

  • debt-management (wealth-management plugin): refinancing analysis, debt payoff vs investing decisions, DTI calculations
  • emergency-fund (wealth-management plugin): adequate reserves required for loan qualification and financial safety
  • tax-efficiency (wealth-management plugin): mortgage interest deductibility, points deduction
  • savings-goals (wealth-management plugin): down payment saving is a common goal-based savings target
  • liquidity-management (wealth-management plugin): mortgage payments are the largest fixed obligation in most household cash flow plans

Running the script

Run the reference implementation directly:

uv run scripts/lending.py          # PEP 723 header resolves dependencies automatically
python3 scripts/lending.py         # after: pip install numpy scipy

A bare run prints a demo covering payment calculation, extra-payment impact, LTV/PMI, DSCR, balloon payments, refinance analysis, points breakeven, and ARM resets. Use --verify to recompute the demo figures and assert they match this skill's worked examples (prints PASS/FAIL, exits nonzero on mismatch), and --help to list the available classes and functions. The file is primarily meant to be imported as a module (from lending import LendingAnalysis) rather than run standalone.

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Lending AI skill do?

Analyze lending products including mortgages, HELOCs, and personal loans with amortization and comparison tools. Use when the user asks about mortgage comparison, fixed vs ARM rates, loan qualification, amortization schedules, extra payments, or buying points. Also trigger when users mention 'monthly payment calculation', '15-year vs 30-year mortgage', 'PMI', 'APR vs interest rate', 'HELOC', 'home equity', 'should I buy down the rate', 'biweekly payments', or ask how much house they can afford.

Why use Lending on TypingMind?

Because you install it once and use it with any model. Lending is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Lending in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/JoelLewis/finance_skills/tree/main/plugins/wealth-management/skills/lending. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Lending?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Lending?

As many as you like. As long as a model supports skills, you can use Lending with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Lending AI skill free?

Yes. It is published on GitHub by JoelLewis under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇