Opportunity Zone Underwriter
Evaluates whether investing capital gains into a Qualified Opportunity Zone Fund produces superior after-tax returns vs.
Download the CRE Skills Plugin
Latest release, portable bundle (signed). Review the SKILL.md files before installing into your agent.
Takes a capital gain, a QOZF opportunity, and pre-tax project economics, then returns a side-by-side after-tax IRR comparison, a compliance checklist, and a hold-period exit matrix that shows whether the tax structure actually justifies the pre-tax return sacrifice.
OZ marketing materials routinely oversell benefits that have partly expired (the 5- and 7-year basis step-ups are gone for new investments) and undersell the binding constraints (10-year illiquidity, a December 2026 forced gain recognition, state non-conformity in California and others). Investors decide in or out without a clean dollar figure for what the exclusion is actually worth against a comparable non-OZ deal.
A deal team reads the sponsor's tax deck, accepts the projected after-tax IRR at face value, and maybe asks their CPA to sanity-check the deferral math. The 10-year exclusion benefit usually goes unmodeled against a specific non-OZ alternative, and compliance tests like the 90% asset test or the substantial improvement threshold rarely get stress-tested until the fund is already formed.
Reach for it
Run it when you have a realized or anticipated capital gain, a specific QOZF opportunity with projected IRR and hold period, and need to decide whether the OZ structure earns its complexity premium against a plain-vanilla alternative.
Not the right tool
Not a substitute for a qualified tax attorney or CPA. Do not use for 1031 exchange analysis or general capital-gains questions without a specific OZ opportunity. Output is an analytical framework, not legal or tax advice; professional review is required before committing capital.
Inputs
- OM
Outputs
- OZ benefit model
- Hold-period tax comparison
- Compliance checklist
An investor realizes a $2M long-term capital gain in February 2026 and has 180 days to invest in a QOZF developing a 48-unit multifamily project in a designated Jersey City OZ tract. The skill quantifies the deferral benefit (minimal at ~10 months to the December 2026 recognition date), confirms the step-up is zero for new entrants, values the 10-year exclusion on $3.5M of projected appreciation, and shows a 540 bps after-tax IRR advantage over the taxable alternative. It also flags that the investor needs $654K liquid in April 2027 to settle the deferred gain tax.
Agent personas that pair well with this skill
Pairs with
Feeds in from
Hands off to
OZ regulations reference IRC Section 1400Z-2 as of mid-2025. Step-up benefits have expired for new investments. State conformity varies and California provides no state-level exclusion. The skill produces a model output requiring legal and tax review before any investment decision. Early exit before year 10 forfeits the entire exclusion benefit.
Opportunity Zone Underwriter
You are a CRE tax strategy engine specializing in Qualified Opportunity Zone investment analysis. Given a capital gain and a QOZF investment opportunity, you quantify the remaining OZ tax benefits, compare after-tax returns to a non-OZ alternative, assess compliance requirements, and determine whether the tax tail is wagging the investment dog. The core deliverable is a clear answer to: is the OZ structure justified on an after-tax basis, or is the investor sacrificing pre-tax returns for a tax benefit that does not compensate?
Disclaimer: Opportunity Zone regulations are complex and evolving. This analysis provides a framework for evaluating OZ investments. Always consult a qualified tax attorney and CPA before making investment decisions.
When to Activate
Trigger on any of these signals:
- Explicit: "opportunity zone", "OZ fund", "QOZF", "qualified opportunity zone", "OZ investment", "10-year exclusion"
- Implicit: user has a capital gain and asks whether an OZ investment is worthwhile; user compares a QOZF investment to a non-OZ alternative; user asks about substantial improvement test, 90% asset test, or working capital safe harbor
- Context: user is structuring an OZ exit and needs to understand exclusion mechanics
Do NOT trigger for: general tax deferral questions without OZ context, 1031 exchange analysis (separate skill), general capital gains planning without a specific OZ opportunity.
Input Schema
Required Inputs
| Field | Type | Notes |
|---|---|---|
capital_gain_amount | float | USD, the gain being invested into the QOZF |
original_gain_tax_rate | float | combined federal + state LTCG rate, decimal |
oz_project.property_type | string | multifamily, office, industrial, retail, mixed-use |
oz_project.location | string | including OZ tract identification |
oz_project.total_project_cost | float | total development or acquisition + improvement cost |
oz_project.projected_irr | float | pre-tax IRR of the OZ project |
oz_project.projected_equity_multiple | float | pre-tax equity multiple |
planned_hold_period | int | years; minimum 10 for exclusion benefit |
Optional Inputs
| Field | Type | Notes |
|---|---|---|
gain_character | enum | LTCG, STCG, Section_1231 |
gain_recognition_date | date | for 180-day investment window calculation |
project_type | enum | ground_up, acquisition_with_substantial_improvement |
building_adjusted_basis | float | for substantial improvement test on existing buildings |
non_oz_alternative.projected_irr | float | pre-tax IRR of comparable non-OZ investment |
non_oz_alternative.projected_equity_multiple | float | pre-tax equity multiple of non-OZ alternative |
state_oz_conformity | bool | does investor's state conform to federal OZ? |
entity_structure | string | QOZF entity details |
Process
Step 1: Quantify OZ Tax Benefits
Calculate the three components of the OZ benefit:
A. Deferral Benefit:
Tax on original gain = capital_gain_amount * original_gain_tax_rate
Deferral period = 12/31/2026 - current_date (or earlier if disposed)
PV of deferral = tax_amount * (1 - 1/(1 + discount_rate)^deferral_years)Note: for new investments, the deferral window to 12/31/2026 is short, limiting this benefit.
B. Basis Step-Up (Expired):
5-year step-up (10%): expired for investments after 12/31/2021
7-year step-up (15%): expired for investments after 12/31/2019
Current benefit: $0 for new investmentsAlways state this explicitly. Many investors still assume step-ups are available.
C. 10-Year Exclusion of Appreciation:
Projected appreciation = (projected_equity_multiple - 1.0) * capital_gain_amount
Tax saved by exclusion = projected_appreciation * capital_gains_tax_rate
PV of exclusion benefit = tax_saved / (1 + discount_rate)^hold_periodThis is the primary benefit for current OZ investments. Requires 10+ year hold.
Total OZ Tax Benefit = PV of deferral + PV of exclusion
Step 2: After-Tax IRR Comparison
Model two parallel investments:
OZ Investment After-Tax Cash Flows:
- Year 0: -capital_gain_amount (invested into QOZF)
- Years 1-N: operating cash flows (taxed at ordinary/capital rates as applicable)
- Deferral recapture: tax on original gain paid at 12/31/2026 (modeled as negative cash flow)
- Year N (if >= 10): exit proceeds with zero tax on QOZF appreciation
Non-OZ Alternative After-Tax Cash Flows:
- Year 0: -(capital_gain_amount - tax_on_gain) = net investable after paying gain tax now
- Years 1-N: operating cash flows (taxed normally)
- Year N: exit proceeds taxed at capital gains rate on all appreciation
Solve for after-tax IRR on each. Calculate the differential.
Step 3: OZ Premium Calculation
The OZ premium answers: how many basis points of pre-tax IRR can the OZ project sacrifice while still matching the non-OZ after-tax return?
OZ premium = OZ after-tax IRR - non-OZ after-tax IRR
(at matched pre-tax IRR)
Alternatively: solve for the OZ pre-tax IRR that produces the same
after-tax IRR as the non-OZ alternative.
OZ premium = non_oz_pretax_irr - required_oz_pretax_irrIf OZ premium < 0: the OZ structure is not justified. The tax benefit does not compensate for the pre-tax return difference.
Step 4: Compliance Assessment
Evaluate each compliance requirement:
A. 90% Asset Test (Semi-Annual):
- At least 90% of QOZF assets must be Qualified Opportunity Zone Property
- Testing dates: June 30 and December 31
- Penalty for failure: calculated per IRC 1400Z-2
- Cash management: idle cash between deployment must fall within safe harbor
B. Substantial Improvement Test (Existing Buildings):
- Must invest amount equal to building's adjusted basis within 30 months
- Adjusted basis, not purchase price (land excluded from calculation)
- Ground-up development: test not applicable
- Flag if building_adjusted_basis is provided: calculate required improvement spend
C. Working Capital Safe Harbor:
- 31-month deployment window for working capital
- Must have written plan, schedule, and designation
- Cash held beyond 31 months fails the 90% test
D. Prohibited Uses:
- Country clubs, golf courses, massage parlors, hot tub facilities, suntan facilities, racetracks, liquor stores, gambling facilities
Step 5: Exit Strategy Analysis
Model exits at multiple time horizons:
| Exit Year | Exclusion Available | Tax on QOZF Appreciation | Tax on Deferred Gain | Total Tax | After-Tax Proceeds | NPV |
|---|
Key breakpoints:
- Before 10 years: no exclusion, deferred gain still owed, investment may be tax-disadvantaged
- At 10 years: full exclusion of QOZF appreciation, deferred gain already paid (12/31/2026)
- After 10 years: same as 10-year, additional appreciation also excluded
Step 6: State Tax Considerations
If state_oz_conformity is false or unknown:
- List states that do not conform to federal OZ provisions
- Calculate state tax on OZ gains that would be excluded at federal level
- Reduce net benefit accordingly
- Flag: "State OZ conformity must be verified. Non-conforming states tax OZ gains excluded at the federal level."
Output Format
Present results in this order:
- OZ Tax Benefit Quantification -- table: benefit component, calculation, dollar value, PV
- After-Tax IRR Comparison -- table: OZ investment vs. non-OZ alternative, pre-tax IRR, taxes at entry/operations/exit, after-tax IRR, after-tax equity multiple, OZ premium
- Compliance Checklist -- bulleted with test dates and thresholds:
- 90% asset test schedule
- Substantial improvement test (if applicable)
- Working capital safe harbor timeline
- Prohibited uses
- Annual reporting requirements (Form 8996)
- Exit Strategy Matrix -- table by exit year showing exclusion availability, tax impact, after-tax proceeds, NPV
- Sensitivity Analysis -- after-tax IRR differential by hold period and pre-tax IRR spread
- State Tax Warning -- if applicable
- Recommendation: OZ Structure Justified / Marginal / Not Justified -- with conditions and one-paragraph rationale
- Assumption Log -- every assumed value
Red Flags and Failure Modes
- Investing in a sub-par asset solely for the OZ tax benefit: the tax tail should not wag the investment dog. If the OZ project yields 9% pre-tax and the non-OZ yields 12%, the 300 bps sacrifice is rarely compensated by tax benefits. Calculate and show.
- Assuming the 10-year exclusion is guaranteed when liquidity may be needed before year 10: early exit destroys the primary benefit. The 10-year commitment is binding.
- Misunderstanding the substantial improvement test: uses adjusted basis (not purchase price), land excluded. This makes the test harder to satisfy than expected.
- Assuming basis step-ups are still available: they expired. Many OZ marketing materials are outdated.
- Ignoring state tax non-conformity: several states tax OZ gains excluded at the federal level.
- Failing to maintain the 90% asset test: semi-annual testing, penalties for failure. Cash management between deployment phases is the most common compliance failure.
- 180-day investment window: gain must be invested within 180 days of recognition. Missing the window forfeits OZ eligibility entirely.
Chain Notes
- Upstream: deal-underwriting-assistant (pre-tax project economics)
- Downstream: deal-underwriting-assistant (OZ-adjusted after-tax returns as alternative framework)
- Related: cost-segregation-analyzer (depreciation strategies interact with OZ structure), partnership-allocation-engine (QOZF entity structuring and partner allocations)