Edge Quality Analysis
Analyze the ground-floor interfaces between buildings and public space, distinguishing soft edges (that invite activity) from hard edges (that repel), and identifying interventions to improve street life. Based on Jan Gehl's edge effect research.
Constitutional Constraints
- Respect property rights - Recommendations should acknowledge that ground floor changes often require cooperation from building owners
- Functional realism - Some hard edges serve necessary functions (loading, parking, utilities); note when softening is impractical
- Context sensitivity - What works as a soft edge varies by neighborhood, culture, and climate
- Safety awareness - Transparency can conflict with security needs; acknowledge trade-offs
When to Use
- Diagnosing why a street feels "dead" despite pedestrian traffic
- Planning ground floor requirements for new development
- Identifying retrofit opportunities for existing buildings
- Understanding why certain blocks thrive while others struggle
- Building the case for active frontage policies
- Evaluating the impact of specific ground floor uses
Inputs
| Input |
Required |
Description |
| street_description |
Yes |
Description of the street or block to analyze |
| images |
Recommended |
Street-level photos showing building frontages |
| ground_floor_uses |
Helpful |
Known uses (retail, office lobby, parking, residential) |
| activity_observations |
Helpful |
Where people currently gather, linger, or avoid |
The Edge Effect
Core Principle
People gravitate to edges, not centers. In public spaces:
- They stand with their backs to walls, facing the action
- They sit along building frontages, not in exposed centers
- They linger where there's something to engage with
- They hurry past blank walls
The edge zone - the first few meters where buildings meet public space - disproportionately influences street life. This is where people pause, where activities spill out, where the indoor and outdoor worlds connect.
Soft vs. Hard Edges
Soft Edges create conditions for lingering:
- Transparency (windows to see through)
- Variety (different shops, uses, facades)
- Permeability (frequent entrances)
- Activity (things happening inside visible from outside)
- Spill-out space (cafes, displays, seating)
- Human scale (details, textures, elements at eye level)
Hard Edges repel activity:
- Blank walls (nothing to see)
- Uniformity (repetitive, monotonous facades)
- Impermeability (few or no entrances)
- Inactivity (dark windows, empty spaces)
- Barriers (fences, grade changes, landscaping walls)
- Hostile architecture (surfaces designed to prevent sitting)
Analysis Process
Step 1: Map the Frontages
Walk (or examine images of) both sides of the street, documenting ground floor conditions block by block.
Frontage Types:
- Active Retail - Shops, cafes, restaurants with display windows and frequent entrances
- Active Service - Banks, salons, offices with walk-in access and visible activity
- Residential - Stoops, front yards, small apartment entrances
- Lobby/Institutional - Office building lobbies, hotel entrances, institutional fronts
- Blank Wall - No openings, no activity, solid surface
- Parking/Service - Garage entrances, loading docks, back-of-house
- Vacant - Empty storefronts, boarded windows
Step 2: Score Edge Quality
For each frontage segment, assess:
Transparency (Can you see in?)
- High: Full display windows, clear visibility of activity
- Medium: Partial windows, some obscuring
- Low: Opaque, blocked, or no windows
Permeability (Can you enter?)
- High: Entrances every 15-25 feet
- Medium: Entrances every 25-50 feet
- Low: Entrances 50+ feet apart or none
Activation (Is something happening?)
- High: Visible activity, merchandise, people
- Medium: Some activity but low energy
- Low: Dark, empty, or unused
Spill-Out (Does activity extend outside?)
- High: Outdoor seating, displays, signs of life
- Medium: Some exterior presence
- Low: Hard boundary at building face
Human Scale (Are there engaging details?)
- High: Varied facades, awnings, planters, texture
- Medium: Some variation
- Low: Monotonous, institutional, large-scale only
Step 3: Calculate Edge Scores
For each street segment:
- Count linear feet of soft edge vs. hard edge
- Calculate percentage of soft edge
- Identify gaps and concentrations
Thresholds:
- 70%+ soft edge: Vibrant street potential
- 50-70% soft edge: Mixed, some dead zones
- <50% soft edge: Struggling street life
Step 4: Identify Problem Spots
Flag specific locations that undermine street life:
- Long blank walls (30+ feet continuous)
- Parking garage entrances at sidewalk
- Service areas facing pedestrian routes
- Vacant storefronts in otherwise active stretches
- Grade changes that separate building from sidewalk
Step 5: Diagnose Patterns
Look for larger patterns:
- Does one side of street work while the other doesn't?
- Are problems clustered at certain building types?
- Is there a "dead zone" breaking an otherwise active stretch?
- Do certain uses correlate with activity?
Output Format
## Edge Quality Analysis: [Street/Block Name]
### Summary
**Overall Edge Quality:** [Soft / Mixed / Hard]
**Soft Edge Percentage:** [X]%
**Key Finding:** [One sentence on what's driving street life or killing it]
---
### Frontage Inventory
**[Side 1 - e.g., East Side]:**
| Segment | Address/Description | Type | Length | Edge Quality | Notes |
|---------|---------------------|------|--------|--------------|-------|
| 1 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |
| 2 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |
| ... | | | | | |
**Subtotal:** [X] feet soft / [Y] feet hard = [Z]% soft
**[Side 2 - e.g., West Side]:**
| Segment | Address/Description | Type | Length | Edge Quality | Notes |
|---------|---------------------|------|--------|--------------|-------|
| 1 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |
| 2 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |
| ... | | | | | |
**Subtotal:** [X] feet soft / [Y] feet hard = [Z]% soft
---
### Edge Quality Scoring
| Factor | Side 1 Score | Side 2 Score | Notes |
|--------|--------------|--------------|-------|
| Transparency | [H/M/L] | [H/M/L] | [observation] |
| Permeability | [H/M/L] | [H/M/L] | [observation] |
| Activation | [H/M/L] | [H/M/L] | [observation] |
| Spill-Out | [H/M/L] | [H/M/L] | [observation] |
| Human Scale | [H/M/L] | [H/M/L] | [observation] |
---
### Problem Spots
**Critical Issues:**
1. **[Location 1]:** [Description of hard edge problem]
- Impact: [How this affects street life]
- Severity: [High/Medium/Low]
2. **[Location 2]:** [Description]
- Impact: [Effect]
- Severity: [Level]
**Secondary Issues:**
- [Issue 3]
- [Issue 4]
---
### Opportunity Zones
**High Potential for Improvement:**
1. **[Location]:** [Current condition] -> [Possible improvement]
- Feasibility: [Easy/Moderate/Difficult]
- Impact: [High/Medium/Low]
2. **[Location]:** [Current] -> [Possible]
- Feasibility: [Level]
- Impact: [Level]
---
### Recommendations
**For Building Owners:**
- [Specific recommendation 1]
- [Specific recommendation 2]
**For City/Public Realm:**
- [Specific recommendation 3]
- [Specific recommendation 4]
**For New Development:**
- [Design guideline 1]
- [Design guideline 2]
---
### Conclusion
**Diagnosis:** [Summary of edge quality and its impact]
**Priority Intervention:** [Single most impactful change]
**Gehl Principle:** "Ground floors have a disproportionately large impact on the life and appeal of city space. If ground floors are friendly, soft and populated, pedestrians are surrounded by human activity."
Constraints
- Distinguish between edges that COULD be softened and those that realistically can't
- Acknowledge that some hard edges serve necessary functions
- Focus on ground floors (first 15-20 feet vertically); upper floors matter less
- Consider both sides of the street - one dead side can kill the whole street
- Note seasonal/time variations when relevant (cafe seating only in summer)
Error Handling
| Situation |
Response |
| Can't determine ground floor use |
Note as "Unknown" with visible characteristics; recommend verification |
| Mixed use within single frontage |
Break into segments or note the mix |
| Historic building with inherent hard edges |
Acknowledge historic value; focus on feasible interventions |
| New construction not yet occupied |
Analyze based on design; note that activation depends on tenant |
Integration
This skill is part of the Jan Gehl expert persona. It analyzes the critical building-street interface that determines whether streets have life. It pairs with:
- public-life-survey - To document activity patterns related to edge quality
- human-scale-audit - To assess the overall pedestrian experience
- 12-quality-criteria - For comprehensive space evaluation
Edge quality analysis identifies WHERE to intervene; public life surveys measure the impact.
1---2name: edge-quality-analysis3description: Analyze the ground-floor interfaces between buildings and public space, distinguishing soft edges (that invite activity) from hard edges (that repel), and identifying interventions to improve street life.4license: MIT5metadata:6 source: https://skillmd.com/skills/sethmblack/edge-quality-analysis7 author: sethmblack8 version: 1.0.38769repository: https://github.com/sethmblack/paks-skills10keywords:11- edge-quality-analysis12- urban-planning13---1415# Edge Quality Analysis1617Analyze the ground-floor interfaces between buildings and public space, distinguishing soft edges (that invite activity) from hard edges (that repel), and identifying interventions to improve street life. Based on Jan Gehl's edge effect research.1819---2021## Constitutional Constraints2223- **Respect property rights** - Recommendations should acknowledge that ground floor changes often require cooperation from building owners24- **Functional realism** - Some hard edges serve necessary functions (loading, parking, utilities); note when softening is impractical25- **Context sensitivity** - What works as a soft edge varies by neighborhood, culture, and climate26- **Safety awareness** - Transparency can conflict with security needs; acknowledge trade-offs2728---2930## When to Use3132- Diagnosing why a street feels "dead" despite pedestrian traffic33- Planning ground floor requirements for new development34- Identifying retrofit opportunities for existing buildings35- Understanding why certain blocks thrive while others struggle36- Building the case for active frontage policies37- Evaluating the impact of specific ground floor uses3839---4041## Inputs4243| Input | Required | Description |44|-------|----------|-------------|45| street_description | Yes | Description of the street or block to analyze |46| images | Recommended | Street-level photos showing building frontages |47| ground_floor_uses | Helpful | Known uses (retail, office lobby, parking, residential) |48| activity_observations | Helpful | Where people currently gather, linger, or avoid |4950---5152## The Edge Effect5354### Core Principle5556People gravitate to edges, not centers. In public spaces:57- They stand with their backs to walls, facing the action58- They sit along building frontages, not in exposed centers59- They linger where there's something to engage with60- They hurry past blank walls6162**The edge zone** - the first few meters where buildings meet public space - disproportionately influences street life. This is where people pause, where activities spill out, where the indoor and outdoor worlds connect.6364### Soft vs. Hard Edges6566**Soft Edges** create conditions for lingering:67- Transparency (windows to see through)68- Variety (different shops, uses, facades)69- Permeability (frequent entrances)70- Activity (things happening inside visible from outside)71- Spill-out space (cafes, displays, seating)72- Human scale (details, textures, elements at eye level)7374**Hard Edges** repel activity:75- Blank walls (nothing to see)76- Uniformity (repetitive, monotonous facades)77- Impermeability (few or no entrances)78- Inactivity (dark windows, empty spaces)79- Barriers (fences, grade changes, landscaping walls)80- Hostile architecture (surfaces designed to prevent sitting)8182---8384## Analysis Process8586### Step 1: Map the Frontages8788Walk (or examine images of) both sides of the street, documenting ground floor conditions block by block.8990**Frontage Types:**91- **Active Retail** - Shops, cafes, restaurants with display windows and frequent entrances92- **Active Service** - Banks, salons, offices with walk-in access and visible activity93- **Residential** - Stoops, front yards, small apartment entrances94- **Lobby/Institutional** - Office building lobbies, hotel entrances, institutional fronts95- **Blank Wall** - No openings, no activity, solid surface96- **Parking/Service** - Garage entrances, loading docks, back-of-house97- **Vacant** - Empty storefronts, boarded windows9899### Step 2: Score Edge Quality100101For each frontage segment, assess:102103**Transparency (Can you see in?)**104- High: Full display windows, clear visibility of activity105- Medium: Partial windows, some obscuring106- Low: Opaque, blocked, or no windows107108**Permeability (Can you enter?)**109- High: Entrances every 15-25 feet110- Medium: Entrances every 25-50 feet111- Low: Entrances 50+ feet apart or none112113**Activation (Is something happening?)**114- High: Visible activity, merchandise, people115- Medium: Some activity but low energy116- Low: Dark, empty, or unused117118**Spill-Out (Does activity extend outside?)**119- High: Outdoor seating, displays, signs of life120- Medium: Some exterior presence121- Low: Hard boundary at building face122123**Human Scale (Are there engaging details?)**124- High: Varied facades, awnings, planters, texture125- Medium: Some variation126- Low: Monotonous, institutional, large-scale only127128### Step 3: Calculate Edge Scores129130For each street segment:131- Count linear feet of soft edge vs. hard edge132- Calculate percentage of soft edge133- Identify gaps and concentrations134135**Thresholds:**136- 70%+ soft edge: Vibrant street potential137- 50-70% soft edge: Mixed, some dead zones138- <50% soft edge: Struggling street life139140### Step 4: Identify Problem Spots141142Flag specific locations that undermine street life:143- Long blank walls (30+ feet continuous)144- Parking garage entrances at sidewalk145- Service areas facing pedestrian routes146- Vacant storefronts in otherwise active stretches147- Grade changes that separate building from sidewalk148149### Step 5: Diagnose Patterns150151Look for larger patterns:152- Does one side of street work while the other doesn't?153- Are problems clustered at certain building types?154- Is there a "dead zone" breaking an otherwise active stretch?155- Do certain uses correlate with activity?156157---158159## Output Format160161```markdown162## Edge Quality Analysis: [Street/Block Name]163164### Summary165166**Overall Edge Quality:** [Soft / Mixed / Hard]167168**Soft Edge Percentage:** [X]%169170**Key Finding:** [One sentence on what's driving street life or killing it]171172---173174### Frontage Inventory175176**[Side 1 - e.g., East Side]:**177178| Segment | Address/Description | Type | Length | Edge Quality | Notes |179|---------|---------------------|------|--------|--------------|-------|180| 1 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |181| 2 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |182| ... | | | | | |183184**Subtotal:** [X] feet soft / [Y] feet hard = [Z]% soft185186**[Side 2 - e.g., West Side]:**187188| Segment | Address/Description | Type | Length | Edge Quality | Notes |189|---------|---------------------|------|--------|--------------|-------|190| 1 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |191| 2 | [location] | [type] | [feet] | [Soft/Hard] | [notes] |192| ... | | | | | |193194**Subtotal:** [X] feet soft / [Y] feet hard = [Z]% soft195196---197198### Edge Quality Scoring199200| Factor | Side 1 Score | Side 2 Score | Notes |201|--------|--------------|--------------|-------|202| Transparency | [H/M/L] | [H/M/L] | [observation] |203| Permeability | [H/M/L] | [H/M/L] | [observation] |204| Activation | [H/M/L] | [H/M/L] | [observation] |205| Spill-Out | [H/M/L] | [H/M/L] | [observation] |206| Human Scale | [H/M/L] | [H/M/L] | [observation] |207208---209210### Problem Spots211212**Critical Issues:**2132141. **[Location 1]:** [Description of hard edge problem]215 - Impact: [How this affects street life]216 - Severity: [High/Medium/Low]2172182. **[Location 2]:** [Description]219 - Impact: [Effect]220 - Severity: [Level]221222**Secondary Issues:**223224- [Issue 3]225- [Issue 4]226227---228229### Opportunity Zones230231**High Potential for Improvement:**2322331. **[Location]:** [Current condition] -> [Possible improvement]234 - Feasibility: [Easy/Moderate/Difficult]235 - Impact: [High/Medium/Low]2362372. **[Location]:** [Current] -> [Possible]238 - Feasibility: [Level]239 - Impact: [Level]240241---242243### Recommendations244245**For Building Owners:**246- [Specific recommendation 1]247- [Specific recommendation 2]248249**For City/Public Realm:**250- [Specific recommendation 3]251- [Specific recommendation 4]252253**For New Development:**254- [Design guideline 1]255- [Design guideline 2]256257---258259### Conclusion260261**Diagnosis:** [Summary of edge quality and its impact]262263**Priority Intervention:** [Single most impactful change]264265**Gehl Principle:** "Ground floors have a disproportionately large impact on the life and appeal of city space. If ground floors are friendly, soft and populated, pedestrians are surrounded by human activity."266```267268---269270## Constraints271272- Distinguish between edges that COULD be softened and those that realistically can't273- Acknowledge that some hard edges serve necessary functions274- Focus on ground floors (first 15-20 feet vertically); upper floors matter less275- Consider both sides of the street - one dead side can kill the whole street276- Note seasonal/time variations when relevant (cafe seating only in summer)277278---279280## Error Handling281282| Situation | Response |283|-----------|----------|284| Can't determine ground floor use | Note as "Unknown" with visible characteristics; recommend verification |285| Mixed use within single frontage | Break into segments or note the mix |286| Historic building with inherent hard edges | Acknowledge historic value; focus on feasible interventions |287| New construction not yet occupied | Analyze based on design; note that activation depends on tenant |288289---290291## Integration292293This skill is part of the **Jan Gehl** expert persona. It analyzes the critical building-street interface that determines whether streets have life. It pairs with:294295- **public-life-survey** - To document activity patterns related to edge quality296- **human-scale-audit** - To assess the overall pedestrian experience297- **12-quality-criteria** - For comprehensive space evaluation298299Edge quality analysis identifies WHERE to intervene; public life surveys measure the impact.