# zubair-trabzada/ai-realestate-claude architecture

> Architecture diagram of the GitHub repository zubair-trabzada/ai-realestate-claude, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zubair-trabzada/ai-realestate-claude
- Repository: https://github.com/zubair-trabzada/ai-realestate-claude

## Overview

This repository packages Claude Code skills for property research and investment analysis, with a Python utility for rendering PDF reports. The main workflow routes a request through the primary skill to a focused analysis; full analysis coordinates five specialist agents and combines their findings into a scored recommendation. Separate skills cover screening, comparisons, financing, listings, and property-specific analyses. The README documents these capabilities, but most skill and agent implementations were not sampled, so their internal calls and external data sources are not shown. The PDF generator accepts JSON input and produces a report.

Main entry points: [`realestate/SKILL.md`](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/realestate/SKILL.md) (Main Skill Router), [`skills/realestate-analyze/SKILL.md`](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-analyze/SKILL.md) (Full Analysis), [`skills/realestate-report-pdf/SKILL.md`](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-report-pdf/SKILL.md) (PDF Report Skill), [`scripts/generate_realestate_pdf.py`](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/scripts/generate_realestate_pdf.py) (PDF Generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Skill Orchestration"]
  node_main_skill["Main Skill Router<br/>[SKILL.md]"]
  node_analyze["Full Analysis<br/>[SKILL.md]"]
  node_quick["Quick Snapshot<br/>[SKILL.md]"]
end

subgraph group_analysis["Property Analysis"]
  node_comps_skill["Comparable Sales<br/>[SKILL.md]"]
  node_comps_agent["Comps Agent"]
  node_rental_skill["Rental Analysis<br/>[SKILL.md]"]
  node_rental_agent["Rental Agent"]
  node_neighborhood_skill["Neighborhood Analysis<br/>[SKILL.md]"]
  node_neighborhood_agent["Neighborhood Agent"]
  node_market_skill["Market Analysis<br/>[SKILL.md]"]
  node_market_agent["Market Agent"]
end

subgraph group_decision["Investment Decisions"]
  node_invest_skill["Investment Analysis<br/>[SKILL.md]"]
  node_invest_agent["Investment Agent"]
  node_flip["Fix and Flip<br/>[SKILL.md]"]
  node_commercial["Commercial Analysis<br/>[SKILL.md]"]
  node_screen["Property Screener<br/>[SKILL.md]"]
  node_mortgage["Mortgage Calculator<br/>[SKILL.md]"]
  node_compare["Property Comparison<br/>[SKILL.md]"]
end

subgraph group_delivery["Reports and Output"]
  node_listing["Listing Writer<br/>[SKILL.md]"]
  node_pdf_skill["PDF Report Skill<br/>[SKILL.md]"]
  node_pdf_generator["PDF Generator"]
  node_report["Property Report"]
end

node_user(("Claude Code User"))

node_user -->|"requests analysis"| node_main_skill
node_main_skill -->|"routes full analysis"| node_analyze
node_main_skill -->|"routes snapshot"| node_quick
node_analyze -->|"launches agent"| node_comps_agent
node_analyze -->|"launches agent"| node_rental_agent
node_analyze -->|"launches agent"| node_neighborhood_agent
node_analyze -->|"launches agent"| node_invest_agent
node_analyze -->|"launches agent"| node_market_agent
node_main_skill -->|"routes comps"| node_comps_skill
node_main_skill -->|"routes rental"| node_rental_skill
node_main_skill -->|"routes neighborhood"| node_neighborhood_skill
node_main_skill -->|"routes market"| node_market_skill
node_main_skill -->|"routes investment"| node_invest_skill
node_main_skill -->|"routes flip"| node_flip
node_main_skill -->|"routes commercial"| node_commercial
node_main_skill -->|"routes screening"| node_screen
node_main_skill -->|"routes mortgage"| node_mortgage
node_main_skill -->|"routes comparison"| node_compare
node_main_skill -->|"routes listing"| node_listing
node_main_skill -->|"routes PDF report"| node_pdf_skill
node_pdf_skill -.->|"generates report"| node_pdf_generator
node_pdf_generator -->|"writes PDF"| node_report

click node_main_skill "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/realestate/SKILL.md"
click node_analyze "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-analyze/SKILL.md"
click node_quick "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-quick/SKILL.md"
click node_comps_skill "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-comps/SKILL.md"
click node_comps_agent "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-comps.md"
click node_rental_skill "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-rental/SKILL.md"
click node_rental_agent "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-rental.md"
click node_neighborhood_skill "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-neighborhood/SKILL.md"
click node_neighborhood_agent "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-neighborhood.md"
click node_market_skill "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-market/SKILL.md"
click node_market_agent "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-market.md"
click node_invest_skill "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-invest/SKILL.md"
click node_invest_agent "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-invest.md"
click node_flip "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-flip/SKILL.md"
click node_commercial "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-commercial/SKILL.md"
click node_screen "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-screen/SKILL.md"
click node_mortgage "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-mortgage/SKILL.md"
click node_compare "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-compare/SKILL.md"
click node_listing "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-listing/SKILL.md"
click node_pdf_skill "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-report-pdf/SKILL.md"
click node_pdf_generator "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/scripts/generate_realestate_pdf.py"
click node_report "https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/scripts/generate_realestate_pdf.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main_skill,node_analyze,node_quick,node_user toneBlue
class node_comps_skill,node_comps_agent,node_rental_skill,node_rental_agent,node_neighborhood_skill,node_neighborhood_agent,node_market_skill,node_market_agent toneAmber
class node_invest_skill,node_invest_agent,node_flip,node_commercial,node_screen,node_mortgage,node_compare toneMint
class node_listing,node_pdf_skill,node_pdf_generator,node_report toneRose
```

## Components

### Skill Orchestration

- [Main Skill Router](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/realestate/SKILL.md): `realestate/SKILL.md`
- [Full Analysis](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-analyze/SKILL.md): `skills/realestate-analyze/SKILL.md`
- [Quick Snapshot](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-quick/SKILL.md): `skills/realestate-quick/SKILL.md`

### Property Analysis

- [Comparable Sales](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-comps/SKILL.md): `skills/realestate-comps/SKILL.md`
- [Comps Agent](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-comps.md): `agents/realestate-comps.md`
- [Rental Analysis](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-rental/SKILL.md): `skills/realestate-rental/SKILL.md`
- [Rental Agent](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-rental.md): `agents/realestate-rental.md`
- [Neighborhood Analysis](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-neighborhood/SKILL.md): `skills/realestate-neighborhood/SKILL.md`
- [Neighborhood Agent](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-neighborhood.md): `agents/realestate-neighborhood.md`
- [Market Analysis](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-market/SKILL.md): `skills/realestate-market/SKILL.md`
- [Market Agent](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-market.md): `agents/realestate-market.md`

### Investment Decisions

- [Investment Analysis](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-invest/SKILL.md): `skills/realestate-invest/SKILL.md`
- [Investment Agent](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/agents/realestate-invest.md): `agents/realestate-invest.md`
- [Fix and Flip](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-flip/SKILL.md): `skills/realestate-flip/SKILL.md`
- [Commercial Analysis](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-commercial/SKILL.md): `skills/realestate-commercial/SKILL.md`
- [Property Screener](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-screen/SKILL.md): `skills/realestate-screen/SKILL.md`
- [Mortgage Calculator](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-mortgage/SKILL.md): `skills/realestate-mortgage/SKILL.md`
- [Property Comparison](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-compare/SKILL.md): `skills/realestate-compare/SKILL.md`

### Reports and Output

- [Listing Writer](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-listing/SKILL.md): `skills/realestate-listing/SKILL.md`
- [PDF Report Skill](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/skills/realestate-report-pdf/SKILL.md): `skills/realestate-report-pdf/SKILL.md`
- [PDF Generator](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/scripts/generate_realestate_pdf.py): `scripts/generate_realestate_pdf.py`
- [Property Report](https://github.com/zubair-trabzada/ai-realestate-claude/blob/main/scripts/generate_realestate_pdf.py): `scripts/generate_realestate_pdf.py`

### Other components

- **Claude Code User**

## Connections

- Claude Code User → Main Skill Router: requests analysis (evidence: `README.md`)
- Main Skill Router → Full Analysis: routes full analysis (evidence: `README.md`)
- Main Skill Router → Quick Snapshot: routes snapshot (evidence: `README.md`)
- Full Analysis → Comps Agent: launches agent (evidence: `README.md`)
- Full Analysis → Rental Agent: launches agent (evidence: `README.md`)
- Full Analysis → Neighborhood Agent: launches agent (evidence: `README.md`)
- Full Analysis → Investment Agent: launches agent (evidence: `README.md`)
- Full Analysis → Market Agent: launches agent (evidence: `README.md`)
- Main Skill Router → Comparable Sales: routes comps (evidence: `README.md`)
- Main Skill Router → Rental Analysis: routes rental (evidence: `README.md`)
- Main Skill Router → Neighborhood Analysis: routes neighborhood (evidence: `README.md`)
- Main Skill Router → Market Analysis: routes market (evidence: `README.md`)
- Main Skill Router → Investment Analysis: routes investment (evidence: `README.md`)
- Main Skill Router → Fix and Flip: routes flip (evidence: `README.md`)
- Main Skill Router → Commercial Analysis: routes commercial (evidence: `README.md`)
- Main Skill Router → Property Screener: routes screening (evidence: `README.md`)
- Main Skill Router → Mortgage Calculator: routes mortgage (evidence: `README.md`)
- Main Skill Router → Property Comparison: routes comparison (evidence: `README.md`)
- Main Skill Router → Listing Writer: routes listing (evidence: `README.md`)
- Main Skill Router → PDF Report Skill: routes PDF report (evidence: `README.md`)
- PDF Report Skill → PDF Generator: generates report
- PDF Generator → Property Report: writes PDF (evidence: `scripts/generate_realestate_pdf.py`)
