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

demographics-analysis

Research population, income, age, housing, and employment around a site. Use for census, demographic, or local-market questions tied to a location.

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 demographics-analysis

About this skill


name: demographics-analysis description: Research population, income, age, housing, and employment around a site. Use for census, demographic, or local-market questions tied to a location. allowed-tools:

  • WebSearch
  • WebFetch
  • Write
  • Edit
  • Read
  • Bash

/as:demographics-analysis — Demographics & Market 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 demographics and market 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 demographic findings to /as:project update for its Site section. Current facts update in place, 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:demographics-analysis [address or location]

Examples:

  • /as:demographics-analysis 742 Evergreen Terrace, Springfield IL
  • /as:demographics-analysis Mexico City, CDMX, Mexico
  • /as:demographics-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

Run 2–4 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.

Demographics & Market

Search for demographic data for the census tract, ZIP code, or municipality:

  • Population: Current population and density (per sq mi or sq km)
  • Growth: Population trend over last 10 years, projected growth
  • Median household income: And comparison to metro/national median
  • Age distribution: Median age, notable cohort concentrations
  • Racial/ethnic composition: If publicly available from census data
  • Housing: Median home price, rental rates, housing stock character
  • Employment: Major employers nearby, unemployment rate, dominant industries
  • Education: Attainment levels if available

Output Format

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

# Demographics Analysis — [Full Address or Location Name]

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

## Key Metrics

| Metric | Value |
|--------|-------|
| Population | [count] |
| Population density | [per sq mi] |
| Median HH income | [amount] |
| Median home price | [amount] |
| Median age | [years] |

---

## Population

### Current Population
[Population, density, geographic scope (ZIP, census tract, neighborhood)]

### Growth Trends
[10-year trend, projected growth]

## Income & Employment

### Household Income
[Median income, comparison to metro/national]

### Employment
[Major employers, dominant industries, unemployment rate]

## Age & Composition

### Age Distribution
[Median age, cohort breakdown]

### Racial/Ethnic Composition
[Census data if available]

## Housing Market

### Home Sales
[Median price, trends, property types]

### Rental Market
[Average rent, vacancy, demand drivers]

---

## Sources

- [Numbered list of URLs and sources consulted]

## Gaps & Caveats

- [List anything that could not be verified or found]
- [Flag data vintage (ACS year, Census year)]
- [Note geographic boundary differences between sources]

Preferred Sources

Only use governmental, university, or non-profit data sources. Never cite commercial websites (e.g., Zillow, Redfin, RentCafe, Niche, Point2Homes, Neighborhood Scout).

SourceURLData
US Census Bureaudata.census.govPopulation, income, age, race, housing — Decennial Census and ACS
Census QuickFactscensus.gov/quickfactsSummary demographics by place, county, ZIP
BLS Local Area Unemploymentbls.gov/lau/Unemployment rates by county/metro
BLS Occupational Employmentbls.gov/oes/Employment by industry and occupation
HUD Userhuduser.govFair market rents, housing affordability, CHAS data
NYU Furman Centerfurmancenter.orgNYC neighborhood-level housing and demographic profiles
NYC Open Datadata.cityofnewyork.usNYC-specific datasets (housing, permits, demographics)
FRED (St. Louis Fed)fred.stlouisfed.orgMedian income, home prices, economic indicators by metro
National Center for Education Statisticsnces.ed.govEducational attainment by geography
CDC PLACEScdc.gov/places/Health and socioeconomic indicators by census tract

International

SourceURLData
World Bank Open Datadata.worldbank.orgCountry-level demographics, economics
UN Datadata.un.orgPopulation, urbanization, development indicators
National statistics agenciesVariesEach country's census/statistics bureau

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 real estate platforms, ad-supported aggregators, or crowd-sourced neighborhood sites.
  • Be concise. Use tables for quantitative data, bullet points for lists. No filler.
  • Note data vintage. Alw
Read the complete source ↗