@rubytech/create-realagent-code 0.1.23 → 0.1.24

package/payload/premium-plugins/real-agency/plugins/leads/skills/morning-round/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: morning-round
+description: "Produce the daily one-page snapshot of diary, awaiting replies, overnight enquiries, stalled deals, and the top three actions for today. Triggers when the operator says 'morning round', 'morning brief', 'what's on', 'where are we', 'start my day', 'kick me off', 'what's new since yesterday', or a bare 'morning' or 'good morning' with no other content. Also fires on schedule at the profile's delivery time."
+---
+
+# Morning round
+
+The master workflow run daily by the negotiator at the agent's chosen time, Monday through Saturday. It is read-only by design. Every claim in the output cites a connector read or a profile entry, every section appears even when empty, and the workflow never writes to the CRM or sends a message.
+
+This skill earns the right to act. Until the operator trusts the morning round to look without permission, the chase-progression workflow has no licence to send anything.
+
+## Inputs
+
+- The operator's customisation profile, read first. The profile names the delivery channel, the stalled threshold per stakeholder type, the agent's preferred section order, and any section they have hidden.
+- The agent's calendar for today, read via the calendar connector.
+- The CRM state of every sale-agreed deal and every active negotiation, read via the CRM connector.
+- The portal enquiry feed since the last morning round, read via the portal connectors and email connector.
+- The WhatsApp Business inbox since the last morning round.
+
+If any connector is unavailable the workflow still produces the round and names the gap in plain language, for example "portal feeds unavailable, overnight enquiries not included in this round".
+
+## Architecture principles encoded here
+
+The six principles in spec 00 §8 apply once at this master-skill layer and are not repeated in the building-block skills it composes.
+
+- Read before write. This workflow never writes anything.
+- Stage, don't send. Not applicable, there is nothing to send.
+- One screen of output. The five sections must fit one Claude UI exchange. If they do not, the workflow has summarised badly.
+- Cite the source. Every number, name, and claim traces back to a connector read or a profile entry.
+- Teach the profile. Every operator interaction after the round feeds the profile through `profile-writer`. See learning hooks below.
+- Reversible. Read-only, nothing to reverse.
+
+## Output shape
+
+One markdown page, five sections, always in this order unless the profile has reordered them. Sections with no content collapse to one line so the operator always knows the section was checked.
+
+1. **Today's diary.** Viewings, valuations, market appraisals, vendor meetings, completion calls. Times, addresses, contact name, postcode. Built by `diary-builder`.
+2. **Awaiting reply.** Anything chased in the last 7 days (default, profile-learned) that has had no reply. Grouped by recipient type. Built by reading the CRM contact log and the email or WhatsApp sent folder.
+3. **New overnight.** Portal and email enquiries since the last login, triaged. Hot enquiries show verbatim. Lukewarm, cold, duplicate, and spam show a one-line summary only. Built by `enquiry-triage`.
+4. **Stalled.** Sale-agreed deals where nothing has moved past the stalled threshold. Each line names the property, the days stalled, and the most likely cause from chain state. Built by `chain-progression-tracker`.
+5. **Top three.** Three things to action first, each with the reason it made the list. Reason is one short sentence, for example "Mrs Patel, her buyer's mortgage offer expires in 9 days and the survey was booked but not done". Built by composing `priority-ranker` and `variance-narrator`.
+
+## Continuous learning hooks
+
+The morning round is the highest-volume source of learning signals in the product because it runs daily and the operator's behaviour after reading it is observable. Every signal below is written through `profile-writer`, never inline.
+
+- Skip pattern per source. If the operator never acts on lukewarm enquiries from a specific portal, that source's weight in `enquiry-triage` drops over time.
+- Stalled threshold drift. "I don't consider this stalled until day 10" updates the threshold immediately. Consistently acting at day 5 tightens it automatically.
+- Top-three accuracy. When the operator actions an item from the top three the same day, the ranking is correct. When they action a lower item instead, `priority-ranker` reweights toward whatever feature distinguished the actioned item.
+- Delivery time. If the operator asks for the round before the scheduled time, schedule earlier. If they ignore it for hours, schedule later or move to on-demand only.
+- Section preferences. "Lead with stalled deals, not the diary" reorders permanently. "Drop the awaiting-reply section, it's noise" hides it and surfaces those items in `chase-progression` instead.
+
+## Approval gates
+
+None. The workflow is read-only.
+
+## Cross-references
+
+The chase-progression workflow uses the same `chain-progression-tracker` skill to build its single-deal deep dives. The morning round produces the across-pipeline view; `chase-progression` expands any stalled item the operator names.
+
+## Profile keys this skill reads
+
+- `realagent.morning_round.delivery_channel`
+- `realagent.morning_round.delivery_time`
+- `realagent.morning_round.section_order`
+- `realagent.morning_round.hidden_sections`
+- `realagent.stalled_threshold_days.vendor`
+- `realagent.stalled_threshold_days.buyer`
+- `realagent.stalled_threshold_days.solicitor`
+- `realagent.stalled_threshold_days.broker`
+- `realagent.stalled_threshold_days.surveyor`
+- `realagent.awaiting_reply_lookback_days`

package/payload/premium-plugins/real-agency/plugins/listings/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "real-agency-listings",
-  "description": "Listing presentations, property marketing campaigns, and home preparation guidance for UK estate agents.",
+  "description": "Valuation prep and new-instruction onboarding for UK residential sales agents. Includes the valuation-prep master plus four building blocks (comparable-finder, local-market-stats, pricing-scenario-builder, talk-track-composer) and the new-instruction master plus its six building blocks (terms-of-business-drafter, epc-checker, supplier-booker, listing-copy-writer, particulars-builder, portal-launch-scheduler). Also retains the existing listing-presentation, property-marketing, and home-preparation skills.",
   "version": "0.1.0",
   "author": {
     "name": "Rubytech LLC"

package/payload/premium-plugins/real-agency/plugins/listings/PLUGIN.md

@@ -1,33 +1,64 @@
 ---
 name: real-agency-listings
-description: "Listing presentations, property marketing campaigns, and home preparation guidance for UK estate agents."
+description: "Valuation prep and new-instruction onboarding for UK residential sales agents. Includes the valuation-prep master plus four building blocks (comparable-finder, local-market-stats, pricing-scenario-builder, talk-track-composer) and the new-instruction master plus its six building blocks (terms-of-business-drafter, epc-checker, supplier-booker, listing-copy-writer, particulars-builder, portal-launch-scheduler). Also retains the existing listing-presentation, property-marketing, and home-preparation skills."
 tools: []
+skills:
+  - skills/valuation-prep/SKILL.md
+  - skills/comparable-finder/SKILL.md
+  - skills/local-market-stats/SKILL.md
+  - skills/pricing-scenario-builder/SKILL.md
+  - skills/talk-track-composer/SKILL.md
+  - skills/new-instruction/SKILL.md
+  - skills/terms-of-business-drafter/SKILL.md
+  - skills/epc-checker/SKILL.md
+  - skills/supplier-booker/SKILL.md
+  - skills/listing-copy-writer/SKILL.md
+  - skills/particulars-builder/SKILL.md
+  - skills/portal-launch-scheduler/SKILL.md
+  - skills/listing-presentation/SKILL.md
+  - skills/property-marketing/SKILL.md
+  - skills/home-preparation/SKILL.md
 always: false
 metadata: {"platform":{"optional":true,"embed":["admin"]}}
 ---
 
-# Real Agency — Listings & Marketing
+# Real Agency, Valuations and New Instructions
 
-Three skills covering pre-listing preparation through property marketing execution.
+Fifteen skills covering the two listings-side master workflows (valuation-prep, new-instruction) plus the listing-presentation and marketing skills.
 
 ## When to Activate
 
-The user is preparing listing presentations, creating property marketing campaigns, or advising vendors on home staging and photography preparation.
+The user is preparing for a valuation or market appraisal, has just won an instruction, or is asking about the listing-presentation, property-marketing, or home-preparation flow.
 
 ## Skills
 
-| Skill | Purpose |
-|-------|---------|
-| `listing-presentation` | Full listing presentation framework — booking through to winning the instruction |
-| `property-marketing` | Property marketing campaigns — Coming Soon, BLAST formula, direct mail, scorecards |
-| `home-preparation` | Vendor guidance on staging, photography prep, kerb appeal, seasonal advice |
+| Skill | Owner specialist | Purpose |
+|-------|------------------|---------|
+| `valuation-prep` | valuer | Master workflow: the pre-appointment pack |
+| `comparable-finder` | valuer | Pulls and ranks comparable evidence |
+| `local-market-stats` | valuer | Three context numbers for the prep pack |
+| `pricing-scenario-builder` | valuer | Generates the pricing options |
+| `talk-track-composer` | valuer | Drafts vendor questions, objections, USP |
+| `new-instruction` | valuer then negotiator | Master workflow: terms to portal in 72 hours |
+| `terms-of-business-drafter` | compliance | Populates the agency template and stages DocuSign |
+| `epc-checker` | valuer | EPC register lookup and order staging |
+| `supplier-booker` | negotiator | Photographer and floorplan bookings |
+| `listing-copy-writer` | negotiator | Portal-optimised descriptions, material info |
+| `particulars-builder` | negotiator (chains into Maxy `content-producer` for PDF render) | Property brochure |
+| `portal-launch-scheduler` | negotiator | Schedules and stages the portal uploads |
+| `listing-presentation` | negotiator | Listing presentation framework (existing) |
+| `property-marketing` | negotiator | Property marketing campaigns (existing) |
+| `home-preparation` | negotiator | Vendor staging guidance (existing) |
 
 ## Tools Used
 
 No MCP server. Skills operate via existing platform tools:
-- `memory-search` — retrieve domain knowledge from the knowledge base
-- `render-component` — present structured choices during interactions
+
+- `memory-search` for domain knowledge
+- `render-component` for structured choices
+- `profile-read` and `profile-update` for the customisation profile
+- `action-pending`, `action-approve`, `action-reject`, `action-edit` for the eight approval gates in new-instruction
 
 ## References
 
-Domain knowledge files loaded on demand by each skill. See individual skill files for their specific reference listings.
+Domain knowledge files loaded on demand by each skill.

package/payload/premium-plugins/real-agency/plugins/listings/skills/comparable-finder/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: comparable-finder
+description: "Pull and rank comparable evidence for a valuation prep pack. Returns three SSTC and three sold in the last 12 months within the profile's comparable radius. Built for use inside valuation-prep; the operator does not invoke it directly."
+---
+
+# Comparable finder
+
+A building-block skill called by `valuation-prep` to assemble the comparables section.
+
+## What it does
+
+Given a subject property, the skill queries the portal data feeds and Land Registry within the profile's comparable radius (default 0.5 miles). It picks six properties: three sold subject to contract and three sold and completed in the last 12 months.
+
+Selection criteria, in priority order:
+
+1. Location proximity. Same street ranks above same postcode, which ranks above adjacent postcode.
+2. Property type match. Detached with detached, semi with semi, flat with flat.
+3. Size match. Similar bedroom count, then similar square footage when known.
+4. Tenure match. Freehold with freehold, leasehold with leasehold.
+5. Condition match if observable. Similar standard of finish, similar age.
+
+The profile's exclude filters apply: distressed sales, off-market sales, agent-bought sales, probate sales, anything the operator has previously asked to exclude.
+
+## Output shape
+
+A table, one row per comparable, six rows total when data permits. Columns:
+
+- Address
+- Asking or sold price
+- Beds
+- Square footage (blank if unknown)
+- Time on market in days
+- Agent who marketed it
+
+A price-per-square-foot column is added only if at least four of the six rows have square footage. Showing it on a sparse set is misleading.
+
+If the radius is too tight to return three SSTC plus three sold, the skill widens the radius once and notes it in the output: "extended search to 0.75 miles to find six comparables".
+
+## What it does not do
+
+- It does not produce price recommendations. That is `pricing-scenario-builder`.
+- It does not write to anything.
+- It does not store the comparables for re-use; each appointment runs fresh, with the Pi 5 cache providing the speed.
+
+## Connectors
+
+Read: Rightmove, Zoopla, OnTheMarket data feeds; Land Registry. No writes.
+
+## Profile keys
+
+- `realagent.comparable_radius_miles` (default 0.5)
+- `realagent.comparable_exclude_filters` (list)

package/payload/premium-plugins/real-agency/plugins/listings/skills/epc-checker/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: epc-checker
+description: "Look up the EPC register for a property and decide whether an order is needed. Returns the current EPC rating and expiry if one exists, or stages an order request to the agent's preferred EPC supplier if not. Built for use inside new-instruction."
+---
+
+# EPC checker
+
+A building-block skill called by `new-instruction`. Decides whether the property has a current EPC and, if not, stages an order.
+
+## What it does
+
+Queries the EPC register by address. Three outcomes:
+
+1. **Current EPC found.** Records the asset rating (A to G), the certificate reference, and the expiry date. The workflow records this in the CRM and moves on. No gate needed.
+2. **Expired EPC found.** Records the prior rating and the expiry date. Stages an order with the agent's preferred EPC supplier from the profile. *Gate: approve order before send.*
+3. **No EPC found.** Stages an order. *Gate: approve order before send.*
+
+The order is an email draft to the supplier with the property address, vendor contact, and the agent's standard EPC brief.
+
+## Compliance ground
+
+The Energy Performance of Buildings (England and Wales) Regulations 2012 (SI 2012/3118) require an EPC before marketing for sale. The asset rating must be stated in all commercial media. Domestic penalty range GBP 500 to GBP 5,000. `compliance-flag-checker` runs over the listing copy at step 5 of `new-instruction` to make sure the EPC rating is present once the certificate has been issued.
+
+## What it does not do
+
+- It does not perform the EPC inspection. That is the supplier.
+- It does not send the order. Sending requires the operator's approval.
+- It does not write to the EPC register.
+
+## Connectors
+
+Read: EPC register, profile (preferred supplier).
+Write (staged only): email to supplier.
+
+## Profile keys
+
+- `realagent.suppliers.epc`
+- `realagent.epc_order.standard_brief` (default email body, learned)

package/payload/premium-plugins/real-agency/plugins/listings/skills/listing-copy-writer/SKILL.md

@@ -0,0 +1,55 @@
+---
+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)

package/payload/premium-plugins/real-agency/plugins/listings/skills/local-market-stats/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: local-market-stats
+description: "Compute the three context numbers for the valuation prep pack: average days on market, asking-to-sold ratio, current stock count. Built for use inside valuation-prep; the operator does not invoke it directly."
+---
+
+# Local market stats
+
+A building-block skill called by `valuation-prep`. Returns three numbers, no more. This section is context, not headline; four numbers feels like a research paper, two feels thin.
+
+## What it produces
+
+For the immediate area around the subject property (same postcode sector, or wider if the sector has fewer than 10 transactions in the lookback window):
+
+1. **Average days on market.** Median time from list to sold-subject-to-contract, over the last 90 days, for the property type that matches the subject.
+2. **Asking-to-sold ratio.** Median sold price as a percentage of original asking price, last 90 days, same property type. A number under 95% signals a soft market; over 100% signals competition.
+3. **Current stock count.** How many active listings of the matching type are on the portals right now.
+
+Each number shows the lookback window and the property-type filter so the operator can challenge any of them in conversation with the vendor.
+
+## What it does not do
+
+- It does not produce trend narratives. That is `variance-narrator`, called separately when the round needs a comparison sentence.
+- It does not surface recent fall-throughs as a number; if the count is non-trivial it is flagged in one sentence under the stats.
+- It does not write to anything.
+
+## Connectors
+
+Read: Rightmove, Zoopla, OnTheMarket data feeds; Land Registry. No writes.
+
+## Profile keys
+
+- `realagent.market_stats.lookback_days` (default 90)
+- `realagent.market_stats.area_definition` ("postcode_sector" | "1_mile_radius" | "ward", default "postcode_sector")

package/payload/premium-plugins/real-agency/plugins/listings/skills/new-instruction/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: new-instruction
+description: "Run the post-win onboarding sequence after a valuation is won. Drafts terms of business, checks the EPC, books photographer and floorplan supplier, drafts listing copy and PDF particulars, schedules portal launch, and drafts the vendor welcome. Each write action is individually gated. Triggers when the operator says 'set up <address>', 'I won <name>', 'I won the <address> val', 'instruction taken at <address>', 'get <address> on the market', 'kick off the <name> property'. Also offered proactively when the CRM marks a property as instructed."
+---
+
+# New instruction
+
+The master workflow that takes a property from "instruction won" to "on the portal" inside 72 hours. Owned jointly by the valuer (until terms are signed and the EPC is confirmed) and the negotiator (from photography onward).
+
+Done well, this workflow is the second-highest-value moment in the agent's week after winning the instruction itself. The speed compounds: faster on-market means more viewings in the first weekend, which is when offers happen.
+
+## Inputs
+
+- The property address.
+- The vendor name and contact details (read from the CRM record created at the appointment).
+- The fee structure agreed at the appointment, captured verbally by the operator or read from the diary notes.
+- The customisation profile.
+
+If any input is missing, the workflow asks once and then proceeds with the rest staged.
+
+## Architecture principles encoded here
+
+- Read before write. The workflow opens by reading the property's CRM state, the EPC register, and the calendar. It writes nothing until the operator approves each individual stage.
+- Stage, don't send. Every write action is staged, not fired. Eight gates in total, each individually approved.
+- One screen of output. The sequenced checklist is one screen even when every item is staged. Each item collapses to a status line.
+- Cite the source. Every populated field in the terms of business, the listing copy, and the particulars traces to a CRM record, a profile entry, or a connector read.
+- Teach the profile. Learning hooks below.
+- Reversible. Every staged item can be cancelled before approval. Approved items create CRM activity records the operator can rescind.
+
+## Sequence and approval gates
+
+The workflow presents the eight steps in order. The operator can approve them one at a time, approve everything ("ship everything"), or pause and return later. State is preserved between sessions.
+
+1. **Terms of business.** Drafted by `terms-of-business-drafter` from the agency template, populated with property, vendor, fee structure, sole or multi agency, marketing period, withdrawal fee. Staged in DocuSign with the vendor as recipient. *Gate: approve before send.*
+2. **EPC check.** `epc-checker` looks up the EPC register. If a current EPC exists, the workflow records the expiry date and moves on, no gate needed. If not, an order is staged with the agent's preferred supplier from the profile. *Gate: approve order before send if no current EPC.*
+3. **Photographer booking.** `supplier-booker` drafts a booking request to the agent's preferred photographer with the property address, vendor contact, and the agent's standard brief. *Gate: approve before send.*
+4. **Floorplan booking.** Same as photography. Combined into a single booking request if the same supplier handles both. *Gate: approve before send.*
+5. **Listing copy.** Drafted by `listing-copy-writer` in the agent's voice, length, and structure from the profile. Headline, key features bullets, full description, location paragraph. Optimised for the profile's portals. *Gate: approve before any portal upload.*
+6. **Particulars.** PDF brochure built by `particulars-builder`. The skill chains into the Maxy `content-producer` for the PDF render so the agency brand is applied consistently. Staged for the agent's review and the vendor's review before any wider distribution. *Gate: approve distribution before send.*
+7. **Portal launch schedule.** `portal-launch-scheduler` proposes the launch sequence (Rightmove premium on a Friday by default; learns). Staged, not fired. *Gate: approve schedule before any portal upload happens.*
+8. **Vendor welcome email.** Drafted by `tone-matched-drafter` explaining what happens next, what to expect, when to expect photos, who will be in touch. *Gate: approve before send.*
+
+## AML and material information
+
+AML on the vendor must be passed before any marketing goes live. The workflow does not run AML itself; it stages a request to the agent's preferred AML provider and blocks portal launch until the AML status is "passed". If the operator overrides ("I know this vendor, push it live now"), the override is logged with a compliance flag and the AML check is still queued.
+
+Material information for portal listings (council tax band, tenure, ground rent if leasehold, and the rest of the DMCCA 2024 fields) is gathered into the listing copy. Missing items are flagged before the operator approves the copy. `compliance-flag-checker` runs against every output of this workflow before approval.
+
+## Continuous learning hooks
+
+- Supplier preferences. If the operator routinely overrides the suggested photographer, EPC supplier, floorplan supplier, or AML provider, the new preferred supplier is learned.
+- Copy voice and length. Edit-before-send diffs on the listing copy feed `listing-copy-writer`. Within a month, drafts should need minimal editing.
+- Launch timing. Friday morning is a heuristic default. If the agent consistently launches on a different day, around school holidays, around area events, or around a sale calendar, the scheduler picks that up.
+- Particulars structure. Section order, photo count, whether the floorplan goes early or late, whether the location paragraph leads or trails, all adapt.
+- Fee structure drift. A single override is a one-off. Three same-direction overrides in a month update the profile's default fee logic.
+
+All writes go through `profile-writer`.
+
+## Connectors
+
+Read: CRM, EPC register, calendar, profile.
+Write: DocuSign (terms), email (vendor welcome, supplier bookings), portal upload APIs (Rightmove, Zoopla, OnTheMarket, staged only).
+
+## Profile keys
+
+- `realagent.fee_structure.default` (sole or multi, percentage, minimum)
+- `realagent.fee_structure.withdrawal_fee`
+- `realagent.fee_structure.marketing_period_weeks`
+- `realagent.suppliers.photographer`
+- `realagent.suppliers.floorplan`
+- `realagent.suppliers.epc`
+- `realagent.suppliers.aml_provider`
+- `realagent.listing_copy.length_words` (target word count, learned)
+- `realagent.listing_copy.section_order`
+- `realagent.particulars.template_path`
+- `realagent.portal_launch.preferred_day` (default Friday)
+- `realagent.portal_launch.preferred_time`
+- `realagent.portal_launch.rightmove_tier` ("standard" | "premium" | "premium_listing")

package/payload/premium-plugins/real-agency/plugins/listings/skills/particulars-builder/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: particulars-builder
+description: "Compose the PDF property brochure for a new instruction from the listing copy and the photography. Stages the brochure for the agent's review and the vendor's review before any wider distribution. Built for use inside new-instruction; chains into the Maxy content-producer skill for the PDF render."
+---
+
+# Particulars builder
+
+A building-block skill called by `new-instruction`. Composes the property brochure.
+
+## What it does
+
+Reads the agency's brochure template path from the profile, then assembles the brochure content:
+
+- Cover with headline, hero photograph, address, asking price
+- Floorplan page
+- Photography gallery in the profile's preferred order
+- Description and key features, copied from the approved listing copy
+- Location paragraph and a small location map
+- Agency footer with branding, contact details, CMP and redress scheme markings
+
+The skill hands the content to the Maxy `content-producer` skill for the PDF render. That step is where the agency brand is applied to a print-ready file. Particulars are A4, two-fold or three-fold depending on the profile.
+
+## Approval flow
+
+The PDF is staged in two places at once:
+
+1. The agent's review surface, with one-click approve or "redraft with changes".
+2. A vendor-review draft email is prepared, ready to send when the agent approves.
+
+The brochure is not distributed to portals or to the public until the agent and the vendor both approve.
+
+## What it does not do
+
+- It does not generate brand assets. The agency template from onboarding is the source of brand styling.
+- It does not write listing copy. That is `listing-copy-writer`.
+- It does not commission photography.
+
+## Connectors
+
+Read: profile (template path, photography order, agency branding), CRM (property, vendor, listing copy from step 5 of new-instruction).
+Write: PDF artefact in the agent's Drive, draft email to vendor (staged only).
+
+## Profile keys
+
+- `realagent.particulars.template_path`
+- `realagent.particulars.photo_count` (target, default 12, learned)
+- `realagent.particulars.section_order` (e.g. floorplan early or late, learned)
+- `realagent.particulars.location_paragraph_position` ("lead" | "trail", learned)

package/payload/premium-plugins/real-agency/plugins/listings/skills/portal-launch-scheduler/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: portal-launch-scheduler
+description: "Propose a launch sequence for a new listing across Rightmove, Zoopla, and OnTheMarket, with viewings opened for the weekend. Stages the upload; nothing fires without the operator's approval. Built for use inside new-instruction."
+---
+
+# Portal launch scheduler
+
+A building-block skill called by `new-instruction`. Proposes the launch sequence and stages the portal uploads.
+
+## What it produces
+
+A schedule, one row per portal, showing:
+
+- Portal name (Rightmove, Zoopla, OnTheMarket)
+- Listing tier (standard or premium where the profile names a tier)
+- Go-live date and time
+- Viewing slots opened for the weekend
+- Any portal-specific fields that need confirmation before upload
+
+The default sequence is Rightmove premium on a Friday morning, Zoopla and OnTheMarket simultaneously, viewings opened for the weekend. The schedule is the heuristic default; the scheduler learns the agent's preferred day and time over time.
+
+## Blocking conditions
+
+The launch is blocked until:
+
+1. The AML status on the vendor is "passed" (or the operator explicitly overrides, in which case the override is logged with a compliance flag).
+2. The listing copy has been approved by the operator.
+3. The particulars have been approved by both the agent and the vendor.
+4. The EPC certificate is in hand and its rating is in the listing copy.
+
+If any block applies, the schedule shows what is blocked and what the blocker is, so the operator knows exactly what to clear before approval.
+
+## What it does not do
+
+- It does not fire the uploads on its own. Approval is required per the gate in `new-instruction` step 7.
+- It does not produce the listing copy.
+- It does not amend listings after launch. Post-launch edits are a separate flow.
+
+## Connectors
+
+Read: profile (portal preferences, default day and time, Rightmove tier), CRM (property, listing copy, AML status, EPC).
+Write (staged only): portal upload APIs (Rightmove, Zoopla, OnTheMarket).
+
+## Profile keys
+
+- `realagent.portal_launch.preferred_day` (default Friday)
+- `realagent.portal_launch.preferred_time` (default 09:00)
+- `realagent.portal_launch.rightmove_tier`
+- `realagent.portal_launch.viewing_slots_per_day` (default 8, learned)

package/payload/premium-plugins/real-agency/plugins/listings/skills/pricing-scenario-builder/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: pricing-scenario-builder
+description: "Generate the pricing scenarios block for the valuation prep pack. Default output is three numbers (quick-sale, market, aspirational) each with one sentence of reasoning. The format adapts to the profile's preference. Built for use inside valuation-prep."
+---
+
+# Pricing scenario builder
+
+A building-block skill called by `valuation-prep`. Reads the comparables and the local stats already gathered, then produces the pricing block in the format the profile names.
+
+## Three default scenarios
+
+1. **Quick-sale price.** What the property would likely sell for in under 30 days, priced to attract immediate offers. Anchored on the lower comparable cluster.
+2. **Market price.** The 30 to 60 day expectation, priced in line with the strongest comparables. The default headline number.
+3. **Aspirational price.** The 90 day plus number with a stretch caveat, priced to test the ceiling.
+
+Each scenario has one sentence of reasoning naming the comparables or the stat that supports it. The reasoning is plain language, no jargon.
+
+## Format adaptation
+
+If the profile records that the operator has corrected the output toward a single recommendation with a range, the skill outputs that shape instead: a single number with a low-to-high band. If the operator has corrected toward a single number with no range, that is the output. The default is three scenarios because vendors anchor on the spread before they anchor on the headline.
+
+## What it does not do
+
+- It does not name a fee. Fee structure is in the terms of business produced by `terms-of-business-drafter`.
+- It does not commit to a number with the vendor. The market appraisal is a professional opinion, not a guarantee. The agent does that in the room.
+- It does not write to anything.
+
+## Connectors
+
+Read: portal data and Land Registry through the comparables already passed in by `valuation-prep`. No direct connector calls. No writes.
+
+## Profile keys
+
+- `realagent.pricing_format` ("three_scenarios" | "single_with_range" | "single_number")
+- `realagent.pricing.aspirational_caveat_phrase` (learned)

package/payload/premium-plugins/real-agency/plugins/listings/skills/supplier-booker/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: supplier-booker
+description: "Draft and stage booking requests to photographer, floorplan supplier, and other property-prep suppliers from the agent's preferred-supplier list. Built for use inside new-instruction."
+---
+
+# Supplier booker
+
+A building-block skill called by `new-instruction`. Stages the booking emails that get the photographer and the floorplan supplier into the property in the first 48 hours after instruction.
+
+## What it does
+
+For each supplier the workflow needs to book (photographer, floorplan, and optionally a combined supplier when one provider handles both), the skill drafts an email to the agent's preferred supplier from the profile. The draft includes:
+
+- Property full address with postcode
+- Access details (vendor contact, key location, lockbox code, alarm code) read from the CRM record
+- The agent's standard brief for that supplier (photography style preferences, number of shots, floorplan format)
+- Preferred date range
+- Reply-to address
+
+If the photographer and floorplan supplier are the same provider, the skill combines them into one booking request rather than sending two emails.
+
+## What it does not do
+
+- It does not send. Sending requires the operator's approval.
+- It does not book the supplier into the calendar. The supplier confirms back, then the calendar entry is created.
+- It does not pay the supplier or set up an invoice. Supplier payment runs through `month-end-close`.
+
+## Connectors
+
+Read: profile (preferred suppliers, briefs), CRM (vendor contact, access details).
+Write (staged only): email to each supplier.
+
+## Profile keys
+
+- `realagent.suppliers.photographer`
+- `realagent.suppliers.floorplan`
+- `realagent.suppliers.combined` (boolean, true if one provider handles both)
+- `realagent.suppliers.brief.photography` (default brief, learned)
+- `realagent.suppliers.brief.floorplan`

package/payload/premium-plugins/real-agency/plugins/listings/skills/talk-track-composer/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: talk-track-composer
+description: "Draft the talk-track block for the valuation prep pack: three questions for the vendor, two likely objections, the agent's USP in the agent's voice. Built for use inside valuation-prep."
+---
+
+# Talk-track composer
+
+A building-block skill called by `valuation-prep`. Produces the prompt the agent uses in the room.
+
+## What it produces
+
+Three sub-sections, in this order.
+
+1. **Questions to ask the vendor.** Three open questions tailored to the property and the vendor's situation. Examples vary with context: timeline pressure, chain position, prior agent contact, fee sensitivity.
+2. **Likely objections.** Two objections most likely to come up, given the comparables and the local stats. Each shown with a one-sentence acknowledgement and a one-sentence response in the agent's voice.
+3. **The USP.** The agent's USP framed in the agent's words, from the profile's voice samples. The phrasing tightens over time as the workflow watches which phrasings get used versus edited.
+
+## Voice source
+
+The skill reads the profile's voice samples (three to five emails the agent has written) and prior successful talk-tracks. If voice samples are not yet seeded, the output uses a generic professional tone and flags the absence so the operator knows to add samples.
+
+## What it does not do
+
+- It does not draft messages to send. That is `tone-matched-drafter`.
+- It does not write to anything.
+- It does not pretend to know the vendor when the CRM record has no prior contact. If the vendor is new, the questions are designed to learn rather than to anchor.
+
+## Connectors
+
+Read: profile (voice samples), CRM (vendor history if any). No writes.
+
+## Profile keys
+
+- `realagent.voice_samples` (list of email bodies, used for tone extraction)
+- `realagent.usp_phrases` (list, learned)
+- `realagent.objection_responses` (map of common objections to preferred responses, learned)