Opportunity Zone Underwriter
Evaluates whether investing capital gains into a Qualified Opportunity Zone Fund produces superior after-tax returns vs.
No packaged download — skills install from the open-source plugin repo. Read the SKILL.md and bundled files below before you install.
How to install a skill →Evaluates whether investing capital gains into a Qualified Opportunity Zone Fund produces superior after-tax returns vs.
Derived from the skill’s “Skill description” section.
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.
Derived from the skill’s “When to Activate” section.
Not documented yet for this skill.
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
Derived from the skill’s “Output Format” section.
Stale-data note: OZ regulations reflect IRC Section 1400Z-2 as of mid-2025. The original basis step-ups (10%/15% for 5/7-year holds) have expired for new investments. Deferral recapture date is 12/31/2026 or earlier disposition. State OZ conformity varies and changes frequently. Always verify current regulations with qualified tax counsel.
Derived from the skill’s “stale-data note” section.
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)