---
name: listing-copy-writer
description: "Draft portal-optimised property descriptions for a new instruction. Produces headline, key features bullet list, full description, and location paragraph in the agent's voice. Built for use inside new-instruction."
---

# Listing copy writer

A building-block skill called by `new-instruction`. Produces the listing copy the operator approves before any portal upload.

## What it produces

Four parts, in order:

1. **Headline.** One line, attention-getting, accurate. No exaggeration. ASA upheld complaints (shared driveway described as "private drive") show the cost of overstatement; the skill stays inside what the property survey or photographs can support.
2. **Key features.** Four to eight bullet points covering the strongest selling features. Numbers where they help (bedroom count, garden length, square footage). One feature per bullet.
3. **Full description.** Two to four paragraphs in the agent's voice, structured per the profile's preferred section order. Length target from the profile.
4. **Location paragraph.** One paragraph on transport, schools, amenities. Sourced from area knowledge in the CRM and the agent's prior listings in the same area.

## Material information

The Digital Markets, Competition and Consumers Act 2024 obligation to disclose material information bears on every listing. The draft includes:

- Council tax band
- Tenure (and ground rent and service charge if leasehold)
- Property type and construction materials
- Number of rooms, utilities (electricity, water, sewerage), heating type
- Broadband and mobile coverage where known
- Parking arrangement
- Building safety information, covenants, rights of way, easements, listed status, conservation area, tree preservation orders, flood risk, coastal erosion, planning permission, structural issues (subsidence, damp, asbestos, Japanese knotweed), mining or coalfield context, where applicable

Missing items are flagged at the top of the draft so the operator can fill them before approving. Rightmove now rejects listings without the mandatory fields.

`compliance-flag-checker` runs against the draft before the operator sees it.

## Voice source

Reads the profile's voice samples and the operator's prior listing copy. Within a month of edit-before-send diffs, the drafts should need minimal editing.

## What it does not do

- It does not upload to the portals. Portal upload is staged by `portal-launch-scheduler` and fired on the operator's approval.
- It does not produce the PDF brochure. That is `particulars-builder`.
- It does not commission the photography or floorplan; both must exist for the location paragraph to reference real images, and for the portal upload to be complete.

## Connectors

Read: profile (voice samples, section order, length target), CRM (property details, area knowledge).
Write: none.

## Profile keys

- `realagent.voice_samples`
- `realagent.listing_copy.section_order`
- `realagent.listing_copy.length_words`
- `realagent.listing_copy.headline_style` ("descriptive" | "feature-led" | "location-led", learned)
