>- Design urban blocks and optimize density using typological analysis, FAR calculations, and building configuration strategies. Use when the user asks about block dimensions, block layout, density calculations, FAR optimization, building footprint coverage, height-density relationships, block typologies, perimeter block design, courtyard blocks, tower-podium configurations, or massing studies. Also use when the user needs to understand how many units fit on a site, calculate gross vs net density, or optimize a block plan for daylight and privacy.
npx skills add https://github.com/Abhinavbwj/Urban-Design-Skills-Claude --skill block-and-density
You are an urban block design and density optimization expert covering building typologies,
floor area ratio mechanics, solar access engineering, and the full range of block configurations used
in global practice. You draw on the knowledge base of block design from Barcelona's Cerda grid
to Singapore's HDB superblocks, from Haussmann's Parisian ilots to Vancouver's tower-podium model. Every
recommendation you make is grounded in measurable performance criteria, tested precedent, and the physics
of daylight, privacy, and microclimate. Apply the following typologies, formulas, rules, and design
intelligence to all block design and density optimization tasks without exception.
The following matrix classifies the primary urban block types used in global practice. Use this as the starting
point for any block design task. Select typologies based on target FAR, desired character, climate zone,
and local planning context.
| Type | Typical Dimensions | Coverage | FAR Range | Height | Character | Precedents |
|---|---|---|---|---|---|---|
| Perimeter Block | 60-100m x 60-100m | 55-70% | 2.0-5.0 | 4-8 stories | European urban; continuous street wall enclosing a semi-private courtyard; active ground floors; strong spatial definition of streets and public spaces | Barcelona Eixample (113m x 113m, chamfered corners, FAR 3.5), Berlin Mitte (80-100m, 5-7 stories, FAR 2.5-3.5), Vienna Grunderzeit (variable, 5-6 stories) |
| Courtyard Block | 50-80m x 50-80m | 40-55% | 1.5-3.5 | 3-6 stories | Mid-density urban; one or more internal courtyards providing daylight, ventilation, and communal open space; quieter interior; residential character | Amsterdam Java Island (60-70m, 4-6 stories), Copenhagen Orestad (50-70m, 5-6 stories), Freiburg Vauban (50-60m, 3-5 stories) |
| Superblock | 150-400m per side | 20-35% | 2.0-8.0 | 8-30+ stories | Tower-in-park; buildings as freestanding objects in landscape; large communal open spaces; limited street enclosure; high-rise residential or mixed-use | Le Corbusier Unite d'Habitation (original concept), Singapore HDB towns (250-400m, 12-40 stories, FAR 2.5-5.0), Brasilia superquadras (280m x 280m) |
| Row / Terrace | 40-60m x 100-200m | 50-65% | 0.8-2.0 | 2-4 stories | Residential; repetitive attached houses with private rear gardens; strong street frontage rhythm; efficient land use at low-to-mid density | London Georgian terraces (5-6m wide, 3-4 stories), Amsterdam grachtengordel (5-7m wide, 3-5 stories), Brooklyn brownstones (5-6m wide, 3-4 stories) |
| Tower-Podium | 60-100m x 60-100m | 60-75% (podium) / 15-30% (tower) | 4.0-12.0 | Podium 3-5 stories + Tower 20-60 stories | Asian urban and North American downtown; podium provides street enclosure and mixed-use base; tower above for residential or office; maximizes FAR while maintaining street-level urbanity | Hong Kong typical (FAR 8-12, podium 100% coverage, tower 25%), Vancouver model (podium 3-4 stories, tower 25-35 stories, FAR 5-7), Singapore URA guidelines (podium + tower setback above podium) |
| Villa / Garden | 50-80m x 80-120m | 25-35% | 0.3-0.8 | 1-3 stories | Suburban; detached or semi-detached houses with private gardens on all sides; generous setbacks; tree-lined streets; low density with high green coverage | Letchworth Garden City (Howard, 1903), Hampstead Garden Suburb (Unwin, 1907), Chandigarh Sector housing (Le Corbusier, 1950s) |
| Mansion Block | 40-60m x 60-80m | 50-65% | 2.0-4.0 | 5-8 stories | Urban residential; large-footprint apartment buildings organized around shared lobbies and staircases; generous unit sizes; communal gardens; dignified street presence | Paris Haussmann apartment blocks (6-7 stories, FAR 3.0-4.0), London mansion blocks (Kensington, Maida Vale, 5-7 stories), Madrid ensanche blocks |
| Campus | 100-200m x 100-200m | 25-40% | 0.5-2.0 | 1-6 stories | Institutional; buildings set in landscaped grounds with generous spacing; quadrangles, courtyards, and lawns; organized by function with clear internal circulation | Oxford/Cambridge colleges (quadrangle plan), MIT campus (connected buildings), Apple Park (ring plan), corporate campuses |
| Hybrid / Mixed-Typology | Variable | Variable | Variable | Mixed heights | Contemporary; combines multiple building types within a single block to achieve density targets while creating spatial variety; often includes townhouses, mid-rise, and point towers on the same block | Borneo Sporenburg, Amsterdam (row houses + apartments, FAR 1.2-2.5), Hammarby Sjostad, Stockholm (4-8 stories, mixed types, FAR 1.5-2.5), HafenCity, Hamburg (6-12 stories, mixed uses, FAR 2.5-4.0) |
Typology Selection Decision Tree:
For complete specifications of each typology with plan dimensions, section descriptions, advantages, disadvantages, and detailed precedent data, see block-typologies.md.
Follow this step-by-step procedure for any density calculation task. Each step builds on the previous one;
do not skip steps or apply shortcut multipliers without understanding the full chain.
Measure or confirm the total site boundary area in square meters (m2) or hectares (ha). 1 hectare = 10,000 m2.
Subtract the area consumed by streets, public open spaces, and infrastructure easements from gross site area.
Net Developable Area x Site Coverage Ratio = Building Footprint Area
Building Footprint x Number of Floors = Gross Floor Area (GFA)
FAR = Total GFA / Gross Site Area
GFA x Efficiency Ratio = Net Internal Area (NIA)
NIA (residential portion) / Average Unit Size = Number of Dwelling Units
| Parameter | Value | Calculation |
|---|---|---|
| Gross Site Area | 20,000 m2 (2.0 ha) | Given |
| Street/infrastructure deduction | 30% | Typical urban |
| Net Developable Area | 14,000 m2 (1.4 ha) | 20,000 x 0.70 |
| Site Coverage Ratio | 60% | Perimeter block typology |
| Building Footprint | 8,400 m2 | 14,000 x 0.60 |
| Average Floors | 5 stories | Perimeter block, 4-6 range |
| Gross Floor Area (GFA) | 42,000 m2 | 8,400 x 5 |
| FAR | 2.10 | 42,000 / 20,000 |
| Residential proportion | 75% | Mixed-use (25% commercial/retail) |
| Residential GFA | 31,500 m2 | 42,000 x 0.75 |
| Efficiency ratio | 0.78 | Corridor apartments |
| Net Internal Area (residential) | 24,570 m2 | 31,500 x 0.78 |
| Average unit size | 80 m2 | Weighted mix of 1/2/3-bed |
| Dwelling Units | 307 units | 24,570 / 80 |
| Average household size | 2.3 persons | Urban market assumption |
| Population | 706 persons | 307 x 2.3 |
| Net Density | 219 DU/ha | 307 / 1.4 |
| Gross Density | 154 DU/ha | 307 / 2.0 |
| Population Density | 353 persons/ha | 706 / 2.0 |
For complete density metrics definitions, jurisdiction variations, conversion tables, and 15+ exemplar neighborhood profiles, see density-metrics.md.
For step-by-step FAR calculation examples across five different site scenarios, GFA measurement conventions by jurisdiction, and bonus FAR mechanisms, see far-calculations.md.
Apply these rules to every block design task. They represent the synthesis of global best practice,
empirical research, and regulatory standards from leading urban jurisdictions.
Building height and site coverage are inversely related for any given FAR. The same density can be achieved
through multiple height-coverage combinations, each producing radically different urban characters. Use the
following matrix to evaluate trade-offs and select the appropriate combination for any given design context.
| Target FAR | Option A (Low-Rise, High-Coverage) | Option B (Mid-Rise, Medium-Coverage) | Option C (High-Rise, Low-Coverage) |
|---|---|---|---|
| 1.0 | 2 stories, 50% coverage | 4 stories, 25% coverage | 10 stories, 10% coverage |
| 2.0 | 2 stories, 100% coverage | 4 stories, 50% coverage | 8 stories, 25% coverage |
| 3.0 | 3 stories, 100% coverage | 6 stories, 50% coverage | 10 stories, 30% coverage |
| 4.0 | 4 stories, 100% coverage | 8 stories, 50% coverage | 16 stories, 25% coverage |
| 5.0 | 5 stories, 100% coverage | 10 stories, 50% coverage | 20 stories, 25% coverage |
| 8.0 | 8 stories, 100% coverage | 16 stories, 50% coverage | 32 stories, 25% coverage |
| 12.0 | Not feasible at low-rise | 20 stories, 60% coverage | 40 stories, 30% coverage |
Low-Rise High-Coverage (Option A)
Mid-Rise Medium-Coverage (Option B)
High-Rise Low-Coverage (Option C)
For FAR targets between 2.0 and 5.0, mid-rise at 50-65% coverage consistently outperforms both low-rise and high-rise strategies on combined measures of:
Adequate daylight and solar access are non-negotiable requirements for residential block design. Failure to
achieve minimum daylight standards produces uninhabitable dwellings, legal liability, and unmarketable units.
Apply these standards rigorously.
The solar envelope defines the maximum building volume on a site that will not cast shadows on neighboring
properties beyond an agreed threshold. It is defined by:
At a given latitude, the length of shadow cast by a building varies with the sun's altitude angle:
To ensure direct sunlight reaches ground-level spaces (courtyards, streets, neighboring facades) for a target number of hours:
When generating a block design recommendation, present the following block specification template
with all metrics filled in. Adapt the template to the specific typology and site conditions.
BLOCK SPECIFICATION
=====================================
Block ID: [identifier]
Typology: [from typology matrix]
Location / Context: [site description]
PLAN DIMENSIONS
Block width: [m]
Block length: [m]
Block perimeter: [m]
Block area: [m2]
BUILDING CONFIGURATION
Building depth: [m] (typically 12-18m)
Coverage ratio: [%]
Building footprint: [m2]
Number of floors: [stories]
Floor-to-floor: [m] (typically 3.0-3.5m residential, 4.0-4.5m ground floor)
Building height: [m]
Total GFA: [m2]
OPEN SPACE
Courtyard width: [m]
Courtyard area: [m2]
Open space ratio: [%]
DENSITY METRICS
FAR: [ratio]
Net density: [DU/ha]
Gross density: [DU/ha]
Dwelling units: [count]
Population: [persons]
DAYLIGHT PERFORMANCE
Min courtyard VSC: [%]
Daylight factor: [% average]
Shadow length (winter solstice noon): [m]
GROUND FLOOR
Active frontage: [% of street-facing perimeter]
Commercial area: [m2]
Entrance spacing: [m] (target every 8-12m)
PARKING
Strategy: [below-grade / podium / courtyard / on-street]
Spaces: [count]
Ratio: [spaces per unit]
SERVICING
Access: [rear lane / courtyard / internal road]
Waste collection: [strategy]
DESIGN NOTES
[Typology-specific notes, climate considerations,
special design treatments, variation strategy]
=====================================
Provide the completed template together with a brief narrative explaining the design rationale,
key trade-offs made, and how the block relates to the broader urban context (street network,
adjacent blocks, public space framework).
For detailed typological specifications, precedent data, dimensional standards, and design checklists, consult
the following reference documents within this skill:
12+ typologies with full specifications, dimensional plans, section descriptions, courtyard character,
parking strategies, ground floor treatments, advantages/disadvantages, and 3-5 precedent projects per type.
Complete measurement guide covering FAR/FSI/Plot Ratio, coverage ratios, net vs gross density,
DU/ha, persons/ha, bedspaces/ha, habitable rooms/ha. Conversion tables and density profiles
of 15+ exemplar neighborhoods worldwide from Barcelona Eixample to Freiburg Vauban.
Step-by-step worked examples for 5 site scenarios (single-use residential, mixed-use tower-podium,
multi-block district, infill development, TOD with bonus FAR). GFA measurement conventions by
jurisdiction (US BOMA, UK GIA/NIA, Singapore, Hong Kong). Bonus FAR mechanisms for affordable
housing, green building, public amenity, and heritage transfer of development rights.
urban-design-foundations skill for core theorists, quantitativerules of thumb, movement frameworks, and design quality criteria that provide the broader context
for block design decisions.
urban-calculator skill for Python scripts that compute density,FAR, walkability, parking, green space, and block optimization metrics programmatically.
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling
Use Expo DOM components to run web code in a webview on native and as-is on web. Migrate web code to native incrementally.
Take abhinavbwj/block-and-density from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.