Skip to content

AlpacaLabsLLC/skills-for-architects / skills/zoning-envelope

zoning-envelope

Verified

Generate interactive 3D zoning envelope viewers from zoning analysis reports. Use when the user asks to "visualize the zoning envelope" or see buildable massing in 3D, typically after /as:zoning-analysis-nyc. Requires a zoning analysis report as input.

FileKindSize
README.mdmarkdown3.0 KB
SKILL.mdskill md15.9 KB
host-contract.jsonconfig1.3 KB
# /as:zoning-envelope

Interactive 3D zoning envelope viewer as a Claude Code skill. Generates a single HTML file (Three.js loaded from a CDN) that renders the buildable envelope for any lot — exact lot polygon from GIS data, setback zones, extruded volumes, height caps, and interactive orbit controls.

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](../../LICENSE)

## Install

```bash
# Via plugin system
claude plugin marketplace add AlpacaLabsLLC/skills-for-architects
claude plugin install as@skills-for-architects
```

## Usage

First, run a zoning analysis to generate a report:

```
/as:zoning-analysis-nyc 250 Hudson St, New York NY
```

Then generate the 3D viewer:

```
/as:zoning-envelope path/to/zoning-analysis-250-hudson-st.md
```

Or search by keyword:

```
/as:zoning-envelope 250 hudson
```

Or auto-detect the most recent report:

```
/as:zoning-envelope
```

## What it renders

- **Exact lot polygon** from GIS data (MapPLUTO for NYC) — not a simplified rectangle
- **Setback zones** as colored ground overlays with dashed inset boundaries
- **Buildable volumes** — base, tower, galibo — extruded from the lot polygon at correct heights
- **Height cap** — amber plane at maximum building height
- **Edge-length labels** on lot boundary edges
- **Height labels** with dashed reference lines
- **Parameters panel** — FAR, max floor area, height limits, setbacks
- **Interactive controls** — orbit, zoom, pan (Three.js OrbitControls)

## How it works

The skill reads the `## Envelope Data` JSON block from a zoning analysis report. This block contains:

The following invented geometry illustrates the interface only; it is not a zoning rule or site analysis.

```json
{
  "lot_poly": [[0, 0], [90, 0], [90, 70], [0, 70]],
  "unit": "ft",
  "setbacks": { "front": 4, "rear": 6, "lateral1": 2, "lateral2": 2 },
  "volumes": [
    { "type": "base", "inset": 6, "h_bottom": 0, "h_top": 36, "label": "synthetic volume" }
  ],
  "height_cap": 36,
  "info": { "title": "Synthetic geometry fixture", "zone": "unverified" },
  "stats": {}
}
```

The skill then:

1. Parses the polygon and envelope parameters
2. Computes inset polygons for setback zones and building volumes
3. Triangulates the polygons (ear-clipping) for 3D extrusion
4. Generates a single HTML file that loads Three.js from a CDN (internet required to view)
5. Opens it in the browser

## Key features

- **Self-correcting polygon inset** — automatically detects and corrects for different polygon winding directions across data sources
- **Multi-volume envelopes** — base + tower for contextual districts
- **Multi-scenario support** — toggle buttons for comparing development scenarios (individual, party-wall, unified)
- **Works with any polygon source** — NYC MapPLUTO (WGS84) or manual coordinates

## Dependency

This skill requires a zoning analysis report as input. It does not perform zoning calculations — run `/as:zoning-analysis-nyc` first.

## Demo

[Live demo (250 Hudson Street)](https://alpa.llc/demos/zoning-envelope.html)

## License

MIT
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall