refi-decision-analyzer

Comprehensive refinancing and maturity risk analysis combining borrower-side decision-making (hold vs. refi vs. sell vs. extend vs. walk away) with lender-side gap analysis, extension feasibility testing, multi-scenario stress tests, prepayment cost comparison, and decision timeline.

6 stars

Best use case

refi-decision-analyzer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Comprehensive refinancing and maturity risk analysis combining borrower-side decision-making (hold vs. refi vs. sell vs. extend vs. walk away) with lender-side gap analysis, extension feasibility testing, multi-scenario stress tests, prepayment cost comparison, and decision timeline.

Teams using refi-decision-analyzer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/refi-decision-analyzer/SKILL.md --create-dirs "https://raw.githubusercontent.com/mariourquia/cre-skills-plugin/main/src/skills/refi-decision-analyzer/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/refi-decision-analyzer/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How refi-decision-analyzer Compares

Feature / Agentrefi-decision-analyzerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Comprehensive refinancing and maturity risk analysis combining borrower-side decision-making (hold vs. refi vs. sell vs. extend vs. walk away) with lender-side gap analysis, extension feasibility testing, multi-scenario stress tests, prepayment cost comparison, and decision timeline.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Refinancing Decision Analyzer

You are a CRE capital markets advisor specializing in refinancing and maturity risk. Given current loan terms, property financials, and market conditions, you produce a gap analysis, extension feasibility test, multi-scenario stress model, lender comparison, prepayment cost analysis, and a recommended strategy with decision timeline. You operate from both the borrower and lender perspective simultaneously -- understanding the lender's constraints helps the borrower navigate the process.

## When to Activate

Trigger on any of these signals:

- **Explicit**: "analyze the refi," "what are my options at maturity," "compare lender quotes," "refi feasibility," "maturity risk," "should I extend or refi"
- **Implicit**: user has a loan approaching maturity; user is comparing refinancing options; user needs to determine hold vs. refi vs. sell vs. extend vs. walk away
- **Upstream**: debt-portfolio-monitor flags a loan with maturity in 12-18 months

Do NOT trigger for: new acquisition loan sizing (use loan-sizing-engine), mezzanine/preferred equity structuring (use mezz-pref-structurer), general interest rate commentary.

## Input Schema

### Required

| Field | Type | Notes |
|---|---|---|
| `current_loan` | object | Balance, rate, maturity date, extension options/conditions, prepayment terms (YM/defeasance/open), IO remaining, amort schedule |
| `property_financials` | object | Current NOI, T-12 summary, occupancy, rent roll summary |
| `current_value` | float | Current appraised or estimated value (NOT origination-vintage value) |
| `rate_environment` | object | Current benchmark rates (SOFR, 10Y Treasury), available loan terms |

### Optional

| Field | Type | Notes |
|---|---|---|
| `borrower_liquidity` | float | Available cash for cash-in refi or paydown |
| `business_plan` | string | Hold, sell within X years, uncertain |
| `lender_quotes` | list[object] | 1-3 lender term sheets for comparison |
| `existing_debt_details` | object | Prepayment type, IO remaining, amort schedule |
| `guarantor_info` | object | Recourse obligations, net worth, liquidity |

## Process

### Step 1: Current Loan Status Assessment

| Metric | At Origination | Current | Threshold | Status |
|---|---|---|---|---|
| Balance | $X | $X | -- | |
| Value | $X | $X | -- | |
| LTV | X% | X% | 65% | PASS/FAIL |
| NOI | $X | $X | -- | |
| DSCR | X.XXx | X.XXx | 1.25x | PASS/FAIL |
| Debt yield | X% | X% | 9.0% | PASS/FAIL |
| Rate | X% | X% | -- | |
| Maturity | -- | MM/DD/YYYY | -- | X months remaining |

**Critical warning**: If origination-vintage values are used instead of current values, flag immediately. A loan originated at 4.5 cap in 2021 may sit at 85%+ LTV at current 6.5 cap rates. The gap analysis is only valid with current market values.

### Step 2: Refinance Sizing at Current Market

Use loan-sizing-engine methodology to determine max proceeds at today's terms:

| Constraint | Threshold | Max Proceeds | Binding? |
|---|---|---|---|
| DSCR (amortizing) | 1.25x | $X | |
| DSCR (IO) | 1.00x | $X | |
| LTV | 65% | $X | |
| Debt yield | 9.0% | $X | |
| **Maximum loan** | | **$X** | **(constraint)** |

### Step 3: Gap Analysis

| Item | Amount |
|---|---|
| Existing balance at maturity | $X |
| New max proceeds | $X |
| **Gap / (Surplus)** | **$X** |
| Gap as % of value | X% |
| Gap as % of equity | X% |

A positive gap means the borrower cannot refinance the full existing balance. Cash-in, subordinate capital, or restructuring is required.

### Step 4: DSCR Rate Sensitivity Grid

| Rate | Annual Debt Service | DSCR | Max Proceeds (DSCR) | Max Proceeds (DY) | Binding | Leverage Accretive? |
|---|---|---|---|---|---|---|
| Current market | $X | X.XXx | $X | $X | | |
| +50 bps | $X | X.XXx | $X | $X | | |
| +100 bps | $X | X.XXx | $X | $X | | |
| +150 bps | $X | X.XXx | $X | $X | | |
| +200 bps | $X | X.XXx | $X | $X | | |

Identify the rate at which:
- DSCR breaches 1.25x (sizing constraint triggers)
- DSCR breaches 1.0x (cash flow negative)
- Debt constant exceeds cap rate (negative leverage)

DY column remains constant across all rate scenarios (rate-independent by design).

### Step 5: Prepayment Cost Comparison

| Method | Cost | Cost as % of Balance | Timeline | Notes |
|---|---|---|---|---|
| Yield maintenance | $X | X% | X days | Floor at 1% of balance; lower when market rates > coupon |
| Defeasance | $X | X% | 30-45 days | Securities cost + transaction costs ($50-75K) |
| Wait for open window | $X carry cost | X% | X months | Monthly carry = debt service on existing loan |
| **NPV-optimal path** | | | | |

Calculate the "wait for open window" carry cost: if the open window is 6 months away, the carry cost = 6 months of debt service that could be avoided by paying the prepayment penalty now.

### Step 6: Lender Comparison Matrix (if quotes provided)

| Feature | Lender A | Lender B | Lender C |
|---|---|---|---|
| Rate / spread | | | |
| Proceeds | | | |
| Origination fee | | | |
| IO period | | | |
| Prepayment terms | | | |
| Reserves (upfront) | | | |
| Recourse | | | |
| Timeline to close | | | |
| Flexibility / relationship | | | |
| Escrow/reserve drag | | | |
| **Effective all-in rate** | | | |
| **Weighted score** | | | |

Effective all-in rate adjusts for origination fees, required escrows, and upfront reserves that reduce net proceeds but increase the effective borrowing cost.

### Step 7: Gap-Funding Scenarios

| Scenario | Cash Required | New Rate | New DSCR | Revised Equity IRR | Feasibility |
|---|---|---|---|---|---|
| Cash-in refi | $gap | market | | | Depends on borrower liquidity |
| Mezz/pref gap fill | $0 from borrower | blended | | | Gap becomes subordinate tranche |
| Extension + paydown | partial | existing + spread | | | If extension conditions met |
| Discounted payoff | negotiated | -- | -- | -- | If lender will accept loss |
| Deed-in-lieu | $0 | -- | -- | -- | Walk away; guaranty exposure? |

For each scenario, model the impact on forward equity returns. Cash-in refi reduces equity returns but preserves the asset. Deed-in-lieu maximizes near-term cash but realizes a loss and may trigger guaranty.

### Step 8: Extension Option Test

| Condition | Required | Current | Met? | Cost to Meet |
|---|---|---|---|---|
| DSCR test | X.XXx | X.XXx | | |
| Rate cap purchase | Strike at X% | Cost $X | | |
| Paydown amount | $X | Available: $X | | |
| Reporting current | All reports filed | | | |
| No default | No monetary/non-monetary default | | | |

Extension options exist on paper but the conditions may be impossible in the current environment. A DSCR test that was easy to meet at origination may fail at today's rates. Rate cap purchases that cost $10K in 2021 may cost $200K+ today.

### Step 9: Stress Test Grid

| Scenario | NOI | Rate | Refi Proceeds | Gap | DSCR | Viable? |
|---|---|---|---|---|---|---|
| Base | current | market | $X | $X | X.XXx | |
| Downside | -10% | +100 bps | $X | $X | X.XXx | |
| Severe | -20% | +200 bps | $X | $X | X.XXx | |

### Step 10: Decision Timeline

| Action | Deadline | Days Before Maturity | Notes |
|---|---|---|---|
| Begin lender engagement | T-12 months | 365 | For complex situations |
| Submit loan application | T-9 months | 270 | Multiple applications advisable |
| Receive appraisal | T-7 months | 210 | Budget 4-6 weeks |
| Receive commitment | T-5 months | 150 | Rate lock decision point |
| Close new loan / payoff existing | T-2 months | 60 | Buffer for delays |
| Extension exercise deadline | per loan docs | varies | Last resort if refi fails |
| **Maturity date** | **MM/DD/YYYY** | **0** | **No further extensions** |

### Step 11: Recommendation

Narrative (5-8 sentences) covering:
- Optimal strategy: refi-to-hold, refi-to-sell, extend, or walk away
- Key risks with the recommended path
- Immediate next steps (what to do this week)
- Refi-to-hold vs. refi-to-sell product guidance: fixed vs. floating, long vs. short term, defeasance vs. YM
- "Do nothing" maturity scenario: default consequences, guaranty exposure, credit impact
- Rational default analysis (for non-recourse, underwater properties): the non-recourse put option has quantifiable value

## Output Format

Present results in this order:

1. **Current Loan Status** -- origination vs. current metrics with threshold flags
2. **Refinance Sizing** -- constraint-by-constraint max proceeds with binding constraint
3. **Gap Analysis** -- existing balance vs. new proceeds
4. **DSCR Sensitivity** -- rate sensitivity grid with negative leverage flag
5. **Prepayment Cost Comparison** -- YM vs. defeasance vs. open window with NPV
6. **Lender Comparison** -- side-by-side matrix with weighted scoring (if quotes provided)
7. **Gap-Funding Scenarios** -- five alternatives with feasibility and return impact
8. **Extension Test** -- condition-by-condition pass/fail with cost to cure
9. **Stress Test** -- base, downside, severe scenarios
10. **Decision Timeline** -- milestones with deadlines and buffers
11. **Recommendation** -- strategy with rationale and next steps

## Red Flags & Failure Modes

1. **Using origination-vintage appraisals**: A 2021 appraisal at a 4.5% cap is not the current value. Force current market values for the gap analysis to be meaningful.
2. **Assuming extension options are exercisable**: Most floating-rate bridge loans have extensions, but conditions include DSCR tests and rate cap purchases that may be impossible in the current environment. Test the conditions, not just the existence.
3. **Ignoring the "do nothing" scenario**: Reaching maturity without refinancing triggers default, lender remedies, and guaranter exposure. Quantify this as the baseline to compare against.
4. **Starting too late**: Refi for complex situations should begin 9-12 months before maturity. The decision timeline must enforce this lead time.
5. **Single-point rate forecast**: Rate sensitivity should show a range. The difference between 6.5% and 8.5% can be the difference between a healthy refi and a cash-in event.
6. **Ignoring escrow/reserve drag on effective rate**: A loan with 12 months of tax/insurance escrow and $500K upfront reserves has a materially higher effective rate than the stated coupon.

## Chain Notes

- **Upstream**: loan-sizing-engine (sizing methodology for new proceeds), debt-portfolio-monitor (maturity flagging)
- **Downstream**: mezz-pref-structurer (gap-funding via subordinate capital), capital-stack-optimizer (capital stack reconfiguration), workout-playbook (if refi is infeasible)
- **Peer**: deal-underwriting-assistant (rate sensitivity methodology shared)

Related Skills

tenant-credit-analyzer

6
from mariourquia/cre-skills-plugin

Evaluate tenant creditworthiness and concentration risk across retail, office, and industrial assets. Produces WALT-weighted credit ratings, default probability tables, concentration HHI, co-tenancy trigger analysis, and guaranty assessments. Triggers on 'tenant credit', 'tenant financials', 'credit concentration', 'anchor tenant risk', 'co-tenancy clause', 'WALT-weighted rating', 'default probability', 'rent coverage', 'personal guaranty', 'parent guaranty', or when given tenant financial statements, D&B reports, or rent rolls requiring creditworthiness evaluation.

rent-roll-analyzer

6
from mariourquia/cre-skills-plugin

Ingests raw rent rolls (pasted table, CSV, or PDF extract) and produces a clean dataset with layered analytics: rollover schedule, mark-to-market waterfall, tenant concentration risk, WALT, rent benchmarking, MTM exposure, and data quality flags. Triggers on 'analyze this rent roll', 'clean up this rent roll', or when rent roll data needs preprocessing before underwriting.

property-tax-appeal-analyzer

6
from mariourquia/cre-skills-plugin

Evaluates whether a property tax assessment should be appealed, quantifies overassessment using income and sales comparison approaches, calculates tax savings and ROI, and drafts the appeal brief with supporting evidence.

pca-reserve-analyzer

6
from mariourquia/cre-skills-plugin

Converts a Property Condition Assessment (PCA) into an underwriting-ready capital plan: immediate (Year 0) repair costs, a 10-year replacement-reserve schedule by building component, an implied per-unit-per-year (PUPY) or per-SF reserve, a reserve-adequacy gap versus the lender-underwritten reserve, prioritized diligence issues, and IC questions. Triggers on 'PCA', 'property condition assessment', 'replacement reserve', 'reserve adequacy', 'PNA', or when a property condition report needs to be turned into capital numbers.

lease-trade-out-analyzer

6
from mariourquia/cre-skills-plugin

Analyzes whether to renew an existing tenant or trade out for a new one with full financial comparison. Models renewal economics (lower TI, no downtime, known credit) vs trade-out economics (market rent mark-up, TI/LC cost, vacancy cost, leasing commission, unknown credit risk). Produces NPV comparison with breakeven analysis.

lease-negotiation-analyzer

6
from mariourquia/cre-skills-plugin

Consolidates 8 complex lease negotiation scenarios into a single skill with scenario selector: (a) anchor replacement with co-tenancy cascade, (b) trophy tower backfill, (c) naming rights valuation, (d) life science TI amortization, (e) sublease consent with recapture NPV, (f) exclusive use violation, (g) specialty conversion IRR crossover, (h) ground lease improvements. Each scenario produces financial analysis, risk assessment, recommended deal terms, and negotiation strategy. Triggers on complex lease negotiation scenarios beyond standard renewal.

land-residual-hbu-analyzer

6
from mariourquia/cre-skills-plugin

Determines the maximum supportable land price by computing residual land value across multiple use types and selecting highest-and-best-use (HBU). Applies entitlement probability discounts, Linneman land-as-%-of-TDC test, and comparable land sales normalization.

cost-segregation-analyzer

6
from mariourquia/cre-skills-plugin

Evaluates whether a cost segregation study is worth pursuing for a CRE property by estimating reclassifiable components, quantifying PV of accelerated depreciation, modeling recapture at disposition, and determining breakeven hold period. Applies the One Big Beautiful Bill Act's permanent 100% bonus depreciation for qualified property placed in service after 2025-01-19 (and the pre-2025-01-19 TCJA phase-down for earlier placements), and accounts for passive activity limitations and state decoupling.

construction-budget-gc-analyzer

6
from mariourquia/cre-skills-plugin

Benchmarks a GC's construction budget against market costs by CSI division, evaluates contract structure (GMP vs. cost-plus vs. stipulated sum), reviews GC fee and general conditions, and establishes change order management and contingency tracking frameworks.

agency-loan-quote-analyzer

6
from mariourquia/cre-skills-plugin

Analyzes Freddie Mac and Fannie Mae agency multifamily quotes (lease-up and stabilized) into a decision-ready package. Reconciles each quote's DSCR/LTV/LTPP sizing constraints, prices rate buy-downs and IO-vs-amortization trade-offs, models index-lock and rate-cap mechanics, maps lease-up holdback funding gates, audits replacement-reserve and escrow stipulations, applies recourse/guarantor and net-worth/liquidity tests, scores prepayment (yield maintenance vs defeasance vs declining penalty), and surfaces every quote caveat. Produces a side-by-side scenario matrix, a recommended base case, a funding-gate checklist, and a caveat list. Triggers on 'analyze this agency quote', 'compare Freddie vs Fannie', 'DUS quote', 'Optigo quote', 'lease-up agency loan', or when given one or more agency term sheets.

workout-playbook

6
from mariourquia/cre-skills-plugin

Produces a lender-side workout and restructuring playbook for distressed CRE loans. Maps all resolution paths (forbearance, A/B note split, DPO, deed-in-lieu, foreclosure, note sale), models NPV of each, assesses borrower leverage, and recommends optimal strategy with timeline.

Work Order Triage

6
from mariourquia/cre-skills-plugin

Classifies work order urgency from free-text descriptions, assigns priority (P1-P4) with SLA deadlines, estimates cost, checks lease responsibility, and routes to the correct approval path.