amanbh997/urban-design-skills-claude/block-and-density
Claude Code and agent skill by amanbh997/urban-design-skills-claude
- community
Checking that the SKILL.md file is still in the repository.
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.
Install
npx vskill@latest install amanbh997/urban-design-skills-claude/block-and-densitySKILL.md
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.
Block Typology Matrix
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:
- What is the target FAR? Below 1.0: Villa/Garden or Row/Terrace. 1.0-2.5: Courtyard or Mansion Block. 2.5-5.0: Perimeter Block or Hybrid. Above 5.0: Tower-Podium or Superblock.
- What is the desired street character? Strong enclosure: Perimeter, Row/Terrace, Mansion Block. Open landscape: Superblock, Villa/Garden, Campus. Mixed: Hybrid.
- What is the climate zone? Hot-arid: Courtyard Block (shaded interiors). Tropical: Tower-Podium or Superblock (ventilation). Temperate: Perimeter or Mansion. Cold: Perimeter (wind protection) or Campus (sheltered courtyards).
- What are the parking constraints? Below-grade: any typology. Podium parking: Tower-Podium. Rear court: Perimeter, Row/Terrace. Surface: Villa/Garden, Campus.
For complete specifications of each typology with plan dimensions, section descriptions, advantages, disadvantages, and detailed precedent data, see block-typologies.md.
Density Calculation Methodology
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.
Step 1: Establish Gross Site Area
Measure or confirm the total site boundary area in square meters (m2) or hectares (ha). 1 hectare = 10,000 m2.
Step 2: Deduct Public Infrastructure
Subtract the area consumed by streets, public open spaces, and infrastructure easements from gross site area.
- Typical street/infrastructure deduction: 25-35% of gross site area
- Low-density suburban: 20-25% (wider lots, fewer streets)
- Mid-density urban: 25-30% (regular grid, local streets)
- High-density urban: 30-35% (frequent intersections, small blocks, more street area)
- Result = Net Developable Area
Step 3: Calculate Building Footprint
Net Developable Area x Site Coverage Ratio = Building Footprint Area
- Site Coverage Ratio varies by typology (see matrix above: 25-75%)
Step 4: Calculate Gross Floor Area (GFA)
Building Footprint x Number of Floors = Gross Floor Area (GFA)
- If building heights vary across the site, calculate GFA for each building or zone separately and sum
- GFA includes all enclosed floor area measured to the outside face of external walls
Step 5: Calculate Floor Area Ratio (FAR)
FAR = Total GFA / Gross Site Area
- Note: FAR is always calculated against gross site area (including streets), not net developable area
- This is the single most important density metric; verify it against zoning allowance
Step 6: Calculate Net Internal Area (NIA)
GFA x Efficiency Ratio = Net Internal Area (NIA)
- Efficiency Ratio (also called Net-to-Gross ratio): the proportion of GFA that is usable floor area
- Typical efficiency ratios by building type:
- Walk-up apartments (no corridors): 0.85-0.90
- Corridor apartments (double-loaded): 0.75-0.82
- Single-loaded corridor apartments: 0.65-0.72
- Tower apartments (central core): 0.70-0.78
- Office buildings: 0.80-0.85 (NIA/GIA)
- Retail: 0.85-0.90
Step 7: Calculate Dwelling Count
NIA (residential portion) / Average Unit Size = Number of Dwelling Units
- Average unit size varies by market and unit mix:
- Studio/1-bed: 35-55 m2
- 2-bed: 65-85 m2
- 3-bed: 90-120 m2
- Family/4-bed: 120-160 m2
- Weighted average for mixed development: typically 70-95 m2
Step 8: Calculate Density Metrics
- Net Residential Density = Dwelling Units / Net Developable Area (in hectares) = DU/ha (net)
- Gross Residential Density = Dwelling Units / Gross Site Area (in hectares) = DU/ha (gross)
- Population = Dwelling Units x Average Household Size (typically 2.1-3.5 persons depending on market)
- Population Density = Population / Gross Site Area (in hectares) = persons/ha
Worked Example: 2-Hectare Mixed-Use Site
| 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.
Block Design Rules
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.
Block Size and Perimeter
- Minimum block perimeter: 250m (below this, blocks become inefficient with excessive street area relative to usable land)
- Optimal block perimeter: 400m (ITDP TOD Standard 3.0 gold standard)
- Maximum block perimeter: 500m (above this, walking distances become excessive and pedestrian convenience declines)
- Rule of thumb: target block dimensions of 60-80m x 80-120m for optimal balance of street connectivity and developable depth
- Elongated blocks: acceptable up to 200m in length if mid-block connections are provided (see below)
- Square blocks: work well at 80-100m per side; below 60m, corner lots consume too much frontage relative to block area
Mid-Block Pedestrian Connections
- On any block face exceeding 120m in length, provide at least one mid-block pedestrian passage
- Ideal spacing for mid-block connections: every 60-80m along long block faces
- Minimum passage width: 3m (clear width, unobstructed)
- Preferred passage width: 4-6m (allows daylight, planting, seating)
- Passages should be publicly accessible, well-lit (minimum 50 lux at ground level), and visually permeable from both ends (sightlines through the passage)
- Passages can be open-air (preferred) or covered (arcades); avoid tunnels under buildings longer than 15m unless well-lit and activated
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/block-and-density/SKILL.md
Popularity
- Repository stars
- 48
- Repository forks
- 10
- 7-day trend score
- 19
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 18 Mar 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/amanbh997/urban-design-skills-claude/block-and-density)