01 · Problem
Qualified Opportunity Zone investments offer significant tax benefits -- primarily the 10-year exclusion of appreciation from capital gains tax -- but many investors chase OZ deals that are inferior investments dressed up with tax benefits. The core question is whether the tax tail is wagging the investment dog: does the OZ structure justify accepting lower pre-tax returns?
02 · Who & When
Tax advisors, fund managers structuring QOZF vehicles, and investors with capital gains evaluating OZ vs. non-OZ deployment. Used when a specific OZ investment opportunity is being compared to a non-OZ alternative, typically during capital allocation decisions.
03 · How It's Done Today
Tax attorneys and CPAs model OZ benefits in custom Excel workbooks, comparing after-tax IRR of OZ and non-OZ investments side by side. Many investors rely on OZ fund marketing materials that overstate benefits, particularly the expired basis step-ups.
04 · What This Skill Changes
Produces a rigorous OZ analysis including benefit quantification (correctly noting that basis step-ups have expired for new investments), after-tax IRR comparison between OZ and non-OZ alternatives, OZ premium calculation showing how much worse the OZ project can be while still matching non-OZ after-tax returns, compliance checklist with 90% asset test and substantial improvement test details, and exit strategy matrix by hold year. The honest assessment of expired step-ups counters widespread outdated marketing.
05 · Risks & Caveats
High - OZ regulations are complex, evolving, and involve significant tax consequences. The deferral recapture date, 180-day investment window, substantial improvement test calculations, and state conformity status all require verification with current tax law. This framework must be reviewed by qualified tax counsel before any investment decision.
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 |
discount_rate |
float | Investor's opportunity cost of capital; used for PV of deferral calculation. Default: 0.08 (8%) |
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 investments
Always 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_period
This 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_irr
If 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
Worked Example
See references/worked-oz-example.yaml for a complete analysis: $2M capital gains invested in a Jersey City OZ multifamily development, with full after-tax IRR comparison, compliance test walkthrough, and 540bp OZ IRR advantage.
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: Output suitable for IC memo generation or QOZF entity structuring analysis. Works alongside cost-segregation-analyzer and partnership-allocation-engine.
- Related: cost-segregation-analyzer (depreciation strategies interact with OZ structure), partnership-allocation-engine (QOZF entity structuring and partner allocations)
These are reference docs that the agent consults when it needs deeper context, along with helper scripts it runs for calculations and output templates it fills in. The skill loads them on demand — you don't need to edit them to use the skill.
Click any file below to preview its contents.