Skip to content

Add us-property-data skill - #2636

Closed
zillapi wants to merge 2 commits into
github:mainfrom
zillapi:add-us-property-data-skill
Closed

Add us-property-data skill#2636
zillapi wants to merge 2 commits into
github:mainfrom
zillapi:add-us-property-data-skill

Conversation

@zillapi

@zillapi zillapi commented Aug 12, 2026

Copy link
Copy Markdown

Adds a skill for tasks that need real U.S. residential property data: valuation lookups, listing search, price and tax history, schools, and parsing a zillow.com URL a user pasted.

Why this is a gap rather than something the model already handles. U.S. property facts are not derivable from a model's weights and change continuously; no single open dataset publishes them. Zillow's own public API (ZWSID) was retired in 2021, so generated code that targets it, or that is written from memory of it, fails at runtime. The skill points Copilot at endpoints that exist and covers the parts developers actually get wrong: resolve by zpid rather than address because address strings are unstable, select fields rather than fetching the whole record, render a valuation together with its as-of date, and treat absent data as absent rather than zero.

Affiliation. I work at Zero Point Studio, who build and operate the API this skill calls. Disclosed in the skill frontmatter as well. Written to the guidance in #968: no pricing, no signup links, no free-tier language; the only links are the API base, the MCP endpoint and the docs.

Validation.

  • npm run skill:validate passes (408 skills valid, including this one)
  • npm run build run; docs/README.skills.md regenerated, one row added
  • every REST path in the skill verified against the live OpenAPI spec at https://zillapi.com/openapi.json rather than written from memory

Adds a skill for tasks that need real U.S. residential property data:
valuation lookups, listing search, price and tax history, schools.

Zillow's public API (ZWSID) was retired in 2021, so generated code that
targets it fails at runtime. The skill points Copilot at endpoints that
exist and covers the practical parts: resolve by zpid rather than address,
select fields, render a valuation with its as-of date, treat absent data
as absent rather than zero.

Contributed by Zero Point Studio, who build and operate the API the skill
calls. Regenerated docs/README.skills.md with npm run build.
@zillapi
zillapi requested a review from aaronpowell as a code owner August 12, 2026 12:38
@github-actions github-actions Bot added new-submission PR adds at least one new contribution skills PR touches skills labels Aug 12, 2026
@github-actions

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 1 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 0
ℹ️ Info 0

✅ No matching risk patterns were detected in changed files.

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Vally Lint Results

✅ All checks passed

Scope Checked
Skills 1
Agents 0
Total 1
Severity Count
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ ✅ us-property-data (2/2 checks passed)
ℹ️ ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️ ✓ spec-compliance: All spec checks passed.
ℹ️ ✓ [valid-refs] All file references across 1 skill(s) are valid.
ℹ️ ✓ valid-refs: All file references resolve to existing files within the skill directory.
ℹ️ 1 skill(s) linted, 1 passed
Full linter output
### Linting skills/us-property-data
✅ us-property-data (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

The previous reference URL 404s. There is no rendered docs page; the
spec at zillapi.com/openapi.json is the canonical reference and is the
same document the skill tells the reader to verify endpoints against.
@aaronpowell

Copy link
Copy Markdown
Contributor

Sorry, we're not a channel for purely paid services.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-submission PR adds at least one new contribution skills PR touches skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants