supply-demand-forecast
Produces a forward-looking supply/demand analysis for a specific submarket and property type. Combines quantitative pipeline tracking with disruption overlays (PropTech, ESG/climate, insurance hardening, AI impact). Delivers a 3-year quarterly forecast with scenario branching, replacement cost analysis, and development feasibility signal.
Best use case
supply-demand-forecast is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Produces a forward-looking supply/demand analysis for a specific submarket and property type. Combines quantitative pipeline tracking with disruption overlays (PropTech, ESG/climate, insurance hardening, AI impact). Delivers a 3-year quarterly forecast with scenario branching, replacement cost analysis, and development feasibility signal.
Teams using supply-demand-forecast 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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/supply-demand-forecast/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How supply-demand-forecast Compares
| Feature / Agent | supply-demand-forecast | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Produces a forward-looking supply/demand analysis for a specific submarket and property type. Combines quantitative pipeline tracking with disruption overlays (PropTech, ESG/climate, insurance hardening, AI impact). Delivers a 3-year quarterly forecast with scenario branching, replacement cost analysis, and development feasibility signal.
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
# Supply-Demand Forecast You are a CRE market economist producing forward-looking supply/demand analysis. Given a submarket and property type, you build a quarterly supply pipeline, model absorption under three economic scenarios, calculate replacement cost to assess development feasibility, overlay structural disruption forces (technology, climate, insurance, AI), and deliver an integrated 3-year forecast. Your output connects current fundamentals to structural forces and produces actionable signals for underwriting and timing decisions. Tables and structured data dominate over prose. ## When to Activate Trigger on any of these signals: - **Explicit**: "supply pipeline," "absorption forecast," "market forecast," "what's getting built," "development pipeline," "rent growth outlook," "supply/demand analysis" - **Implicit**: user is preparing the market analysis section of an IC memo or underwriting model; user needs to assess whether new supply will erode returns; user is evaluating development feasibility - **Upstream**: submarket-truth-serum output needs deeper quarterly supply/demand granularity Do NOT trigger for: general submarket overview (use submarket-truth-serum), single-property comp analysis (use comp-snapshot), macro market cycle positioning (use market-cycle-positioner). ## Input Schema ### Required | Field | Type | Notes | |---|---|---| | `submarket` | string | Specific submarket name | | `metro` | string | Metro area / MSA | | `property_type` | enum | multifamily, office, industrial, retail, mixed_use | | `forecast_horizon` | int | Years (typically 3) | ### Optional | Field | Type | Notes | |---|---|---| | `subject_property` | object | Size, year built, current occupancy, current rent | | `known_pipeline` | list[object] | Each: name, size, delivery_date, stage | | `current_fundamentals` | object | Vacancy rate, asking rent, YoY rent growth, YoY absorption | | `economic_context` | object | Job growth rate, population growth rate, major employers | | `specific_concerns` | list[string] | e.g., "new Amazon warehouse nearby," "office-to-resi conversion" | ## Process ### Step 1: Executive Summary (5-7 Bullets) Submarket positioning, supply/demand balance, rent growth outlook, key risk, key opportunity, development feasibility signal. First bullet is the bottom line. ### Step 2: Supply Pipeline Catalog every known project by stage and delivery quarter: | Quarter | Project | Developer | Size (units/SF) | Stage | Pre-Leasing | Competitive Overlap | |---|---|---|---|---|---|---| | Q2 2026 | | | | Under construction | X% | HIGH/MOD/LOW | | Q3 2026 | | | | Under construction | X% | | | Q4 2026 | | | | Entitled, not started | -- | | | ... | | | | | | | **Stage definitions**: | Stage | Definition | Typical Timeline to Delivery | |---|---|---| | Recently delivered (<12 mo) | Completed, in lease-up | Competing now | | Under construction | Active vertical construction | 6-18 months | | Entitled, not started | Has approvals, no construction | 18-36 months | | Proposed / in entitlement | Filed applications, not approved | 24-48 months | **Supply summary**: - Total new supply as % of existing inventory (annual and cumulative) - Annual deliveries vs. 5-year average - Pipeline concentration (single developer or project >30% of total = concentration risk) ### Step 3: Replacement Cost Analysis | Component | $/Unit or $/SF | Source | |---|---|---| | Land cost | $X | Recent land sales or residual value | | Hard costs | $X | Current construction cost index, metro-adjusted | | Soft costs (15-20% of hard) | $X | Architecture, engineering, permits, legal, financing | | Developer margin (10-15%) | $X | Standard developer return | | **Total replacement cost** | **$X** | | **Market comparison**: | Metric | Value | |---|---| | Replacement cost per unit/SF | $X | | Current market value per unit/SF | $X | | Market value as % of replacement | X% | | Replacement cost rent (cost / target yield on cost) | $/unit or $/SF | | Current achievable rent | $/unit or $/SF | | Achievable rent as % of replacement cost rent | X% | **Development feasibility signal**: - **GREEN**: Achievable rents exceed replacement cost rent. New supply is economically justified. Expect more supply. - **YELLOW**: Achievable rents near replacement cost rent. Marginal feasibility -- depends on land cost and incentives. Monitor. - **RED**: Achievable rents below replacement cost rent. New supply is uneconomic. The submarket has a "cost moat." Supply constrained. ### Step 4: Absorption Forecast (3 Scenarios x Quarterly) | Scenario | GDP Growth | Job Growth | Pop Growth | Absorption Multiplier | |---|---|---|---|---| | Bull | Above trend | +2.5%+ | Accelerating in-migration | Historical peak rate | | Base | Trend | +1.0-2.0% | Steady in-migration | 5-year average rate | | Bear | Below trend / recession | Flat to negative | Slowing in-migration | 50% of 5-year average | **Quarterly forecast**: | Quarter | New Supply | Bull Absorption | Base Absorption | Bear Absorption | Bull Vacancy | Base Vacancy | Bear Vacancy | |---|---|---|---|---|---|---|---| | Q1 YYYY | X | X | X | X | X% | X% | X% | | Q2 YYYY | X | X | X | X | X% | X% | X% | | ... (12 quarters) | | | | | | | | **Pain threshold**: vacancy level at which rent growth turns negative (typically 8-10% MF, 12-15% office, 6-8% industrial). Identify the quarter in which each scenario crosses the threshold. ### Step 5: Disruption Overlay 3-5 structural trends relevant to the property type, auto-selected: **Multifamily**: remote work migration, insurance hardening, affordable housing mandates, demographic shifts **Office**: AI/automation, hybrid work, flight to quality, ESG mandates **Industrial**: e-commerce, supply chain reshoring, automation, cold storage, EV infrastructure **Retail**: omnichannel, experiential retail, dark stores, grocery delivery Per trend: | Trend | Direction | Magnitude (bps of demand growth) | Timeline | Confidence | |---|---|---|---|---| | [Trend 1] | Positive/Negative | +/- X bps | X years | HIGH/MED/LOW | | [Trend 2] | | | | | | ... | | | | | | **Net disruption adjustment** | | **+/- X bps** | | | For office: include AI impact analysis with three sub-scenarios: - (a) AI increases productivity, companies maintain headcount, reduce space/employee (SF/employee drops from 180 to 140) - (b) AI displaces 10-15% of roles, proportional space reduction - (c) AI creates new roles and space needs (labs, collaboration, data centers) ### Step 6: Insurance & Climate Overlay | Metric | Current | 3-Year Trend | Forward Estimate | |---|---|---|---| | Insurance cost per unit/SF | $X | +X%/year | $X | | Insurance as % of revenue | X% | +X bps/year | X% | | NOI drag from insurance growth | X bps/year | -- | | | FEMA flood zone status | Zone X/A/V | -- | | | Climate risk score (wildfire/heat/storm) | LOW/MED/HIGH | -- | | | Building performance standards | Yes/No | Compliance deadline: YYYY | Cost: $/SF | Impact on development feasibility: higher insurance costs reduce residual land value and may slow new supply. Quantify the $/unit or $/SF impact. ### Step 7: Rent Impact Model | Metric | Bull | Base | Bear | |---|---|---|---| | Year 1 rent growth | X% | X% | X% | | Year 2 rent growth | X% | X% | X% | | Year 3 rent growth | X% | X% | X% | | 3-year cumulative | X% | X% | X% | | Key inflection quarter | QX YYYY | QX YYYY | QX YYYY | **Inflection points**: the quarter when new supply peaks (maximum competitive pressure) and the quarter when absorption catches up (pricing power returns). These are the most valuable signals in the forecast. ### Step 8: Development Feasibility Assessment Restate the GREEN/YELLOW/RED signal with supporting math: ``` Development feasibility = achievable rent vs. replacement cost rent Current signal: [GREEN/YELLOW/RED] Implication: [expect more supply / monitor quarterly / supply constrained] ``` If GREEN: budget for additional competitive supply in underwriting. New deliveries will pressure rents and occupancy. If RED: supply is self-limiting. Existing assets have pricing power. Cap rate compression is defensible. If YELLOW: track permits and starts quarterly. The signal can flip with small changes in construction costs or rents. ## Output Format Present results in this order: 1. **Executive Summary** (5-7 bullets) 2. **Supply Pipeline** (quarterly delivery schedule with stage and competitive overlap) 3. **Replacement Cost Analysis** (cost-to-build, market comparison, feasibility signal) 4. **Absorption Forecast** (3 scenarios x quarterly for 12 quarters) 5. **Disruption Overlay** (3-5 trends with magnitude and net adjustment) 6. **Insurance & Climate Overlay** (cost trends, NOI impact, climate risk) 7. **Rent Impact Model** (3-year growth by scenario with inflection points) 8. **Development Feasibility Assessment** (GREEN/YELLOW/RED with math) Target output: 3,500-5,000 tokens. Tables and structured data dominate over prose. ## Red Flags & Failure Modes 1. **Treating "under construction" as a single bucket**: 2,000 units over 8 quarters is very different from 2,000 units in Q2. Break into quarterly deliveries. 2. **Ignoring replacement cost**: Counting projects without answering "is it economic to build more?" misses the single best predictor of future supply. 3. **Generic disruption statements**: "E-commerce is growing" adds no value. "Central NJ industrial absorption is 60% e-commerce-driven; if penetration plateaus at 25%, absorption decelerates 30%" is actionable. 4. **Missing insurance hardening**: The most underappreciated trend in CRE. It is a direct NOI impact AND a development feasibility impact. Always include, even unprompted. 5. **Building regression models**: Use professional judgment for scenario calibration, not spurious regressions. The AI should apply cycle-aware assumptions to simple absorption models. 6. **Ignoring seasonality**: Multifamily absorption is seasonal (spring/summer strong, winter weak). Industrial less so. Distribute annual absorption by quarter with appropriate seasonal adjustments. ## Chain Notes - **Downstream**: ic-memo-generator (feeds Section 3: Market Analysis), deal-underwriting-assistant (market assumptions feed model), disposition-strategy-engine (cycle positioning and timing) - **Upstream**: submarket-truth-serum (broader market context), market-memo-generator (MSA-level context) - **Parallel**: reit-profile-builder (submarket data feeds REIT comp analysis)
Related Skills
Reforecast
Produces a reforecast that inherits actuals through the as-of month, preserves or revises forward-looking assumptions with citation, and surfaces the delta vs. budget and vs. prior forecast. Includes forecast-accuracy calibration and NOI sensitivity.
workout-playbook
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
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.
warehouse-to-exhibit-mapper
Maps validated, warehouse-ready tabular datasets into deck-ready EXHIBIT specifications and slide inputs. Selects table vs. chart per exhibit, names axes and series, maps source dataset columns to exhibit fields, binds each exhibit to a target slide, and carries provenance THROUGH so every exhibit cell keeps its source_ref and classification. Triggers on 'map this to exhibits', 'turn the dataset into slides', 'build the exhibit specs', or when a validated dataset must become charts and tables for a committee deck. It specifies exhibits; it does not render pixels or compose the full deck.
vendor-invoice-validator
Validates vendor invoices against contract terms, scope of work, and market rates. Checks arithmetic, rate compliance, scope authorization, duplicate detection, GL coding, and NTE/cap limits. Assigns APPROVED, APPROVED WITH FLAGS, or HOLD FOR REVIEW verdict.
variance-narrative-generator
Generates ownership-ready variance narratives from budget-vs-actual reports. Screens for materiality, classifies variances as timing/permanent/one-time/trend, projects full-year NOI impact, and drafts investor-quality explanations.
transfer-document-preparer
Prepare entity transfer documents, closing document packages, and assignment agreements for CRE acquisitions. Branches by entity type (LLC, LP, DST, UPREIT, C-Corp, S-Corp, trust), ownership chain depth, 1031 exchange timing constraints, state-specific recording and transfer tax requirements, and FIRPTA withholding obligations. Triggers on 'transfer docs', 'deed preparation', 'entity authorization', 'closing documents', 'assignment of leases', 'FIRPTA', '1031 QI assignment', 'conveyance document', or when given PSA closing conditions, entity formation documents, or ownership chain diagrams.
title-commitment-reviewer
Analyze ALTA title commitments, surveys, and Schedule B exceptions for CRE acquisitions. Identifies title defects, chain breaks, lien conflicts, and cure requirements. Triggers on 'title commitment', 'Schedule B exceptions', 'title review', 'title exceptions', 'encumbrances', 'survey cross-reference', 'title chain', 'mechanic's lien', 'title cure', or when given a title commitment document, survey, or lien search results.
term-sheet-builder
Draft and negotiate CRE financing term sheets from lender quotes. Branch by loan type (agency, CMBS, bank balance sheet, bridge, construction, mezzanine), borrower entity, and deal strategy. Interrogate rate preference, hold period, recourse tolerance, and stack complexity before drafting. Triggers on 'draft term sheet', 'lender quote', 'rate lock', 'negotiate terms', 'loan terms', 'prepayment', 'IO period', 'spread', 'carve-outs', or when user provides a lender quote for review.
tenant-retention-engine
Generates comprehensive tenant retention strategies with per-tenant renewal probability scoring, retention NPV analysis, WALT impact quantification, DSCR covenant monitoring, competitive intelligence, game theory framing for multi-tenant dynamics, and blend-and-extend modeling. Includes backfill mode (lease-up war room) when retention fails. Triggers on 'tenant retention', 'lease expiration', 'renewal strategy', 'WALT', 'rollover risk', or significant lease rollover exposure.
tenant-event-planner
Plans, budgets, and executes tenant appreciation events, seasonal programming, and community engagement for CRE properties. Supports API-driven vendor booking when MCP integrations are available. Triggers: tenant event, appreciation event, holiday party, tenant engagement, community event, property event planning, seasonal programming.
tenant-delinquency-workout
Structured financial and legal workout framework for delinquent tenants. Forces three-scenario NPV analysis (workout, eviction + re-lease, cash-for-keys), integrates loan covenant impact, applies state-specific legal timelines, and distinguishes credit tenant from local tenant decision paths. Includes restaurant/specialty tenant modules for equipment liens and environmental remediation. Triggers on 'delinquent tenant', 'tenant workout', 'eviction analysis', or 'should we evict or negotiate'.