real-estate-ops

v1.0.0 MIT business updated 2026-09-27

Turn a property-features JSON object into a polished MLS-style listing description — beds, baths, square footage, lot, year built, features, and nearby amenities assembled into ready-to-publish paragraphs. Use when writing a new listing and you want consistent, professional copy without inventing facts.

$ skillbank install real-estate-ops@1.0.0
# pins exactly 1.0.0 · README + changelog included

Real Estate Ops

Overview

Listing copy written in a hurry reads like it. This skill takes a property-features JSON object and assembles a polished, MLS-style description — an opener with the key stats, a paragraph on the home's character and features, and a location paragraph with a call to action. The writer only rephrases facts present in the JSON; it never invents amenities, square footage, or dates that are not in the input. Always proofread before publishing — you know the house, the script does not.

Pair it with the open-house playbook in references/open-house-checklist.md: signage, the sign-in sheet, feedback cards, and when to ask for the review (at closing, never at the showing).

Installation

1. Copy the real-estate-ops/ directory anywhere convenient. 2. Make the script executable (Unix):


   chmod +x scripts/listing.py

No pip install needed — standard library only.

Configuration

Input is a JSON object. Required fields:

| Field | Format | |--------------|-------------------------------------------| | address | Full street address, non-empty string. | | beds | Number (2.5 baths style decimals allowed).| | baths | Number. | | sqft | Number — living area square footage. | | year_built | Four-digit year. |

Optional fields: lot (string, e.g. "0.42-acre"), features (array of strings), nearby (array of strings). Paragraphs for lot, features, and nearby appear only when the data is present. Bad or missing values print a clear error to stderr and exit nonzero — never a traceback.

Inputs

| Command | Arguments | Returns | |--------------|--------------------|------------------------------------------------| | listing.py | --in <json> | MLS-style description paragraphs on stdout. |

No arguments prints usage to stderr and exits 2. --help prints usage and exits 0.

Worked example

Tested with a realistic 3-bedroom colonial:


$ cat property.json
{"address":"1428 Maple Grove Drive, Bethlehem, PA 18018","baths":2.5,"beds":3,
 "features":["a sun-filled eat-in kitchen with quartz counters",
             "refinished hardwood floors",
             "a stone fireplace in the family room",
             "an updated primary suite with walk-in closet",
             "a two-car attached garage"],
 "lot":"0.42-acre",
 "nearby":["top-rated schools","the Saucon Valley rail trail",
           "downtown Bethlehem dining and shops"],
 "sqft":2150,"year_built":1968}

$ ./scripts/listing.py --in property.json
Welcome to 1428 Maple Grove Drive, Bethlehem, PA 18018, a 3-bedroom,
2.5-bath home offering 2,150 square feet of living space. The home sits on
a 0.42-acre lot, giving you room to spread out and enjoy the outdoors.

Built in 1968, this home pairs classic character with 2,150 square feet of
comfortable, easy-living space. Thoughtful details throughout include a
sun-filled eat-in kitchen with quartz counters, refinished hardwood
floors, a stone fireplace in the family room, an updated primary suite
with walk-in closet, and a two-car attached garage.

The location puts you close to top-rated schools, the Saucon Valley rail
trail, and downtown Bethlehem dining and shops, so everyday errands and
weekend plans are simple. Homes with this mix of space, character, and
location do not come along often — schedule your showing today.

Every sentence above traces back to a field in the JSON — no invented fireplaces, no phantom square footage. (Line breaks above are wrapped for readability; the script prints three plain paragraphs.)

Safety notes

The script reads your property JSON and prints to stdout — it never uploads or transmits anything. Listing data stays on your machine until you decide to publish it.

Version history

Changelog

1.0.0 — 2026-09-27

  • Initial public release.
  • scripts/listing.py: property-features JSON → polished MLS-style description paragraphs on stdout.
  • Writer only rephrases facts present in the JSON; optional lot/features/nearby paragraphs appear only when the data is present.
  • references/open-house-checklist.md: signage, sign-in sheet, feedback cards, and review-request timing (ask at closing).
  • Zero dependencies; tested with a 3-bedroom colonial sample plus bad-input cases.

← back to catalog