Workshop docs

The documents that ARE the process

The whole comp process is three plain-English files. Download them, read them, rewrite them — that is the workshop.

The documents

SKILL.md
The method — how comps get done		ReadDownload
PREFERENCES.md
The standards — what you personalise		ReadDownload
field-map.md
The data — which columns matter		ReadDownload
The full skill
All three docs, zipped, ready to upload to claude.ai		Download .zip

Docs only — the MLS dataset is permissioned and distributed in the room, not here.

The three demo versions, with their edits highlighted

Each version changes ONLY PREFERENCES.md. The viewer shows that version's full document: lines it changed or addeddefault lines it removed.

alt-b — The PROCESS: 6-month lookback, 0.75-mile radius, stay in the subject's tract, 10% size band, top 5 comps only.

Download this version

1# My comp standards
2 
3This file is mine. Claude reads it every run and follows it. When I say
4"I never go past six months" in a conversation, the fix is to edit THIS FILE,
5not to remember to say it again next time.
6 
7How to edit it depends on where the skill runs:
8- **Workshop gateway:** tell Claude the change in chat; it saves a named
9 version and runs under it. Download your version any time to take home.
10- **Your own claude.ai:** edit this file, re-zip the skill folder, re-upload
11 under Settings → Capabilities → Skills.
12- **Claude Code:** edit this file in place; the next run reads it.
13 
14## Search window
15 
- Look back **12 months** from today.
- Search radius: **2 miles** from the subject (Ladera Ranch is compact).
- I want **at least 3** comps; show me **at most 8**.
16- Look back **6 months** from today. Older closes are history, not market.
17- Search radius: **0.75 miles** from the subject. Walkable or it is not my comp.
18- I want **at least 3** comps; show me **at most 5**. Five good ones beat eight loose ones.
19 
20## Hard walls — never cross these
21 
22- **Never mix markets.** Sales comp a value; leases comp a rent. The dataset
23 holds both — a comp set contains exactly one kind.
24- **Never mix property types.** Detached with detached, condo with condo,
25 townhouse with townhouse. When in doubt, attached and detached never mix.
26- Never use "Rooms for Rent" or mixed commercial listings.
27- Only closed sales/leases count as comps.
28- If these walls leave too few comps, tell me — do not relax them.
29 
30## Match priority (best comp first)
31 
32- **Stay inside the subject's tract** whenever it has any qualifying closes;
33 leave the tract only when it has none, and say so.
34 
351. Same tract, same model — nearly the same house.
362. Same tract, very close size.
373. Same model in a neighbouring tract.
384. Close size + exact bed/bath + same story count, nearby.
39 
- Living area within **15%** of the subject; the closer the better.
40- Living area within **10%** of the subject; the closer the better.
41- Within **1 bedroom** and **1 bathroom**; exact matches rank first.
42- Same number of stories strongly preferred — a two-story and a single-level
43 are different products.
44- Year built within **15 years**.
45 
46## The subject
47 
48- The subject is usually NOT in the listing data. Ask me for its specs, or
49 better, tell me to paste the Zillow/Redfin details, and build the profile
50 from that.
51- Confirm the subject profile in one line before running.
52- If the subject's location is approximated from its street or tract, say so
53 on the map and in the report.
54 
55## What differences are worth (monthly rent)
56 
57- Bedroom: **$150** · Bathroom: **$100** · Garage space: **$75**
58- Year newer: **$5** · Furnished: **$400** · View: **$150** · Pool: **$150**
59- Ignore size differences under **25 sqft**.
60 
61## What differences are worth (sale price)
62 
63- Bedroom: **$15,000** · Bathroom: **$10,000** · Garage space: **$8,000**
64- Year newer: **$500** · View: **$25,000** · Pool: **$30,000**
65 
66## Adjustment limits
67 
68- Flag a comp when net adjustment passes **25%** of its price, or gross passes
69 **40%**.
70 
71## The report (report.html)
72 
73Content:
74- Title: **Comparable Market Analysis**. Prepared by: **Ladera Realty**.
75- State the mode (sale value or monthly rent), the lookback window and the
76 radius, right under the headline figure.
77- Comp table columns: #, address, **MLS ID**, tract, closed date, distance,
78 beds, baths, sqft, stories, closed price, $/sqft, net adjustment, adjusted
79 price. IDs and prices exactly as in the data — the table is the audit trail.
80- Round the INDICATED value to the nearest **$1,000** for sales, **$25** for
81 rents. Price per square foot to **2 decimals**. Dates like **Aug 23, 2026**.
82- Always show why listings were excluded, grouped by reason.
83- Cite any shared commentary that influenced a selection or adjustment.
84 
85Design — this page goes in front of clients:
86- Warm editorial look: ivory background (#FAF7F2), near-black ink (#26231F),
87 olive accent (#6B7A46), hairline rules (#E4DFD5). Dark-mode variant of the
88 same palette via prefers-color-scheme.
89- Serif display headings (Georgia/serif stack), system sans for body and
90 tables. Generous whitespace; max content width ~760px, centered.
91- The indicated figure is the hero: large, top of page, olive underline.
92- Tables: right-aligned numerals with tabular figures, hairline row rules, no
93 heavy grid. Flag rows (over adjustment limits) marked with a small olive dot
94 and a footnote, not shouting colors.
95- Print-friendly: clean at 8.5x11, no dark backgrounds when printed.
96- No lorem, no placeholders, no empty sections — omit what has no content.
97 
98## The map (map.html)
99 
100- Always produce it, and it must be a REAL street map (Leaflet +
101 OpenStreetMap, no key, no account) — never an abstract dot plot.
102- Numbered pins matching the report table, a distinct subject marker,
103 quarter- and half-mile dashed rings, and the comp table below the map as
104 the offline fallback.
105- Hovering a pin shows a tooltip with the address, specs (beds/baths/sqft)
106 and price; clicking it shows the full popup with tract, close date,
107 distance and a Google Maps link.
108- **Every comp pin visible, always.** Condo complexes share one MLS geocode -
109 fan stacked pins out around the shared point rather than letting them bury
110 each other, and mark the true location with a dot.
111- **Shade pins by close recency** - darkest for the last 3 months, fading in
112 3-month bands to the oldest - with a legend on the map showing the bands,
113 the subject marker and the shared-geocode dot.
114 
115## Hard rules
116 
117- A failed arithmetic check means the report is stamped FAILED at the top.
118- Too few comps is a FAILED report, not a quietly widened search.
119- Ask before loosening anything in this file.
alt-c — The MATH: straight median instead of weighted reconciliation, much bigger bed/bath adjustments, coarser honest rounding.

Download this version

1# My comp standards
2 
3This file is mine. Claude reads it every run and follows it. When I say
4"I never go past six months" in a conversation, the fix is to edit THIS FILE,
5not to remember to say it again next time.
6 
7How to edit it depends on where the skill runs:
8- **Workshop gateway:** tell Claude the change in chat; it saves a named
9 version and runs under it. Download your version any time to take home.
10- **Your own claude.ai:** edit this file, re-zip the skill folder, re-upload
11 under Settings → Capabilities → Skills.
12- **Claude Code:** edit this file in place; the next run reads it.
13 
14## Search window
15 
16- Look back **12 months** from today.
17- Search radius: **2 miles** from the subject (Ladera Ranch is compact).
18- I want **at least 3** comps; show me **at most 8**.
19 
20## Hard walls — never cross these
21 
22- **Never mix markets.** Sales comp a value; leases comp a rent. The dataset
23 holds both — a comp set contains exactly one kind.
24- **Never mix property types.** Detached with detached, condo with condo,
25 townhouse with townhouse. When in doubt, attached and detached never mix.
26- Never use "Rooms for Rent" or mixed commercial listings.
27- Only closed sales/leases count as comps.
28- If these walls leave too few comps, tell me — do not relax them.
29 
30## Match priority (best comp first)
31 
321. Same tract, same model — nearly the same house.
332. Same tract, very close size.
343. Same model in a neighbouring tract.
354. Close size + exact bed/bath + same story count, nearby.
36 
37- Living area within **15%** of the subject; the closer the better.
38- Within **1 bedroom** and **1 bathroom**; exact matches rank first.
39- Same number of stories strongly preferred — a two-story and a single-level
40 are different products.
41- Year built within **15 years**.
42 
43## The subject
44 
45- The subject is usually NOT in the listing data. Ask me for its specs, or
46 better, tell me to paste the Zillow/Redfin details, and build the profile
47 from that.
48- Confirm the subject profile in one line before running.
49- If the subject's location is approximated from its street or tract, say so
50 on the map and in the report.
51 
52## What differences are worth (monthly rent)
53 
- Bedroom: **$150** · Bathroom: **$100** · Garage space: **$75**
54- Bedroom: **$400** · Bathroom: **$250** · Garage space: **$75**
55- Year newer: **$5** · Furnished: **$400** · View: **$150** · Pool: **$150**
- Ignore size differences under **25 sqft**.
56- Ignore size differences under **100 sqft** - below that it is noise.
57 
58## What differences are worth (sale price)
59 
- Bedroom: **$15,000** · Bathroom: **$10,000** · Garage space: **$8,000**
60- Bedroom: **$40,000** · Bathroom: **$25,000** · Garage space: **$8,000**
61- Year newer: **$500** · View: **$25,000** · Pool: **$30,000**
62 
63## Reconciliation
64 
65- **Straight median of the adjusted comps. Do not weight.** I would rather
66 read an honest middle than a clever average.
67 
68## Adjustment limits
69 
70- Flag a comp when net adjustment passes **25%** of its price, or gross passes
71 **40%**.
72 
73## The report (report.html)
74 
75Content:
76- Title: **Comparable Market Analysis**. Prepared by: **Ladera Realty**.
77- State the mode (sale value or monthly rent), the lookback window and the
78 radius, right under the headline figure.
79- Comp table columns: #, address, **MLS ID**, tract, closed date, distance,
80 beds, baths, sqft, stories, closed price, $/sqft, net adjustment, adjusted
81 price. IDs and prices exactly as in the data — the table is the audit trail.
- Round the INDICATED value to the nearest **$1,000** for sales, **$25** for
rents. Price per square foot to **2 decimals**. Dates like **Aug 23, 2026**.
82- Round the INDICATED value to the nearest **$5,000** for sales, **$50** for
83 rents. Precision I cannot defend is theater. Price per square foot to **2 decimals**. Dates like **Aug 23, 2026**.
84- Always show why listings were excluded, grouped by reason.
85- Cite any shared commentary that influenced a selection or adjustment.
86 
87Design — this page goes in front of clients:
88- Warm editorial look: ivory background (#FAF7F2), near-black ink (#26231F),
89 olive accent (#6B7A46), hairline rules (#E4DFD5). Dark-mode variant of the
90 same palette via prefers-color-scheme.
91- Serif display headings (Georgia/serif stack), system sans for body and
92 tables. Generous whitespace; max content width ~760px, centered.
93- The indicated figure is the hero: large, top of page, olive underline.
94- Tables: right-aligned numerals with tabular figures, hairline row rules, no
95 heavy grid. Flag rows (over adjustment limits) marked with a small olive dot
96 and a footnote, not shouting colors.
97- Print-friendly: clean at 8.5x11, no dark backgrounds when printed.
98- No lorem, no placeholders, no empty sections — omit what has no content.
99 
100## The map (map.html)
101 
102- Always produce it, and it must be a REAL street map (Leaflet +
103 OpenStreetMap, no key, no account) — never an abstract dot plot.
104- Numbered pins matching the report table, a distinct subject marker,
105 quarter- and half-mile dashed rings, and the comp table below the map as
106 the offline fallback.
107- Hovering a pin shows a tooltip with the address, specs (beds/baths/sqft)
108 and price; clicking it shows the full popup with tract, close date,
109 distance and a Google Maps link.
110- **Every comp pin visible, always.** Condo complexes share one MLS geocode -
111 fan stacked pins out around the shared point rather than letting them bury
112 each other, and mark the true location with a dot.
113- **Shade pins by close recency** - darkest for the last 3 months, fading in
114 3-month bands to the oldest - with a legend on the map showing the bands,
115 the subject marker and the shared-geocode dot.
116 
117## Hard rules
118 
119- A failed arithmetic check means the report is stamped FAILED at the top.
120- Too few comps is a FAILED report, not a quietly widened search.
121- Ask before loosening anything in this file.
alt-d — The DELIVERABLE: same analysis, executive one-page report - navy and gold, summary first, detail in an appendix.

Download this version

1# My comp standards
2 
3This file is mine. Claude reads it every run and follows it. When I say
4"I never go past six months" in a conversation, the fix is to edit THIS FILE,
5not to remember to say it again next time.
6 
7How to edit it depends on where the skill runs:
8- **Workshop gateway:** tell Claude the change in chat; it saves a named
9 version and runs under it. Download your version any time to take home.
10- **Your own claude.ai:** edit this file, re-zip the skill folder, re-upload
11 under Settings → Capabilities → Skills.
12- **Claude Code:** edit this file in place; the next run reads it.
13 
14## Search window
15 
16- Look back **12 months** from today.
17- Search radius: **2 miles** from the subject (Ladera Ranch is compact).
18- I want **at least 3** comps; show me **at most 8**.
19 
20## Hard walls — never cross these
21 
22- **Never mix markets.** Sales comp a value; leases comp a rent. The dataset
23 holds both — a comp set contains exactly one kind.
24- **Never mix property types.** Detached with detached, condo with condo,
25 townhouse with townhouse. When in doubt, attached and detached never mix.
26- Never use "Rooms for Rent" or mixed commercial listings.
27- Only closed sales/leases count as comps.
28- If these walls leave too few comps, tell me — do not relax them.
29 
30## Match priority (best comp first)
31 
321. Same tract, same model — nearly the same house.
332. Same tract, very close size.
343. Same model in a neighbouring tract.
354. Close size + exact bed/bath + same story count, nearby.
36 
37- Living area within **15%** of the subject; the closer the better.
38- Within **1 bedroom** and **1 bathroom**; exact matches rank first.
39- Same number of stories strongly preferred — a two-story and a single-level
40 are different products.
41- Year built within **15 years**.
42 
43## The subject
44 
45- The subject is usually NOT in the listing data. Ask me for its specs, or
46 better, tell me to paste the Zillow/Redfin details, and build the profile
47 from that.
48- Confirm the subject profile in one line before running.
49- If the subject's location is approximated from its street or tract, say so
50 on the map and in the report.
51 
52## What differences are worth (monthly rent)
53 
54- Bedroom: **$150** · Bathroom: **$100** · Garage space: **$75**
55- Year newer: **$5** · Furnished: **$400** · View: **$150** · Pool: **$150**
56- Ignore size differences under **25 sqft**.
57 
58## What differences are worth (sale price)
59 
60- Bedroom: **$15,000** · Bathroom: **$10,000** · Garage space: **$8,000**
61- Year newer: **$500** · View: **$25,000** · Pool: **$30,000**
62 
63## Adjustment limits
64 
65- Flag a comp when net adjustment passes **25%** of its price, or gross passes
66 **40%**.
67 
68## The report (report.html)
69 
70Content:
71- Title: **Comparable Market Analysis**. Prepared by: **Ladera Realty**.
72- State the mode (sale value or monthly rent), the lookback window and the
73 radius, right under the headline figure.
74- Comp table columns: #, address, **MLS ID**, tract, closed date, distance,
75 beds, baths, sqft, stories, closed price, $/sqft, net adjustment, adjusted
76 price. IDs and prices exactly as in the data — the table is the audit trail.
77- Round the INDICATED value to the nearest **$1,000** for sales, **$25** for
78 rents. Price per square foot to **2 decimals**. Dates like **Aug 23, 2026**.
79- Always show why listings were excluded, grouped by reason.
80- Cite any shared commentary that influenced a selection or adjustment.
81 
Design — this page goes in front of clients:
- Warm editorial look: ivory background (#FAF7F2), near-black ink (#26231F),
olive accent (#6B7A46), hairline rules (#E4DFD5). Dark-mode variant of the
same palette via prefers-color-scheme.
- Serif display headings (Georgia/serif stack), system sans for body and
tables. Generous whitespace; max content width ~760px, centered.
- The indicated figure is the hero: large, top of page, olive underline.
- Tables: right-aligned numerals with tabular figures, hairline row rules, no
heavy grid. Flag rows (over adjustment limits) marked with a small olive dot
and a footnote, not shouting colors.
- Print-friendly: clean at 8.5x11, no dark backgrounds when printed.
82Design — an EXECUTIVE ONE-PAGER, built to be skimmed in ten seconds:
83- Modern boardroom look: white page, deep navy band across the top (#0F1B2D)
84 carrying the title and the indicated figure in gold (#C9A227), sans-serif
85 throughout (system-ui stack), tight and confident.
86- Page one is a summary, not a document: the hero figure, a five-line
87 executive summary (mode, window, radius, comp count, QA verdict), and a
88 compact comp strip - address, closed price, adjusted price. Nothing else.
89- Everything deeper - adjustment line items, exclusions, commentary citations -
90 goes in an APPENDIX section below a page break, clearly labeled.
91- Numerals right-aligned and tabular; gold used only for the hero figure and
92 flags; never more than two colors on the page.
93- Print-friendly: the navy band may print, everything else stays white.
94- No lorem, no placeholders, no empty sections — omit what has no content.
95 
96## The map (map.html)
97 
98- Always produce it, and it must be a REAL street map (Leaflet +
99 OpenStreetMap, no key, no account) — never an abstract dot plot.
100- Numbered pins matching the report table, a distinct subject marker,
101 quarter- and half-mile dashed rings, and the comp table below the map as
102 the offline fallback.
103- Hovering a pin shows a tooltip with the address, specs (beds/baths/sqft)
104 and price; clicking it shows the full popup with tract, close date,
105 distance and a Google Maps link.
106- **Every comp pin visible, always.** Condo complexes share one MLS geocode -
107 fan stacked pins out around the shared point rather than letting them bury
108 each other, and mark the true location with a dot.
109- **Shade pins by close recency** - darkest for the last 3 months, fading in
110 3-month bands to the oldest - with a legend on the map showing the bands,
111 the subject marker and the shared-geocode dot.
112 
113## Hard rules
114 
115- A failed arithmetic check means the report is stamped FAILED at the top.
116- Too few comps is a FAILED report, not a quietly widened search.
117- Ask before loosening anything in this file.