Agent skill

Block And Density

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

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

MITAuto-check passed

Install Block And Density

skills CLI
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill block-and-density -a claude-code

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

GitHub CLI
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude block-and-density --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/block-and-density .claude/skills/block-and-density && 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
block-and-density
GitHub stars
132
Used in
1 other repo
Token cost
~7.5k tokens
SKILL.md length
3,607 words
Files
4 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 8 steps: Establish Gross Site Area → Deduct Public Infrastructure → Calculate Building Footprint → …
  • The user asks about block dimensions
  • SKILL.md covers Block Typology Matrix, Density Calculation Methodology, Block Design Rules and Height-Density Relationship, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Block And Density is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. 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…

Its SKILL.md is about 7.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/block-typologies.md`, `references/density-metrics.md` and `references/far-calculations.md`).

The repository describes itself as: Urban Design Skills Claude. The licence is MIT.

When your agent uses it

  • The user asks about block dimensions
  • Density calculations
  • FAR optimization
  • Building footprint coverage

Example prompts

  • “/block-and-density”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Establish Gross Site Area
  2. Deduct Public Infrastructure
  3. Calculate Building Footprint
  4. Calculate Gross Floor Area (GFA)
  5. Calculate Floor Area Ratio (FAR)
  6. Calculate Net Internal Area (NIA)
  7. Calculate Dwelling Count
  8. Calculate Density Metrics

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

    Links to these hosts (documentation or services it may open):

    • itdp.org
    • brebookshop.com
    • nacto.org
    • uli.org
    • ajuntament.barcelona.cat
    • ura.gov.sg
    • london.gov.uk
    • gehlpeople.com

    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

Block And Density loads about 7.5k tokens when it runs, and up to ~34k if it reads all its reference files. Until then it costs about 142 tokens; SKILL.md has 3,607 words of instructions outside code blocks.

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

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). 3,607 words, ~7,521 tokens.

Download SKILL.mdSave it as .claude/skills/block-and-density/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
block-and-density
description
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.

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.

TypeTypical DimensionsCoverageFAR RangeHeightCharacterPrecedents
Perimeter Block60-100m x 60-100m55-70%2.0-5.04-8 storiesEuropean urban; continuous street wall enclosing a semi-private courtyard; active ground floors; strong spatial definition of streets and public spacesBarcelona 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 Block50-80m x 50-80m40-55%1.5-3.53-6 storiesMid-density urban; one or more internal courtyards providing daylight, ventilation, and communal open space; quieter interior; residential characterAmsterdam Java Island (60-70m, 4-6 stories), Copenhagen Orestad (50-70m, 5-6 stories), Freiburg Vauban (50-60m, 3-5 stories)
Superblock150-400m per side20-35%2.0-8.08-30+ storiesTower-in-park; buildings as freestanding objects in landscape; large communal open spaces; limited street enclosure; high-rise residential or mixed-useLe 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 / Terrace40-60m x 100-200m50-65%0.8-2.02-4 storiesResidential; repetitive attached houses with private rear gardens; strong street frontage rhythm; efficient land use at low-to-mid densityLondon 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-Podium60-100m x 60-100m60-75% (podium) / 15-30% (tower)4.0-12.0Podium 3-5 stories + Tower 20-60 storiesAsian 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 urbanityHong 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 / Garden50-80m x 80-120m25-35%0.3-0.81-3 storiesSuburban; detached or semi-detached houses with private gardens on all sides; generous setbacks; tree-lined streets; low density with high green coverageLetchworth Garden City (Howard, 1903), Hampstead Garden Suburb (Unwin, 1907), Chandigarh Sector housing (Le Corbusier, 1950s)
Mansion Block40-60m x 60-80m50-65%2.0-4.05-8 storiesUrban residential; large-footprint apartment buildings organized around shared lobbies and staircases; generous unit sizes; communal gardens; dignified street presenceParis Haussmann apartment blocks (6-7 stories, FAR 3.0-4.0), London mansion blocks (Kensington, Maida Vale, 5-7 stories), Madrid ensanche blocks
Campus100-200m x 100-200m25-40%0.5-2.01-6 storiesInstitutional; buildings set in landscaped grounds with generous spacing; quadrangles, courtyards, and lawns; organized by function with clear internal circulationOxford/Cambridge colleges (quadrangle plan), MIT campus (connected buildings), Apple Park (ring plan), corporate campuses
Hybrid / Mixed-TypologyVariableVariableVariableMixed heightsContemporary; 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 blockBorneo 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:

  1. 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.
  2. What is the desired street character? Strong enclosure: Perimeter, Row/Terrace, Mansion Block. Open landscape: Superblock, Villa/Garden, Campus. Mixed: Hybrid.
  3. 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).
  4. 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
ParameterValueCalculation
Gross Site Area20,000 m2 (2.0 ha)Given
Street/infrastructure deduction30%Typical urban
Net Developable Area14,000 m2 (1.4 ha)20,000 x 0.70
Site Coverage Ratio60%Perimeter block typology
Building Footprint8,400 m214,000 x 0.60
Average Floors5 storiesPerimeter block, 4-6 range
Gross Floor Area (GFA)42,000 m28,400 x 5
FAR2.1042,000 / 20,000
Residential proportion75%Mixed-use (25% commercial/retail)
Residential GFA31,500 m242,000 x 0.75
Efficiency ratio0.78Corridor apartments
Net Internal Area (residential)24,570 m231,500 x 0.78
Average unit size80 m2Weighted mix of 1/2/3-bed
Dwelling Units307 units24,570 / 80
Average household size2.3 personsUrban market assumption
Population706 persons307 x 2.3
Net Density219 DU/ha307 / 1.4
Gross Density154 DU/ha307 / 2.0
Population Density353 persons/ha706 / 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
Courtyard Dimensions and Daylight
  • Minimum courtyard dimension: 21m in the narrowest direction (BRE daylight standard, ensures adequate daylight to lowest floors at temperate latitudes)
  • Preferred courtyard dimension: 25-30m (allows generous daylight, usable open space, and mature tree planting)
  • 45-degree rule: building height surrounding the courtyard should not exceed the courtyard width; ideally the courtyard width equals or exceeds the height of the tallest surrounding building face
  • Orientation: where possible, open the courtyard to the south (northern hemisphere) or orient the lowest building wing on the south side to maximize solar access to the courtyard floor
  • Courtyard uses: communal gardens, children's play, seating, bicycle parking, waste collection (screened), emergency access
Privacy Distances
  • Window-to-window (habitable rooms facing habitable rooms): minimum 18-22m depending on jurisdiction
    • UK standard: 21m (front-to-front, habitable rooms)
    • German standard: 18m (1.0H rule, where H = building height, minimum 18m)
    • Singapore URA: 24m (between residential towers above 12 stories)
  • Window-to-blank wall: minimum 12-15m
  • Overlooking angle: windows should not have direct sightlines into neighboring habitable rooms at an angle less than 45 degrees from the perpendicular
  • Staggering and offsetting: where minimum distances cannot be achieved, offset window positions or use oblique building angles to eliminate direct sightlines
Parking Integration
  • Below-grade parking (preferred): most urban solution; preserves ground-level space for active uses; expensive (typically $30,000-60,000 per space); requires structural considerations; limit to 2 basement levels to control cost and groundwater issues
  • Podium parking: efficient (semi-automated systems possible); screen with active uses on street-facing facades; limit podium to 2-3 levels with habitable space above; provide green courtyard on podium roof
  • Courtyard parking: acceptable for low-density blocks; must be screened from public view by gates, planting, or building wings; limit to visitor and disabled parking in urban blocks
  • On-street parking: parallel parking on local streets (2.4m wide); angled parking on wider streets (5.0m deep at 60 degrees); contributes to traffic calming; do not rely solely on on-street parking for resident needs
  • Parking ratios: vary by context from 0.0 spaces/unit (car-free developments near transit) to 2.0 spaces/unit (suburban); best practice urban: 0.5-1.0 spaces/unit with unbundled pricing
Servicing and Access
  • Provide rear access lanes (minimum 6m wide for refuse vehicles) or shared courtyard access for waste collection, deliveries, and emergency vehicles
  • Do not route servicing through the primary street frontage; keep service entrances on secondary frontages or within the block interior
  • Waste collection points: within 30m carry distance of all units; screened from public view; adequate ventilation
  • Delivery and move-in access: at least one vehicular access point per block with vertical clearance of 4.0m minimum
Variation and Visual Interest
  • Height variation: vary building height by 1-2 stories within a single block to create a varied roofline and avoid monotony; place taller elements at corners and key frontages
  • Setback variation: introduce shallow recesses (1-2m) or projections (bay windows, balconies) along the street facade at intervals of 15-25m to break up the building mass
  • Facade rhythm: vary facade materials, window patterns, entrance locations, and balcony positions; aim for identifiable "addresses" within continuous building frontages
  • Avoid monolithic blocks: blocks exceeding 80m of continuous facade should be subdivided into visually distinct building segments with different architects or design languages (Barcelona, Amsterdam, and Hamburg HafenCity all mandate this)
Corner Buildings
  • Corner buildings occupy the most visible position in any block and require special design treatment
  • Height: corners may be 1-2 stories taller than the typical block height to create landmarks and mark intersections
  • Ground floor: commercial or civic uses at corners (cafes, retail, community spaces) to activate the intersection
  • Architecture: enhanced architectural treatment (chamfered corners as in Barcelona Eixample, turrets, double-height ground floors, pronounced entrances)
  • Setbacks: consider chamfered corners (3-5m cut at 45 degrees) or curved corners for pedestrian visibility and wider sidewalk space at intersections

Height-Density Relationship

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.

Show full SKILL.md (1,463 more words)Show less
Trade-Off Matrix
Target FAROption A (Low-Rise, High-Coverage)Option B (Mid-Rise, Medium-Coverage)Option C (High-Rise, Low-Coverage)
1.02 stories, 50% coverage4 stories, 25% coverage10 stories, 10% coverage
2.02 stories, 100% coverage4 stories, 50% coverage8 stories, 25% coverage
3.03 stories, 100% coverage6 stories, 50% coverage10 stories, 30% coverage
4.04 stories, 100% coverage8 stories, 50% coverage16 stories, 25% coverage
5.05 stories, 100% coverage10 stories, 50% coverage20 stories, 25% coverage
8.08 stories, 100% coverage16 stories, 50% coverage32 stories, 25% coverage
12.0Not feasible at low-rise20 stories, 60% coverage40 stories, 30% coverage
Analysis of Each Strategy

Low-Rise High-Coverage (Option A)

  • Creates enclosed, intimate street spaces with strong sense of enclosure
  • Maximum ground-floor activation and fine-grained frontage
  • Courtyard spaces are small or non-existent at 100% coverage
  • Limited daylight penetration to lower floors and interior spaces
  • Best for: mixed-use high streets, row house neighborhoods, traditional urban fabric
  • Practical ceiling: FAR 3.0-4.0 (above this, daylight becomes unacceptable)

Mid-Rise Medium-Coverage (Option B)

  • Generally produces the best urban quality: strong street enclosure (4-8 stories at 50-65% coverage), generous courtyards, good daylight, usable open space
  • Aligns with Christopher Alexander's 4-story limit (Pattern 21) for human connection to ground
  • Efficient building typologies: double-loaded corridor apartments, perimeter blocks, courtyard blocks
  • Good balance of density, livability, construction cost, and infrastructure efficiency
  • Best for: most urban neighborhoods, transit-oriented development, European-style urbanity
  • Sweet spot: FAR 2.0-5.0 at 4-8 stories with 50-65% coverage

High-Rise Low-Coverage (Option C)

  • Creates open landscape between towers with generous ground-level open space
  • Weak street enclosure: buildings read as objects in space rather than defining spatial boundaries
  • Can feel windswept, exposed, and lacking intimate human-scale spaces at ground level
  • Wind turbulence around tower bases requires mitigation (canopies, planting, screens)
  • Higher construction cost per m2 (structural premium above 8-10 stories, elevator systems, fire safety)
  • Best for: parks and waterfronts (towers emerging from landscape), tropical climates (ventilation), very high FAR targets (above 8.0)
  • Caution: avoid isolated towers on podiums without a broader urban strategy for ground-level enclosure and activation
Key Insight

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:

  • Urban spatial quality (enclosure ratio)
  • Daylight to dwellings (vertical sky component)
  • Usable open space (courtyard area)
  • Construction efficiency (cost per m2 of GFA)
  • Energy performance (reduced heat loss from compact form)
  • Social sustainability (connection to ground, neighborly interaction, community building)

Daylight and Solar Access

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.

Solar Envelope Methodology

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:

  • Target date: typically the winter solstice (worst case) or equinox (design case)
  • Target time window: typically 4 hours of direct sun on neighboring facades/open spaces between 10:00 and 14:00
  • Neighboring sensitive receivers: residential windows, public open spaces, school playgrounds
  • The solar envelope is generated by projecting sun vectors from the boundaries of neighboring sensitive receivers backward to the site at the critical sun angles
BRE Daylight Standards (Building Research Establishment, UK)
  • Daylight Factor (DF): the ratio of indoor illuminance to outdoor illuminance under overcast skies
    • Minimum 2% DF for habitable rooms (living rooms, bedrooms)
    • Minimum 1.5% DF for kitchens
    • Minimum 1% DF for bathrooms, hallways, and non-habitable rooms
  • Vertical Sky Component (VSC): the amount of visible sky from the center of a window, measured as a percentage of an unobstructed hemisphere
    • Minimum 27% VSC for windows to have adequate daylight
    • If VSC falls below 27%, or below 0.8 times its former value after development, daylight is considered adversely affected
  • No-Sky Line (NSL): the line within a room beyond which no sky is visible from the working plane (850mm above floor)
    • At least 50% of the room area should be able to see sky from the working plane
    • If NSL retreats so that less than 50% of the room can see sky, daylight is considered inadequate
Annual Probable Sunlight Hours (APSH)
  • For windows facing within 90 degrees of due south:
    • Minimum 25% of APSH over the whole year (minimum 1,486 hours equivalent)
    • Minimum 5% of APSH during winter months (September 21 to March 21)
  • If either threshold is not met, and the reduction is greater than 20% of the former value, sunlight amenity is considered adversely affected
Shadow Casting Rules of Thumb

At a given latitude, the length of shadow cast by a building varies with the sun's altitude angle:

  • Shadow length = Building height / tan(sun altitude angle)
  • At 45 degrees latitude (approximate for Milan, Montreal, Portland):
    • Equinox noon (March/September 21): shadow length approximately equals building height (sun altitude approximately 45 degrees)
    • Summer solstice noon (June 21): shadow length approximately 0.5x building height (sun altitude approximately 68 degrees)
    • Winter solstice noon (December 21): shadow length approximately 2.7x building height (sun altitude approximately 21 degrees)
  • At 52 degrees latitude (approximate for London, Berlin, Amsterdam):
    • Winter solstice noon: shadow length approximately 3.5x building height (sun altitude approximately 15 degrees)
  • At 35 degrees latitude (approximate for Tokyo, Los Angeles, Casablanca):
    • Winter solstice noon: shadow length approximately 1.7x building height (sun altitude approximately 32 degrees)
Minimum Spacing for Solar Access

To ensure direct sunlight reaches ground-level spaces (courtyards, streets, neighboring facades) for a target number of hours:

  • Spacing = Building height / tan(sun altitude at target date and time)
  • For a 6-story building (20m height) at 52 degrees latitude (London), winter solstice noon:
    • Spacing = 20m / tan(15 degrees) = 20 / 0.268 = 75m for noon sunlight to reach ground level
    • This is why London's courtyard blocks have minimum 21m courtyards but rely on sky light rather than direct winter sun
  • For a 6-story building (20m height) at 35 degrees latitude (Los Angeles), winter solstice noon:
    • Spacing = 20m / tan(32 degrees) = 20 / 0.625 = 32m for noon sunlight to reach ground level
    • Much more achievable; direct winter sun is realistic for courtyard design at lower latitudes
Practical Design Implications
  1. Orient long building axes east-west where possible so that the south-facing facade receives maximum solar exposure and the north-facing facade (which receives no direct sun in northern latitudes) faces the street or other buildings
  2. Step down building height toward the south (in northern hemisphere) to avoid overshadowing shorter buildings and open spaces to the north
  3. At temperate and cold latitudes (above 45 degrees), do not rely on direct winter sunlight for courtyard amenity; design courtyards for sky daylight using the VSC and daylight factor approach rather than direct sun
  4. At tropical and warm latitudes (below 35 degrees), solar access is less of a constraint; the primary concern shifts to shading and preventing overheating; orient buildings and courtyards for ventilation rather than sun access
  5. Use daylight simulation software (Radiance, DIVA, Ladybug/Honeybee, Velux Daylight Visualizer) to validate daylight performance for any building deeper than 14m or any courtyard narrower than 25m

Output Format

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 Template
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:

  • Block Typologies Reference: block-typologies.md 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.

  • Density Metrics Reference: density-metrics.md 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.

  • FAR Calculations Reference: far-calculations.md 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: See the urban-design-foundations skill for core theorists, quantitative rules of thumb, movement frameworks, and design quality criteria that provide the broader context for block design decisions.

  • Urban Calculator: See the urban-calculator skill for Python scripts that compute density, FAR, walkability, parking, green space, and block optimization metrics programmatically.

External References

© 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 3 other files (references) in skills/block-and-density of Abhinavbwj/Urban-Design-Skills-Claude.

  • SKILL.md
  • references/block-typologies.md
  • references/density-metrics.md
  • references/far-calculations.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

Block And Density 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.

Block And Density compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Block And Density this skillAbhinavbwj/Urban-Design-Skills-Claude1321 repos~7.5kAutomated safety check: PassMIT
SQL Optimizationgithub/awesome-copilot40k2 repos~2.3kAutomated safety check: PassMIT
Agent Performance Optimizerruvnet/ruflo74k2 repos~3.6kAutomated safety check: PassMIT
Database Optimizerdavila7/claude-code-templates32k8 repos~2.5kAutomated safety check: PassMIT
Prompt Optimizeraffaan-m/ECC275k2 repos~2.4kAutomated safety check: PassMIT
Cost Optimizeruvnet/ruflo74k1 repos~997Automated safety check: NotesMIT

Similar skills

  • SQL Optimization

    github/awesome-copilot

    Official

    Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server…

    40k GitHub starsUsed in 2 repos~2.3k tokens
    DatabasesAuto-check passed
  • Agent skill for performance-optimizer - invoke with $agent-performance-optimizer

    74k GitHub starsUsed in 2 repos~3.6k tokens
    Auto-check passed
  • Database Optimizer

    davila7/claude-code-templates

    Expert database optimizer specializing in modern performance tuning, query optimization, and scalable architectures.

    32k GitHub starsUsed in 8 repos~2.5k tokens
    DatabasesAuto-check passed
  • Prompt Optimizer

    affaan-m/ECC

    分析原始提示,识别意图和差距,匹配ECC组件(技能/命令/代理/钩子),并输出一个可直接粘贴的优化提示。仅提供咨询角色——绝不自行执行任务。触发时机:当用户说“优化提示”、“改进我的提示”、“如何编写提示”、“帮我优化这个指令”或明确要求提高提示质量时。中文等效表达同样触发:“优化prompt”、“改进prompt”、“怎么写prompt”、“帮我优化这个指令”。不触发时机:当用户希望直接执行任…

    275k GitHub starsUsed in 2 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Cost Optimize

    ruvnet/ruflo

    Analyze token usage patterns and recommend cost optimizations with estimated savings

    74k GitHub starsUsed in 1 repo~997 tokens
    AI & LLM EngineeringAuto-check: notes
  • Caveman Optimization Evaluator

    JuliusBrussee/caveman

    Turns a Caveman report-only optimization observation into one minimal code change and a paired baseline evaluation, after the operator picks which to pursue.

    110k GitHub starsUsed in 1 repo~1.2k tokens
    AI & LLM EngineeringAuto-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
  • 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
  • Site Analysis

    Abhinavbwj/Urban-Design-Skills-Claude

    Conduct comprehensive multi-scale site analysis from regional to neighborhood to site scale.

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

Questions about Block And Density

What does Block And Density do?

Design urban blocks and optimize density using typological analysis, FAR calculations, and building configuration strategies. Block And Density is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. Design urban blocks and optimize density using typological analysis, FAR calculations, and building configuration strategies.

When should I use Block And Density?

Block And Density fits situations like: the user asks about block dimensions; density calculations; FAR optimization; building footprint coverage.

How do I install Block And Density in Claude Code?

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

How do I install Block And Density in Codex?

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

Can I use Block And Density 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 block-and-density -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/block-and-density, .gemini/skills/block-and-density, .github/skills/block-and-density and .opencode/skills/block-and-density in your project.

What does Block And Density need to run?

SKILL.md names no scripts, command-line tools or credentials: Block And Density is instructions for the agent only.

Does Block And Density access the network?

SKILL.md names 8 domains. As links in the text: itdp.org, brebookshop.com, nacto.org, uli.org, ajuntament.barcelona.cat, ura.gov.sg, london.gov.uk and gehlpeople.com. This is read from the text; nothing was executed.

Is Block And Density 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 Block And Density use?

Block And Density 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 Block And Density use?

About 7.5k tokens (SKILL.md is roughly 30k 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 27k tokens, read only when the agent opens those files.

What are the alternatives to Block And Density?

Skills that share tags, products or a category with Block And Density: SQL Optimization (github/awesome-copilot, 40k stars), Agent Performance Optimizer (ruvnet/ruflo, 74k stars), Database Optimizer (davila7/claude-code-templates, 32k stars) and Prompt Optimizer (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Block And Density?

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.