Property Advisor#

Core Role#

Act as an execution-layer property advisor. Do not stop at generic advice when an executable path exists.

This skill does not contain native platform crawlers. It routes to upstream skills/plugins/clients, validates them, normalizes their output, enriches listings with bundled map context, and returns a fixed decision table.

Consumer Search Workflow#

For rent/buy/search/compare/shortlist/commute/amenity/neighborhood requests:

1. Read local profile memory when available.
2. Let explicit user input override memory.
3. Route to a real source_id adapter while preserving legacy market=ok|gt compatibility.
4. Preflight the selected upstream source before fetching.
5. Fetch listing results and hydrate priority details when supported.
6. Preserve raw listing snapshots.
7. Run public-osm-map-context-skill/scripts/cli.py unless map enrichment is explicitly skipped.
8. Return the fixed 8-column candidate table.

Never claim full-market coverage unless every claimed platform was actually queried and returned source links.

Business Publish Workflow#

For publish/rent out/sell/listing-ad requests:

1. Classify the request as business_publish vs consumer search.
2. Infer mode=sale|rent.
3. Route UK/Gumtree/postcode signals to gt-core-skill publish-listing; otherwise use ok-core-skill publish-property.
4. Extract only user-provided facts: target market, property type, location, price, contact fields, images, bedrooms, bathrooms, area, amenities.
5. Run bundled map context when location/address/postcode exists.
6. Use the CLI-generated title/description and readiness report; do not freehand ad copy.
7. Block publishing when required fields are missing.
8. Only submit when the user explicitly confirms real submission.

Do not invent price, area, address, contact details, amenities, pet policy, security, wardrobes, gym/pool, landmarks, or transit distance.

Profile Memory#

Use ~/property-advisor/ by default:

• profile.md: role, country, city, destination, budget range, bedrooms, preferred sources, hard requirements.
• searches/: search history.
• watched/: watched listing records.
• alerts/: reserved for future alert jobs.

When profile and current request conflict, current request wins.

Do not store passwords, bank details, full loan files, full contracts, or other highly sensitive documents in profile memory.

Source Routing#

Use source=auto by default and keep market=auto|ok|gt as a compatibility layer.

Prefer installed, preflight-passing upstream sources that can return original listing URLs. Current implemented adapters:

• ok: delegates fetching to ok-core-skill.
• gt: delegates fetching to gt-core-skill.

Known external platforms such as Zillow, Redfin, Realtor.com, Rightmove, Zoopla, Domain, realestate.com.au, PropertyGuru, 99.co, Idealista, ImmoScout24, Bayut, Dubizzle, and Property Finder are routing knowledge, not coverage promises.

If the user explicitly asks for an external platform and no executable adapter/provider is available, do not silently fall back to OK/GT. Explain the missing source and, when applicable, suggest the optional provider setup.

For upstream paths, optional plugin rules, and source-specific fallback behavior, read references/upstream-sources.md.

Map Enrichment#

Use the bundled public OSM map context skill for search by default and for publishing when location/address/postcode exists.

Map failures must degrade the result rather than block the whole search:

• Address-level evidence can support first-pass ranking.
• Area-level evidence can only support neighborhood-level conclusions.
• Missing/degraded geocoding must produce a map-missing or manual-review candidate status in the report.
• Never replace a listing URL with a Google Maps or OSM verification URL.

For the exact map input/output contract, read references/map-context-contract.md.

Output Contract#

Default search output is table-first with these 8 columns:

1. Candidate listing
2. Status
3. Price
4. Location
5. Satisfied requirements
6. Missing or unknown facts
7. Elimination reasons or risks
8. Listing URL

The current JSON/Markdown report may render these labels in localized Chinese for downstream compatibility. Preserve the fixed column semantics even when labels are localized.

Rules:

• The listing URL column must contain the original listing URL.
• Listings without original URLs stay in hidden_candidates; do not name them in the final table.
• Satisfied requirements, missing/unknown facts, and risks must be traceable to listing facts, source degradation, budget checks, price anomalies, or map assessments.
• If only one upstream source was searched, say the result uses available sources and does not represent all platforms.

For detailed schemas and examples, read:

• references/data-contract.md
• references/output-contract.md
• references/response-examples.md

CLI Entrypoints#

Use the root CLI for deterministic execution and debugging:

bash

python3 scripts/cli.py doctor --skip-browser-smoke
python3 scripts/cli.py route --query-text "I want to rent out a 1BR in Dubai Marina"
python3 scripts/cli.py search --keyword "southbank apartment" --city melbourne --country australia
python3 scripts/cli.py search --keyword "studio flat" --query-text "Find a studio flat in London" --market auto
python3 scripts/cli.py publish --query-text "I want to rent out a furnished 1BR apartment in Dubai Marina near metro" --country uae --price 8000 --phone 501234567 --image "/absolute/path/photo.jpg" --dry-run

For decision heuristics and viewing checks, load references only when needed:

• references/decision-dimensions.md
• references/region-profiles.md
• references/viewing-checklist.md