Agent skill

Urban Design Foundations

by Abhinavbwj in Abhinavbwj/Urban-Design-Skills-Claude

Comprehensive urban design knowledge base containing theories, principles, quantitative standards, and rules of thumb from 40+ theorists and global frameworks.

MITAuto-check passedKnowledge Management

Install Urban Design Foundations

skills CLI
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill urban-design-foundations -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude urban-design-foundations --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/urban-design-foundations .claude/skills/urban-design-foundations && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
urban-design-foundations
GitHub stars
132
Used in
1 other repo
Token cost
~9.2k tokens
SKILL.md length
4,423 words
Files
5 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Comprehensive urban design knowledge base containing theories, principles, quantitative standards, and rules of thumb from 40+ theorists and global frameworks.

  • Works in 3 steps: Protection against traffic and accidents… → Protection against crime and violence -… → Protection against unpleasant sensory…
  • Tasks that involve Knowledge bases
  • SKILL.md covers Core Theorists Quick Reference, Quantitative Rules of Thumb, Movement Frameworks Quick… and Climate Zones Quick Reference, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Urban Design Foundations is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. Comprehensive urban design knowledge base containing theories, principles, quantitative standards, and rules of thumb from 40+ theorists and global frameworks. Provides foundational knowledge for all urban design tasks including masterplanning, site analysis, street design, public space design, density calculations, and sustainability assessment. Automatically activates whenever the conversation involves urban design, city planning, urban morphology, placemaking, walkability, transit-oriented development…

Its SKILL.md is about 9.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/global-frameworks.md`, `references/quantitative-standards.md` and `references/rules-of-thumb.md`).

It sits in Knowledge Management, covering Knowledge bases. The repository describes itself as: Urban Design Skills Claude. The licence is MIT.

When your agent uses it

  • Tasks that involve Knowledge bases

Example prompts

  • “/urban-design-foundations”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Protection against traffic and accidents - feeling safe from vehicles, separated pedestrian zones, low vehicle speeds
  2. Protection against crime and violence - natural surveillance, good lighting, active ground floors, clear sightlines
  3. Protection against unpleasant sensory experiences - wind protection, rain/snow shelter, excessive heat/cold mitigation, pollution…

What it can do on your machine

Read from SKILL.md and the folder at commit 666327b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Urban Design Foundations loads about 9.2k tokens when it runs, and up to ~46k if it reads all its reference files. Until then it costs about 239 tokens; SKILL.md has 4,423 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~239
When it runs · the whole SKILL.md, loaded when a task matches
~9.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~46k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Abhinavbwj/Urban-Design-Skills-Claude at commit 666327b, republished under its MIT licence (© Abhinavbwj). 4,423 words, ~9,194 tokens.

Download SKILL.mdSave it as .claude/skills/urban-design-foundations/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
urban-design-foundations
description
Comprehensive urban design knowledge base containing theories, principles, quantitative standards, and rules of thumb from 40+ theorists and global frameworks. Provides foundational knowledge for all urban design tasks including masterplanning, site analysis, street design, public space design, density calculations, and sustainability assessment. Automatically activates whenever the conversation involves urban design, city planning, urban morphology, placemaking, walkability, transit-oriented development, mixed-use development, zoning, building typologies, streetscapes, public realm, neighborhood design, district planning, or any AEC topic at the urban scale. Covers Kevin Lynch, Jane Jacobs, Christopher Alexander, Jan Gehl, Gordon Cullen, Camillo Sitte, Andres Duany, Leon Krier, Ian Bentley, New Urbanism, Smart Growth, Complete Streets, 15-Minute City, Space Syntax, CPTED, and all major sustainability certifications.
user-invocable
false

Urban Design Foundations

You are an urban design expert grounded in 40+ theoretical frameworks and global standards. You draw on the work of major urban theorists from Camillo Sitte to Carlos Moreno, and apply quantitative standards from UN-Habitat, WHO, NACTO, ITDP, C40, and other leading frameworks. Apply the following principles, metrics, and design intelligence to all urban design work without exception. Every recommendation must be grounded in evidence, precedent, and measurable performance criteria.


Core Theorists Quick Reference

TheoristCore FrameworkKey ConceptsWhen to Apply
Kevin Lynch5 Elements of Imageability (1960)Paths - channels of movement, the most potent element of urban image; Edges - linear boundaries acting as barriers or seams between districts; Districts - medium-to-large areas with recognizable common character; Nodes - strategic focal points such as junctions, intersections, and concentrations of activity; Landmarks - external reference points visible from many angles and distancesApply when analyzing urban legibility, designing wayfinding systems, structuring the spatial hierarchy of a plan, or diagnosing why an area feels disorienting or illegible
Jane Jacobs4 Conditions for Diversity (1961)(1) Mixed primary uses generating people at different times of day; (2) Short blocks with frequent corners enabling route variety; (3) Buildings of varied age and condition including old buildings with low rents; (4) Sufficient density of people for whatever purpose they may be there; plus Eyes on the Street (natural surveillance from active frontages) and Sidewalk Ballet (choreography of daily street life)Apply when assessing neighborhood vitality, diagnosing why an area feels dead or unsafe, designing for diversity and mixed use, evaluating ground-floor activation strategy
Christopher AlexanderA Pattern Language (1977) - 253 PatternsPattern 12: Community of 7,000; Pattern 14: Identifiable Neighborhood (max 300 households, 500m across); Pattern 21: Four-Story Limit (human connection to ground lost above 4 stories); Pattern 30: Activity Nodes (concentrate activities at nodes along paths); Pattern 31: Promenade (pedestrian spine with density of activity); Pattern 32: Shopping Street (narrow, two-sided, parking behind); Pattern 51: Green Streets (shade trees on every street); Pattern 53: Main Gateways (mark entry to districts); Pattern 61: Small Public Squares (15-21m across); Pattern 106: Positive Outdoor Space (convex, enclosed, not leftover)Apply when sizing neighborhoods, setting building height limits, designing activity nodes, structuring pedestrian networks, designing outdoor spaces that feel positive and enclosed rather than residual
Jan Gehl12 Quality Criteria + Life Between Buildings (1971/2010)Protection: traffic safety, crime/violence safety, unpleasant sensory protection; Comfort: walking, standing/staying, sitting, seeing, talking/listening, play/exercise; Enjoyment: human scale, climate enjoyment, aesthetic quality/positive sensory; 3 types of outdoor activities: Necessary (happen regardless), Optional (only in good conditions), Social (emerge from the other two); Edge Effect (activity at edges); Active Facades (15+ doors per 100m = active)Apply when designing public spaces, evaluating pedestrian experience, assessing street-level quality, designing ground floors, determining seating and amenity placement
Gordon CullenSerial Vision / Townscape (1961)Serial Vision - experience of space as sequence of revelations alternating between existing view and emerging view; Enclosure - sense of "here"; Exposure - sense of "there"; Deflection - curved or angled streets creating mystery and anticipation; Focal Points - terminated vistas drawing movement; Floor Treatment - paving changes signaling spatial transitions; Intimacy/Grandeur continuumApply when designing streetscapes, analyzing urban character, sequencing pedestrian experiences, creating visual interest through spatial compression and release
Camillo SitteArtistic Principles of City Planning (1889)Enclosed plazas as outdoor rooms proportional to surrounding building heights; curved streets for visual interest that hide convergence points; anti-grid layouts creating more interesting spaces; monuments and fountains placed off-center for dynamic composition; proportional rule: plaza width equals 1-2x surrounding building heightApply when designing plazas and civic spaces, placing monuments and public art, composing terminated vistas, creating spatial enclosure, designing irregular but purposeful urban geometries
Andres DuanyRural-to-Urban Transect T1-T6 / SmartCodeT1 Natural (wilderness, ecological preserve); T2 Rural (agricultural, scattered buildings); T3 Sub-Urban (detached houses, deep setbacks, 5-15 DU/ha); T4 General Urban (rowhouses, small apartments, shallow setbacks, 15-40 DU/ha); T5 Urban Center (mixed-use, zero-lot-line, 40-100 DU/ha); T6 Urban Core (tallest buildings, highest density, 100+ DU/ha); SmartCode as model ordinance implementing Transect as form-based codeApply when designing form-based codes, establishing zoning categories, defining context-appropriate building types and densities, structuring the rural-to-urban gradient in a masterplan
Leon KrierPolycentric City / Architecture of CommunityCity as federation of self-sufficient quarters each max 33 hectares (500m x 660m), everything within 10-minute walk; Res Publica (civic buildings) vs Res Economica (private buildings) requiring investment in public architecture; growth by multiplication not extension (duplicate successful quarters); 5-story height limit for human scale; traditional architecture and urbanismApply when structuring district sizes, establishing civic hierarchies, sizing neighborhoods, arguing against sprawl expansion, designing polycentric city structures
Ian Bentley7 Qualities of Responsive Environments (1985)(1) Permeability - how many alternative routes through an area; (2) Variety - range of uses and experiences available; (3) Legibility - how easy to understand the spatial structure; (4) Robustness - ability of spaces to serve different purposes over time; (5) Visual Appropriateness - does appearance communicate use and meaning; (6) Richness - variety of sensory experiences; (7) Personalization - ability of users to put their stamp on a placeApply when evaluating design quality, scoring design proposals, structuring design criteria for competitions, assessing whether an urban area is truly responsive to its users

Quantitative Rules of Thumb

MetricMinimumOptimalMaximumSource
Block perimeter250m400m500mITDP TOD Standard 3.0
Block dimensions60m x 60m80m x 100m150m x 150mPortland/Barcelona precedent, Form-Based Codes
Street height-to-width ratio for enclosure1:6 (loss of enclosure)1:3 to 1:1 (good enclosure)3:1 (canyon effect)Sitte, Gehl, NACTO
FAR - Suburban0.30.50.8Typical US/Australian zoning
FAR - Neighborhood1.01.52.5European mid-rise standards
FAR - Urban Center2.03.55.0Barcelona, Paris, Singapore
FAR - Urban Core4.08.015.0Manhattan, Hong Kong
Green space per capita9 m2 (WHO min)15-20 m230+ m2 (generous)WHO, UN-Habitat, European Green Capital
Walking distance - 5 min-400m-Standard pedestrian planning
Walking distance - 10 min-800m-Standard pedestrian planning
Walking distance - 15 min-1,200m-Standard pedestrian planning
Intersection density80/km2100-140/km2-ITDP TOD Standard 3.0
Sidewalk width (clear walking zone)1.8m (ADA minimum)2.4-3.6m4.8m+ (commercial areas)ADA, NACTO, MUTCD
Protected bike lane (one-way)1.5m + 0.6m buffer2.0m + 0.6m buffer2.5m + 0.9m bufferNACTO Bikeway Design Guide
Travel lane width3.0m3.0-3.3m3.6m (trucks/buses)NACTO Urban Street Design Guide
Parallel parking lane2.1m2.4m2.7mNACTO
Street tree spacing6m8-10m12m (large canopy species)Urban forestry standards
Building setback - Urban0m0-2m3mForm-Based Codes
Building setback - Suburban3m3-6m10mTypical suburban zoning
Building setback - Rural6m6-15m30m+Rural zoning
Dwelling density - Suburban15 DU/ha20-30 DU/ha30 DU/haPlanning standards
Dwelling density - Urban40 DU/ha50-80 DU/ha80 DU/haEuropean urban standards
Dwelling density - Center80 DU/ha100-150 DU/ha150 DU/haTOD / mixed-use standards
Dwelling density - Core150 DU/ha200-400 DU/ha400+ DU/haHong Kong, Manhattan
Population threshold for bus service5,00010,000-Transit planning standards
Population threshold for light rail25,00035,00050,000Transit planning standards
Population threshold for metro50,00075,000+-Transit planning standards
Retail space per capita1.5 m22.0 m22.5 m2Retail planning benchmarks
Primary school per population1 per 5,0001 per 7,5001 per 10,000Education planning standards
Secondary school per population1 per 15,0001 per 20,0001 per 25,000Education planning standards
Plaza minimum dimension15m25-60m100m (before emptiness)Alexander Pattern 61, Sitte, Gehl
Seating in plazas-1 linear meter per 3 m2 of plaza-Gehl, PPS best practice
Tree canopy coverage target25%30-40%50%+ (tropical)American Forests, Urban canopy goals
Courtyard minimum dimension (daylight)21m25-30m-Daylighting standards (45-degree rule)
Window-to-window privacy distance18m20-22m25mEuropean housing standards
Noise limit - Daytime-50 dB(A)55 dB(A)WHO Environmental Noise Guidelines
Noise limit - Nighttime-40 dB(A)45 dB(A)WHO Environmental Noise Guidelines
Park service radius - Pocket park-200m-NRPA, Parks planning standards
Park service radius - Neighborhood park-500m-NRPA, Parks planning standards
Park service radius - District park-1,500m-NRPA, Parks planning standards

Movement Frameworks Quick Reference

New Urbanism (Congress for the New Urbanism, 1993)

  • 27 CNU Charter principles organized across three scales: Region (metropolis, city, town), Neighborhood (district, corridor), and Block (street, building)
  • Walkable neighborhoods as the fundamental building block: mixed use within a 5-minute walk (400m) of center
  • Connected street network with high intersection density and short blocks
  • Mixed-use development with housing diversity (types, sizes, price points) in every neighborhood
  • Civic spaces (squares, greens, parks) at prominent locations
  • Buildings that define and frame public space rather than sitting as isolated objects
  • Transit corridors connecting neighborhoods and districts
  • Regional planning that limits sprawl, preserves open land, and directs growth to existing centers

Transit-Oriented Development (ITDP TOD Standard 3.0)

  • 8 Principles: Walk (pedestrian quality, safety, accessibility), Cycle (network, parking, access from transit), Connect (small blocks, direct routes, low-speed streets), Transit (proximity, frequency, quality), Mix (complementary uses, housing diversity), Densify (residential and employment density supporting transit), Compact (urban footprint, contiguous development), Shift (reduced parking, traffic calming, demand management)
  • Walk catchment: 400m for bus, 800m for rail
  • Density gradient: highest at station, tapering outward
  • Gold standard requires score of 85+ out of 100

Complete Streets (NACTO)

  • Design every street for all users: pedestrians, cyclists, transit riders, motorists, freight, emergency vehicles
  • Context-sensitive: street design varies by land use context, not just traffic volume
  • Safety-first: Vision Zero principles, design speed not posted speed
  • NACTO street types: Boulevard, Avenue, Main Street, Neighborhood Street, Yield Street, Shared Street
  • Key metrics: mode share, crash rates, crossing distances, signal timing, level of service for all modes

15-Minute City (Carlos Moreno, 2016)

  • 6 essential urban functions accessible within a 15-minute walk or bicycle ride: Living (housing), Working (employment, co-working), Supplying (shopping, groceries, daily needs), Caring (health, social services), Learning (schools, libraries, lifelong learning), Enjoying (parks, culture, recreation, leisure)
  • Chrono-urbanism: time-based measurement of urban quality replaces distance-based
  • Hyper-proximity: decentralize services to neighborhood level
  • Adaptive reuse: buildings and streets serve multiple functions at different times
  • Measurement: map all 6 functions, calculate walk/cycle isochrones, identify gaps

Smart Growth (EPA, 10 Principles)

  • Mix land uses within neighborhoods and districts
  • Take advantage of compact design to reduce land consumption
  • Create a range of housing opportunities and choices for all income levels
  • Create walkable neighborhoods with pedestrian-friendly streets
  • Foster distinctive, attractive communities with a strong sense of place
  • Preserve open space, farmland, natural beauty, and critical environmental areas
  • Direct development towards existing communities with infrastructure
  • Provide a variety of transportation choices beyond the automobile
  • Make development decisions predictable, fair, and cost-effective
  • Encourage community and stakeholder collaboration in development decisions

Tactical Urbanism (Mike Lydon, 2012)

  • Low-cost, temporary interventions to test permanent improvements before full capital investment
  • Common interventions: parklets (parking-space parks), pop-up bike lanes, painted plazas and intersections, tactical crosswalks, guerrilla gardening, open streets / ciclovia events, chair-bombing (adding seating)
  • Process: envision, test, measure, iterate, build permanently
  • Reduces political risk by demonstrating outcomes before committing funds
  • Engages community directly in placemaking and co-design

Space Syntax (Bill Hillier, 1984)

  • Mathematical analysis of spatial configuration through axial maps and segment analysis
  • Integration (to-movement): measures how accessible a space is from all other spaces - high integration = destination, attracts stationary activities and retail
  • Connectivity: number of spaces directly connected to each space
  • Choice (through-movement/betweenness): measures how likely a space is to be passed through on trips between all pairs of origins and destinations - high choice = movement corridor
  • Depth: number of turns or direction changes to reach a space from another
  • Application: predict pedestrian flows, locate retail, diagnose spatial segregation, evaluate street network performance

Climate Zones Quick Reference

Hot-Arid Climate Design

  • Compact urban form with narrow streets for mutual shading
  • High height-to-width ratio (greater than 1:1, ideally 2:1 to 3:1) for maximum shade on streets and walls
  • Courtyards as private microclimate regulators (cool core effect via shaded enclosure and night-sky radiation)
  • Thermal mass construction (thick walls, stone, rammed earth) to delay heat transfer
  • Light-colored exterior surfaces (albedo >0.5) to reflect solar radiation
  • Shade structures (arcades, pergolas, mashrabiya screens) over pedestrian paths and gathering spaces
  • East-west street orientation to minimize solar exposure on long facades while allowing winter sun penetration
  • Wind towers and passive ventilation strategies integrated into building and block design
  • Clustered building arrangements to reduce exposed surface area
  • Minimal impervious surface; maximize evaporative cooling through fountains, pools, planted courtyards

Tropical Climate Design

  • Elevated buildings on pilotis or stilts for air circulation underneath and flood resilience
  • Cross-ventilation as primary cooling strategy: orient buildings perpendicular to prevailing breezes, ensure double-loaded corridors have operable openings
  • Dense tree canopy (target 40-50% coverage) for shade and evapotranspiration cooling
  • Rain gardens, bioswales, and permeable surfaces to manage intense rainfall events
  • North-south building orientation (in equatorial zones) to minimize east-west solar exposure on long facades
  • Deep overhangs (1.5-2.5m) and verandahs to protect from driving rain and high-angle sun
  • Wide streets with central rain channels or bioswales
  • Light-weight construction with high ventilation rates
  • Generous eave overhangs and covered walkways connecting buildings

Temperate Climate Design

  • Balanced approach: solar access in winter, shade in summer
  • Deciduous street trees on south and west sides (northern hemisphere) for seasonal shade variation
  • Medium density (FAR 1.5-3.0) balancing solar access with urban enclosure
  • Mixed orientation: primary streets can run any direction with appropriate building massing
  • Four-season public spaces: shelter from wind and rain in winter, shade and water in summer
  • Moderate height-to-width ratios (1:2 to 1:1) providing enclosure while allowing daylight
  • Green roofs and walls for thermal buffering and stormwater management
  • Courtyard buildings with southern exposure for sheltered outdoor space in spring/autumn

Cold Climate Design

  • Compact urban form to minimize exposure to wind and cold
  • Wind barriers: dense evergreen plantings, berms, and building arrangements perpendicular to prevailing winter winds
  • Connected indoor public spaces: covered walkways, skyways, heated arcades, underground networks for year-round pedestrian comfort
  • South-facing orientation (northern hemisphere) to maximize solar gain on facades and streets during short winter days
  • Dark-colored paving and surfaces in pedestrian areas for solar absorption and snowmelt acceleration
  • Snow storage planning: designated areas in parking lots and open spaces for plowed snow
  • Building massing that avoids creating wind tunnels between towers
  • Street widths accounting for snow clearing equipment (minimum 1m additional clearance)
  • Heated outdoor gathering nodes to extend season of public space use

Design Quality Criteria

Gehl 12 Quality Criteria

Protection (Prerequisites):

  1. Protection against traffic and accidents - feeling safe from vehicles, separated pedestrian zones, low vehicle speeds
  2. Protection against crime and violence - natural surveillance, good lighting, active ground floors, clear sightlines
  3. Protection against unpleasant sensory experiences - wind protection, rain/snow shelter, excessive heat/cold mitigation, pollution reduction, noise buffering

Comfort (Functional): 4. Opportunities for walking - room to walk, accessible surfaces, interesting facades, no obstacles, good connections 5. Opportunities for standing/staying - edge effect zones, support for leaning, defined places to linger 6. Opportunities for sitting - primary seating (benches), secondary seating (ledges, steps, planters), seating with views, sun/shade options 7. Opportunities for seeing - clear sightlines, adequate lighting (day and night), unobstructed views to activity 8. Opportunities for talking/listening - low ambient noise (under 60 dB), seating arrangements encouraging conversation, intimate spatial niches 9. Opportunities for play/exercise/unfolding activities - both formal (play equipment, sports) and informal (climbable surfaces, open lawn, flexible spaces)

Enjoyment (Delight): 10. Scale - buildings and spaces proportioned to human body and senses, fine-grained detail at eye level 11. Opportunities to enjoy positive aspects of climate - sun pockets in cold seasons, shade and breeze in hot seasons, wind-sheltered spots 12. Aesthetic quality and positive sensory experience - quality materials, good design, trees/plants/water, art, views, varied textures, pleasant sounds and smells

Bentley 7 Qualities of Responsive Environments
  1. Permeability - number and quality of alternative routes through an area; maximize visual and physical permeability; small blocks, frequent intersections, mid-block passages
  2. Variety - range of uses, building types, and experiences available; diversity of activities at different times of day; mixed tenure and price points
  3. Legibility - ease of understanding the spatial structure; clear hierarchy of routes, distinct districts, visible landmarks, meaningful nodes
  4. Robustness - capacity of spaces and buildings to serve different purposes and adapt over time; flexible floor plates, adaptable ground floors, multi-use public spaces
  5. Visual Appropriateness - buildings and spaces communicate their role and meaning through form, materials, and details; civic buildings look civic, homes look domestic
  6. Richness - variety of sensory experiences through materials, textures, colors, sounds, smells, planting, water, light and shadow patterns, seasonal changes
  7. Personalization - degree to which users can modify and put their own stamp on spaces and buildings; balconies, front gardens, shopfront individuality, community murals
Show full SKILL.md (1,714 more words)Show less
PPS 4 Qualities of Great Places
  1. Access and Linkages - visible from a distance, easy to get to and walk through, connected to adjacent areas, accessible by transit, bike, and foot, well-connected internally
  2. Comfort and Image - safe and clean, available seating, attractive and well-maintained, good reputation, comfortable microclimate
  3. Uses and Activities - reasons to be there at all times, vital and active, unique and special, fun and interesting, programmed events, community uses
  4. Sociability - diverse mix of people, sense of neighborliness, interactive and welcoming, sense of pride and ownership, cooperative management
Healthy Streets 10 Indicators (Transport for London)
  1. Pedestrians from all walks of life - inclusivity across age, ability, gender, ethnicity, and income
  2. Easy to cross - short wait times, direct desire-line crossings, pedestrian priority, minimal crossing distances
  3. Shade and shelter - protection from sun, rain, wind, and snow through trees, canopies, arcades, and building overhangs
  4. Places to stop and rest - benches, leaning rails, and rest points spaced at regular intervals (every 50-100m for elderly/disabled)
  5. Not too noisy - ambient noise below 70 dB(A) for comfortable conversation, ideally below 60 dB(A)
  6. People choose to walk, cycle, and use public transport - mode share targets favoring active and sustainable transport
  7. People feel safe - adequate lighting, sightlines, active frontages, other people present, no entrapment spots
  8. Things to see and do - active frontages, window displays, public art, street performers, markets, visual interest at eye level
  9. People feel relaxed - greenery, water features, calm traffic, clean air, absence of visual clutter and aggressive advertising
  10. Clean air - pollutant levels below WHO guidelines, tree planting for filtration, low-emission zones, traffic reduction

Specialized Skill Router

When the conversation involves urban design topics, use this decision tree to determine which specialized skill to invoke for deeper, task-specific guidance. Multiple skills may be relevant simultaneously; invoke all that apply.

Site Analysis and Context Understanding

  • If the task involves analyzing an existing site, understanding site conditions, evaluating context, studying surrounding urban fabric, mapping constraints and opportunities, performing SWOT analysis, or assessing site accessibility and connectivity
  • Action: Invoke the site-analysis skill for detailed site assessment methodology, checklist, and evaluation criteria

Design Evaluation and Scoring

  • If the task involves evaluating a design proposal, scoring a masterplan against quality criteria, conducting design review, comparing design alternatives, or assessing compliance with urban design principles
  • Action: Invoke the design-evaluation skill for structured evaluation frameworks, scoring rubrics, and comparative analysis methods

Masterplan and Layout Generation

  • If the task involves generating a masterplan, laying out a new neighborhood or district, structuring land use, establishing movement networks, placing key elements, or developing a spatial framework
  • Action: Invoke the masterplan-design skill for masterplanning methodology, spatial structuring principles, and design generation workflows

Street Design and Cross-Sections

  • If the task involves designing streets, specifying cross-sections, allocating right-of-way, designing intersections, selecting bike and transit infrastructure, or optimizing street trees and furnishing
  • Action: Invoke the street-design skill for NACTO-aligned street design standards, cross-section templates, and intersection design guidance

Public Space Design

  • If the task involves designing parks, plazas, squares, courtyards, waterfronts, greenways, playgrounds, or any form of public open space
  • Action: Invoke the public-space-design skill for public space typologies, programming guidance, microclimate design, and furnishing standards

Block and Density Optimization

  • If the task involves optimizing block sizes, calculating floor area ratios, establishing building envelopes, managing density distribution, configuring building footprints, or balancing coverage and open space
  • Action: Invoke the block-and-density skill for block configuration strategies, density calculation methods, and building typology-to-density relationships

Mixed-Use Programming

  • If the task involves programming land uses, determining use mix ratios, calculating commercial or residential quantum, establishing retail frontage requirements, or designing mixed-use buildings and districts
  • Action: Invoke the mixed-use-programming skill for use mix optimization, demand calculations, synergy matrices, and program distribution strategies

Transit-Oriented Development

  • If the task involves designing around transit stations, establishing walk catchments, optimizing density near transit, designing transit plazas, or scoring against TOD standards
  • Action: Invoke the tod-design skill for TOD typologies, station area planning, density gradient strategies, and ITDP scoring methodology

Climate-Responsive Design

  • If the task involves addressing microclimate, solar orientation, wind management, thermal comfort, urban heat island mitigation, stormwater management, or climate adaptation at the urban scale
  • Action: Invoke the climate-responsive-design skill for climate-specific design strategies, microclimate analysis methods, and green infrastructure sizing

Zoning and Regulatory Codes

  • If the task involves interpreting zoning codes, designing form-based codes, establishing development standards, calculating setbacks and heights, or navigating regulatory frameworks
  • Action: Invoke the zoning-and-codes skill for zoning interpretation methods, form-based code structure, and regulatory compliance strategies

Sustainability Certification Scoring

  • If the task involves scoring against LEED-ND, BREEAM Communities, Green Star Communities, Estidama Pearl, GSAS, or any other sustainability certification framework
  • Action: Invoke the sustainability-scoring skill for certification credit-by-credit guidance, point optimization strategies, and documentation requirements

Precedent and Case Study Research

  • If the task involves studying precedent projects, analyzing case studies, comparing global best practices, or drawing lessons from built examples
  • Action: Invoke the precedent-study skill for precedent databases, analytical frameworks, and transferable lesson extraction

Design Brief and Report Writing

  • If the task involves writing an urban design brief, design report, design and access statement, planning submission narrative, or competition entry document
  • Action: Invoke the design-brief skill for document structure templates, narrative frameworks, and professional report writing conventions

Mobility and Transport Planning

  • If the task involves transport demand estimation, trip generation, mode split, traffic impact assessment, transit planning, cycling network design, freight servicing strategy, mobility hubs, pedestrian accessibility, vehicle-km traveled, or any movement and accessibility planning beyond individual street cross-sections
  • Action: Invoke the mobility-and-transport skill for trip generation tables, mode split frameworks, transit planning, cycling design standards, and transport impact assessment workflows

Cost Estimation and Development Feasibility

  • If the task involves estimating construction cost, infrastructure budget, total development cost, cost per m2, cost per dwelling, project feasibility, value engineering, or comparing the cost of design alternatives
  • Action: Invoke the cost-estimation skill for building cost benchmarks, infrastructure costing, soft cost estimation, and financial feasibility analysis

Urban Regeneration and Brownfield Redevelopment

  • If the task involves brownfield development, urban renewal, regeneration strategy, adaptive reuse, heritage-led regeneration, gentrification management, community engagement in development, vacant land activation, post-industrial redevelopment, meanwhile uses, neighborhood revitalization, infill intensification, or catalyst project design
  • Action: Invoke the urban-regeneration skill for brownfield remediation, heritage assessment, adaptive reuse feasibility, anti-gentrification tools, community engagement methodology, and regeneration delivery frameworks

Precise Metric Calculations

  • If the task involves calculating specific urban metrics such as FAR, density, population yield, parking requirements, open space ratios, infrastructure capacity, or any quantitative urban design computation
  • Action: Invoke the urban-calculator skill for calculation formulas, unit conversion, benchmarking, and sensitivity analysis methods

Deep Knowledge References

For complete theoretical frameworks with full citations and extended application guidance for all theorists covered in this skill:

For all quantitative standards organized by category with minimum/recommended/maximum values, source citations, and contextual notes:

For global frameworks including UN-Habitat, WHO, C40, NACTO (all guides), ITDP, Transport for London, PPS, and other international standards:

For extended rules of thumb organized by specific design situation (neighborhood center, residential area, main street, boulevard, plaza, building orientation, population/services, infrastructure):


Anti-Pattern Catalog

The following are common urban design mistakes. Flag these whenever they appear in a design proposal, site analysis, or masterplan, and recommend corrections:

Superblocks without mid-block pedestrian connections - Blocks larger than 150m on any side must include mid-block pedestrian passages every 60-80m. Without them, walking distances double and pedestrian convenience collapses. Always break superblocks with through-block links.

Parking lots facing streets (dead frontage) - Surface parking between buildings and streets destroys the pedestrian environment, eliminates natural surveillance, and wastes the most valuable real estate. Parking must be behind buildings, below grade, or in structures wrapped with active uses.

Cul-de-sac dominated layouts (disconnected network) - Cul-de-sacs destroy street connectivity, force all trips onto collector roads, eliminate route choice, increase vehicle miles traveled, and make walking and cycling impractical. Maintain a connected grid or modified grid with intersection density above 80 per km2.

Single-use zoning at neighborhood scale (kills diversity) - Separating residential, commercial, and civic uses into single-use pods forces automobile dependence, eliminates the "eyes on the street" at different times of day, and prevents the mixed-use vitality that Jacobs identified as essential to urban life. Every neighborhood must have mixed primary uses.

Ignoring microclimate in building and street orientation - Orienting streets and buildings without considering solar angles, prevailing winds, and shadow patterns leads to uncomfortable public spaces, excessive energy consumption, and missed opportunities for passive heating and cooling. Orientation must respond to climate zone.

Oversized road sections based on peak traffic projections - Designing roads for projected peak-hour capacity in 20 years creates hostile, dangerous, car-dominated environments today. Apply induced demand logic: wider roads generate more traffic. Design for the desired speed and mode share, not projected vehicle volume.

Gated communities interrupting street network - Gated enclaves sever through-routes, force detours, concentrate traffic on remaining connections, reduce emergency access, and undermine social cohesion. Street networks must be continuous and publicly accessible.

Ground-floor residential without setback on arterials - Placing living rooms and bedrooms at grade on busy arterial streets exposes residents to noise, pollution, vibration, and visual intrusion. Arterial frontages need commercial or civic ground-floor uses, with residential above, or deep planted setbacks with privacy buffers.

Blank walls on active frontages - Windowless walls, service entrances, loading docks, and parking garage facades facing pedestrian streets destroy street life, eliminate natural surveillance, and create perceived danger zones. Every street-facing facade on a pedestrian route must have windows, entrances, and visual interest at eye level.

Insufficient tree canopy (below 15%) - Streets and public spaces without adequate tree canopy are hostile in summer, visually barren, and ecologically impoverished. Target minimum 25% canopy coverage for all streets and public spaces, with 30-40% as the standard for quality urban environments.

Designing for cars first, pedestrians second - Any design process that begins with vehicle traffic modeling, road widths, and parking requirements before establishing the pedestrian network, public space framework, and human-scale environment will produce a car-dominated outcome. Always design the pedestrian and public space network first, then fit vehicle infrastructure within it.

Ignoring topography in street grid layout - Forcing a rigid orthogonal grid onto hilly terrain creates excessively steep streets, requires expensive cut-and-fill, destroys natural drainage patterns, and misses opportunities for views, terracing, and topographic identity. Streets must follow contours where grades exceed 5-8%, with the grid adapting to terrain.

© Abhinavbwj, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/urban-design-foundations of Abhinavbwj/Urban-Design-Skills-Claude.

  • SKILL.md
  • references/global-frameworks.md
  • references/quantitative-standards.md
  • references/rules-of-thumb.md
  • references/theorists-and-movements.md

Open the folder on GitHubat commit 666327b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Abhinavbwj/Urban-Design-Skills-Claude, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Urban Design Foundations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Urban Design Foundations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Urban Design Foundations this skillAbhinavbwj/Urban-Design-Skills-Claude1321 repos~9.2kAutomated safety check: PassMIT
Knowledge Searchdataelement/bisheng12k—~1.1kAutomated safety check: PassApache-2.0
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence
Find And Citeoutline/outline41k—~537Automated safety check: PassCustom licence
Xhs Virtual Productchenjin-cmd/xhs-virtual-product729—~862Automated safety check: PassMIT
OpenkbVectifyAI/OpenKB4.8k1 repos~2kAutomated safety check: WarnApache-2.0

Similar skills

  • Knowledge Search

    dataelement/bisheng

    Search the user's knowledge bases and knowledge spaces (企业知识库检索).

    12k GitHub stars~1.1k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Find And Cite

    outline/outline

    Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.

    41k GitHub stars~537 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Xhs Virtual Product

    chenjin-cmd/xhs-virtual-product

    This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.

    729 GitHub stars~862 tokensUpdated 9 days ago
    Knowledge ManagementAuto-check passed
  • Openkb

    VectifyAI/OpenKB

    A skill your agent uses when the user asks about content in their OpenKB knowledge base — research topics, concepts compiled from their documents, cross-document synthesis — or mentions openkb, an…

    4.8k GitHub starsUsed in 1 repo~2k tokens
    Knowledge ManagementAuto-check: warnings
  • Learn From Materials

    dmoshehun-prog/learn-from-materials

    Turns books, PDFs, slides and web pages into a source-grounded knowledge base and an interactive learning page in English or Chinese, with quizzes, relationship maps and reusable methodology notes.

    947 GitHub stars~7.9k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed

More from Abhinavbwj/Urban-Design-Skills-Claude

All 18 skills in this repo
  • Cost Estimation

    Abhinavbwj/Urban-Design-Skills-Claude

    Estimate construction costs, infrastructure costs, soft costs, and total development costs for urban design projects.

    132 GitHub starsUsed in 1 repo~5k tokens
    Auto-check passed
  • Urban Calculator

    Abhinavbwj/Urban-Design-Skills-Claude

    Python computational tools for urban design metric calculations including density, FAR, walkability scoring, parking requirements, green space analysis, and block optimization.

    132 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Block And Density

    Abhinavbwj/Urban-Design-Skills-Claude

    Design urban blocks and optimize density using typological analysis, FAR calculations, and building configuration strategies.

    132 GitHub starsUsed in 1 repo~7.5k tokens
    Auto-check passed
  • Design Evaluation

    Abhinavbwj/Urban-Design-Skills-Claude

    Evaluate urban designs against comprehensive criteria drawn from all major global standards, certification systems, and theoretical frameworks.

    132 GitHub starsUsed in 1 repo~9.2k tokens
    Auto-check passed
  • Mobility And Transport

    Abhinavbwj/Urban-Design-Skills-Claude

    Comprehensive mobility and transport planning for urban design including trip generation, mode split targets, street network connectivity, transit planning, cycling network design, pedestrian…

    132 GitHub starsUsed in 1 repo~6.1k tokens
    Auto-check passed
  • Precedent Study

    Abhinavbwj/Urban-Design-Skills-Claude

    Research and analyze urban design precedents systematically.

    132 GitHub starsUsed in 1 repo~5.1k tokens
    Auto-check passed

Questions about Urban Design Foundations

What does Urban Design Foundations do?

Comprehensive urban design knowledge base containing theories, principles, quantitative standards, and rules of thumb from 40+ theorists and global frameworks. Urban Design Foundations is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. Comprehensive urban design knowledge base containing theories, principles, quantitative standards, and rules of thumb from 40+ theorists and global frameworks.

When should I use Urban Design Foundations?

Urban Design Foundations fits situations like: tasks that involve Knowledge bases.

How do I install Urban Design Foundations in Claude Code?

Run `npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill urban-design-foundations -a claude-code`. Or copy the skill folder (skills/urban-design-foundations in Abhinavbwj/Urban-Design-Skills-Claude) into .claude/skills/urban-design-foundations in your project. Claude Code loads it when a task matches its description.

How do I install Urban Design Foundations in Codex?

Run `npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill urban-design-foundations -a codex`. Or copy the skill folder (skills/urban-design-foundations in Abhinavbwj/Urban-Design-Skills-Claude) into .agents/skills/urban-design-foundations in your project. Codex loads it when a task matches its description.

Can I use Urban Design Foundations in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill urban-design-foundations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/urban-design-foundations, .gemini/skills/urban-design-foundations, .github/skills/urban-design-foundations and .opencode/skills/urban-design-foundations in your project.

What does Urban Design Foundations need to run?

SKILL.md names no scripts, command-line tools or credentials: Urban Design Foundations is instructions for the agent only.

Does Urban Design Foundations access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Urban Design Foundations safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Urban Design Foundations use?

Urban Design Foundations is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Urban Design Foundations use?

About 9.2k tokens (SKILL.md is roughly 37k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 37k tokens, read only when the agent opens those files.

What are the alternatives to Urban Design Foundations?

Skills that share tags, products or a category with Urban Design Foundations: Knowledge Search (dataelement/bisheng, 12k stars), Capture Conversation (outline/outline, 41k stars), Find And Cite (outline/outline, 41k stars) and Xhs Virtual Product (chenjin-cmd/xhs-virtual-product, 729 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Urban Design Foundations?

Abhinavbwj (a GitHub user) maintains it in Abhinavbwj/Urban-Design-Skills-Claude, which has 132 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on March 12, 2026.

Source: Abhinavbwj/Urban-Design-Skills-Claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.