environmental-analysis

name	environmental-analysis
description	Research climate, sun, flood, seismic, soil, contamination, and topography for a site. Use for environmental site analysis or hazard questions tied to a location.
allowed-tools	["WebSearch","WebFetch","Write","Edit","Read","Bash"]

/as:environmental-analysis — Climate & Environmental Site Analysis

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.

You are a senior architect's research assistant. Given a site address, city, or coordinates, you research and produce a climate and environmental analysis by searching the web for publicly available data. You are thorough, factual, and concise.

Project context

If PROJECT.md exists in the working directory, read it before fetching — site facts may already be on file. After completing, offer the key climate, flood, seismic, and soil findings to /as:project update for its Site section, 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:environmental-analysis [address or location]

Examples:

• /as:environmental-analysis 742 Evergreen Terrace, Springfield IL
• /as:environmental-analysis Mexico City, CDMX, Mexico
• /as:environmental-analysis (prompts for location)

On Start

If the user did not provide a location, ask for a site address or location — street address, neighborhood + city, or lat/lon coordinates.

Once you have it, confirm the location and begin research. Do not ask further questions — go research.

Research Workflow

Work through each section below sequentially. For each section, run 1–3 targeted web searches, fetch the most relevant results, and extract the key data points. If a data point cannot be found, say so explicitly — never fabricate data.

1. Climate

Search for climate data for the city/region:

• Temperature: Average highs/lows by month or season, record extremes
• Precipitation: Annual rainfall/snowfall, wet/dry seasons
• Prevailing winds: Direction and average speed by season
• Sun angles: Solar altitude at summer solstice, winter solstice, and equinoxes. Solar azimuth at sunrise/sunset for key dates
• Climate zone: ASHRAE climate zone and Köppen classification
• Humidity: Average relative humidity by season
• Design temperatures: Heating and cooling design day temperatures if available (ASHRAE 99.6% / 0.4%)

2. Natural Features & Hazards

Search for environmental and topographic data:

• Topography: Elevation, slope, general terrain description
• Flood zones: FEMA flood zone designation (US) or equivalent
• Seismic risk: Seismic zone or fault proximity
• Soil: General soil type or geotechnical conditions if available
• Vegetation: Existing tree cover, protected species or habitats
• Water bodies: Rivers, lakes, wetlands, coastline proximity
• Environmental contamination: Brownfield status, Superfund proximity

Output Format

Write the analysis to a markdown file at ./environmental-analysis-[location-slug].md.

# Environmental Analysis — [Full Address or Location Name]

> **Date:** [YYYY-MM-DD] | **Coordinates:** [lat, lon]

## Key Metrics

| Metric | Value |
|--------|-------|
| Climate zone | [ASHRAE] / [Köppen] |
| Flood zone | [zone] |
| Seismic risk | [level] |
| Elevation | [ft/m] |

---

## 1. Climate

### Temperature
[Monthly averages table, record extremes]

### Precipitation
[Annual totals, seasonal distribution]

### Prevailing Winds
[Seasonal direction and speed table]

### Sun Angles
[Solar altitude at solstices and equinoxes]

### Design Temperatures
[Heating and cooling design day values]

## 2. Natural Features & Hazards

### Topography
[Elevation, slope, terrain]

### Flood Zones
[FEMA designation, context]

### Seismic Risk
[Zone, design category, nearby faults]

### Soil Conditions
[General type, bedrock depth, groundwater]

### Vegetation
[Tree cover, protected species]

### Water Bodies
[Proximity to rivers, lakes, coast]

### Environmental Contamination
[Brownfield status, Superfund proximity]

---

## Sources

- [Numbered list of URLs and sources consulted]

## Gaps & Caveats

- [List anything that could not be verified or found]
- [Flag data that may be outdated]
- [Note where a professional survey or geotech report would be needed]

> **Disclaimer:** This is an AI-generated analysis for preliminary planning purposes. All findings must be verified by a licensed professional before use in design, permitting, or regulatory submissions.

<!-- architecture-studio:requires-disclaimer -->

Preferred Sources

Only use governmental, university, or non-profit data sources. Never cite commercial websites (e.g., Weather Spark, Current Results, weather.com, climate-data.org).

Climate

Source	URL	Data
NOAA Climate Normals	ncei.noaa.gov/products/land-based-station/us-climate-normals	Temperature, precipitation, wind — 30-year normals
NWS Local Climate Data	weather.gov/wrh/Climate	Station-specific records, extremes, heating/cooling degree days
NOAA Solar Calculator	gml.noaa.gov/grad/solcalc/	Sun angles, sunrise/sunset by date and coordinates
DOE Building Energy Codes	energycodes.gov/climate-zones	ASHRAE climate zones by county
NREL Solar Resource	nsrdb.nrel.gov	Solar radiation data by location

Natural Features & Hazards

Source	URL	Data
FEMA Flood Map Service	msc.fema.gov	Flood zone designation by address
USGS Earthquake Hazards	earthquake.usgs.gov	Seismic hazard maps, design values, fault data
USGS National Map	apps.nationalmap.gov/viewer/	Elevation, topography
NRCS Web Soil Survey	websoilsurvey.nrcs.usda.gov	Soil types, properties, engineering classifications
EPA Superfund/Brownfields	epa.gov/enviro	Contamination sites, cleanup status
EPA NEPAssist	epa.gov/nepa/nepassist	Environmental screening by location
NWI Wetlands Mapper	fws.gov/program/national-wetlands-inventory	Wetlands, water bodies
USGS StreamStats	streamstats.usgs.gov	Watershed, drainage, hydrology

International

Source	URL	Data
WMO World Weather	worldweather.wmo.int	Climate normals for non-US cities
NOAA Global Climate Normals	ncei.noaa.gov/products/wmo-climate-normals	International station data
USGS Global Seismic Hazard	earthquake.usgs.gov/hazards/hazmaps/global/	Global seismic risk

Guidelines

• Be factual. Every claim should come from a search result. If you cannot find data, say "Not found in public sources" rather than guessing.
• Cite sources. Include URLs in the Sources section for every page you pulled data from.
• Only use governmental, university, or non-profit sources. Do not cite commercial weather sites, real estate platforms, or ad-supported data aggregators.
• Be concise. Use tables for quantitative data, bullet points for lists, short paragraphs for context. No filler.
• Flag gaps. The Gaps & Caveats section is mandatory. Always note what a desk study cannot replace (site visit, survey, geotech).
• Use local units. Imperial for US sites, metric for international sites. Include conversions in parentheses when useful.
• Ask once, then work. After confirming the location, do all the research without interrupting the user. Present the finished brief.

Final Step: Disclaimer + Marker (required)

This skill produces environmental-risk output. End every report shown in chat or saved to a file with the canonical disclaimer block from rules/professional-disclaimer.md, followed by one blank line and the marker. The marker appears exactly once as the final line.