Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Data & analytics

nyc-property-report

Compile NYC landmarks, DOB, ACRIS, HPD, and BSA findings into one property due-diligence report. Use for a full report; use individual NYC skills for one dataset.

AlpacaLabsLLC · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add AlpacaLabsLLC/skills-for-architects --skill nyc-property-report

About this skill


name: nyc-property-report description: Compile NYC landmarks, DOB, ACRIS, HPD, and BSA findings into one property due-diligence report. Use for a full report; use individual NYC skills for one dataset. allowed-tools:

  • WebFetch
  • Write
  • Read
  • Bash

/as:nyc-property-report — Combined NYC Property Report

Harness note: use /as:<skill> on Claude Code and $<skill> on Codex. Resolve <skill-root> as the directory containing this loaded SKILL.md and <plugin-root> as the plugin root that contains skills/, and use equivalent native tools when host tool names differ.

Runs all 6 NYC property data lookups and produces a combined report. For individual lookups, use the standalone skills:

  • /as:nyc-landmarks — LPC landmark & historic district check
  • /as:nyc-dob-permits — DOB permit & filing history
  • /as:nyc-dob-violations — DOB & ECB violations
  • /as:nyc-acris — ACRIS property transaction records
  • /as:nyc-hpd — HPD violations, complaints & registration
  • /as:nyc-bsa — BSA variances & special permits

No API key required — all queries use NYC Open Data (Socrata) with PLUTO for address resolution.

Project context

If PROJECT.md exists in the working directory, read it before fetching — prior lookups may already be on file. After completing, offer identity facts (address, BBL, ownership), landmark status, and the open-violations summary to /as:project update for its Identity and Zoning sections, each with a source and date. No PROJECT.md? Skip silently — or mention /as:project init if the user is clearly starting a project.

Usage

/as:nyc-property-report 120 Broadway, Manhattan
/as:nyc-property-report 1000770001          (BBL)
/as:nyc-property-report 1001389             (BIN)

Steps 1–2: Parse Input & Resolve BBL/BIN

Read pluto-resolution.md (in this skill's directory) and follow it: parse the input (address, BBL, or BIN), resolve via PLUTO, and resolve BIN via Building Footprints.

This skill's extras: in addition to the base PLUTO field set, store zipcode, cd, bldgarea, unitstotal, histdist, numbldgs.

Step 3: Query All 6 Domains

Query each domain in sequence. If any query fails, note the error and continue with the next domain.

Read socrata-reference.md (in this skill's directory) — it is the single source of truth for every dataset ID and field name below. If a query here ever disagrees with it, the reference wins.

Domain 1: Landmarks

By BBL: https://data.cityofnewyork.us/resource/buis-pvji.json?bbl={BBL} Fallback by block + lot (NOT zero-padded): https://data.cityofnewyork.us/resource/buis-pvji.json?$where=block='{BLOCK}' AND lot='{LOT}' AND borough='{BOROUGH}'

Also check PLUTO histdist field — if set, property is in a historic district.

Key fields: lpc_name, lpc_lpnumb, desdate, landmarkty, lpc_sitede, lpc_sitest, lpc_altern, address, url_report

Domain 2: DOB Permits

IMPORTANT: Legacy datasets use bin__ (double underscore). DOB NOW uses bin.

Legacy permits: https://data.cityofnewyork.us/resource/ipu4-2q9a.json?$where=bin__='{BIN}'&$order=issuance_date DESC&$limit=30 Legacy filings: https://data.cityofnewyork.us/resource/ic3t-wcy2.json?$where=bin__='{BIN}'&$order=latest_action_date DESC&$limit=30 DOB NOW permits: https://data.cityofnewyork.us/resource/rbx6-tga4.json?$where=bin='{BIN}'&$order=approved_date DESC&$limit=30 DOB NOW filings: https://data.cityofnewyork.us/resource/w9ak-ipjd.json?$where=bin='{BIN}'&$order=filing_date DESC&$limit=30

Merge, sort by date DESC, group by job type (NB, A1, A2, A3, DM, Other).

Domain 3: DOB Violations

DOB violations: https://data.cityofnewyork.us/resource/3h2n-5cm9.json?$where=bin='{BIN}'&$order=issue_date DESC&$limit=50 ECB violations: https://data.cityofnewyork.us/resource/6bgk-3dad.json?$where=bin='{BIN}'&$order=issue_date DESC&$limit=50 Active violations: https://data.cityofnewyork.us/resource/sjhj-bc8q.json?$where=bin='{BIN}'

Flag open violations with ⚠. Show ECB penalties.

Domain 4: ACRIS

Requires BBL (not BIN). Uses separate borough/block/lot fields.

Step A — Legals: https://data.cityofnewyork.us/resource/8h5j-fqxa.json?borough={boro}&block={block}&lot={lot}&$order=good_through_date DESC&$limit=20 Step B — Master: https://data.cityofnewyork.us/resource/bnx9-e6tj.json?$where=document_id IN ('{id1}','{id2}',...)&$order=document_date DESC (fields: document_date, document_amt, recorded_datetime) Step C — Parties: https://data.cityofnewyork.us/resource/636b-3b5g.json?$where=document_id IN ('{id1}','{id2}',...) Step D — Doc codes: https://data.cityofnewyork.us/resource/7isb-wh4c.json?$limit=200

Join by document_id. Party type 1=Grantor, 2=Grantee. Group by doc type (Deeds, Mortgages, Other).

Domain 5: HPD

First check bldgclass — HPD only applies to residential (classes starting with A, B, C, D, R, S). If non-residential, skip with note.

Uses boroid (not borough) and separate block/lot fields.

Violations: https://data.cityofnewyork.us/resource/wvxf-dwi5.json?$where=boroid='{boro}' AND block='{block}' AND lot='{lot}'&$order=inspectiondate DESC&$limit=50 Open violations: https://data.cityofnewyork.us/resource/csn4-vhvf.json?$where=boroid='{boro}' AND block='{block}' AND lot='{lot}' Complaints (uses borough as TEXT — "MANHATTAN", "BROOKLYN", … — not boroid): https://data.cityofnewyork.us/resource/ygpa-z7cr.json?$where=borough='{BOROUGH_NAME}' AND block='{block}' AND lot='{lot}'&$order=received_date DESC&$limit=30 Registrations: https://data.cityofnewyork.us/resource/tesw-yqqr.json?$where=boroid='{boro}' AND block='{block}' AND lot='{lot}' Registration contacts (owner names — registrations dataset has none): https://data.cityofnewyork.us/resource/feu5-w2e2.json?$where=registrationid='{registrationid}'

Flag Class C violations with ⚠ (immediately hazardous).

Domain 6: BSA

By

Read the complete source ↗