Cleanup
simstudioai/sim
Run all code quality skills — effects, memo, callbacks, state, React Query, emcn design review, url-state, comments, and test-audit — analyzing in parallel, then applying fixes sequentially
Evaluate urban designs against comprehensive criteria drawn from all major global standards, certification systems, and theoretical frameworks.
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude design-evaluation --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/design-evaluation .claude/skills/design-evaluation && rm -rf skills-srcUse ~/.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/
Install the "design-evaluation" agent skill from https://github.com/Abhinavbwj/Urban-Design-Skills-Claude/tree/main/skills/design-evaluation into .claude/skills/design-evaluation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-evaluation", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Abhinavbwj/Urban-Design-Skills-Claude/tree/main/skills/design-evaluationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude design-evaluation --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/design-evaluation .agents/skills/design-evaluation && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "design-evaluation" agent skill from https://github.com/Abhinavbwj/Urban-Design-Skills-Claude/tree/main/skills/design-evaluation into .agents/skills/design-evaluation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-evaluation", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude design-evaluation --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/design-evaluation .cursor/skills/design-evaluation && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "design-evaluation" agent skill from https://github.com/Abhinavbwj/Urban-Design-Skills-Claude/tree/main/skills/design-evaluation into .cursor/skills/design-evaluation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-evaluation", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git --path skills/design-evaluation--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude design-evaluation --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/design-evaluation .gemini/skills/design-evaluation && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "design-evaluation" agent skill from https://github.com/Abhinavbwj/Urban-Design-Skills-Claude/tree/main/skills/design-evaluation into .gemini/skills/design-evaluation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-evaluation", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude design-evaluationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/design-evaluation .github/skills/design-evaluation && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "design-evaluation" agent skill from https://github.com/Abhinavbwj/Urban-Design-Skills-Claude/tree/main/skills/design-evaluation into .github/skills/design-evaluation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-evaluation", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude design-evaluation --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Abhinavbwj/Urban-Design-Skills-Claude.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/design-evaluation .opencode/skills/design-evaluation && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "design-evaluation" agent skill from https://github.com/Abhinavbwj/Urban-Design-Skills-Claude/tree/main/skills/design-evaluation into .opencode/skills/design-evaluation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-evaluation", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
design-evaluationEvaluate urban designs against comprehensive criteria drawn from all major global standards, certification systems, and theoretical frameworks.
Design Evaluation is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. Evaluate urban designs against comprehensive criteria drawn from all major global standards, certification systems, and theoretical frameworks. Generates detailed scorecards and improvement recommendations. Use when the user asks to evaluate a design, review a masterplan, score a proposal, critique an urban scheme, assess design quality, benchmark a project, check compliance with standards, or rate a development against best practice. Covers Jan Gehl 12 Quality Criteria, Ian Bentley 7 Responsive Environments…
Its SKILL.md is about 9.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/benchmarks.md` and `references/evaluation-criteria.md`).
It sits in Development, covering Design review and critique and Design patterns. The repository describes itself as: Urban Design Skills Claude. The licence is MIT.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 666327b. It shows what the files ask for, not the result of running them.
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.
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.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Design Evaluation loads about 9.2k tokens when it runs, and up to ~28k if it reads all its reference files. Until then it costs about 183 tokens; SKILL.md has 3,843 words of instructions outside code blocks.
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.
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.
The full file from Abhinavbwj/Urban-Design-Skills-Claude at commit 666327b, republished under its MIT licence (© Abhinavbwj). 3,843 words, ~9,205 tokens.
.claude/skills/design-evaluation/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.You are an expert urban design evaluator with deep knowledge of every major design quality framework, certification system, and theoretical tradition used globally. When the user asks you to evaluate a design, follow the structured methodology below to produce a rigorous, evidence-based assessment.
Before scoring, determine the appropriate evaluation scope based on the user's request and the nature of the project. Use this decision tree:
If the user asks about general design quality or a broad evaluation:
If the user asks specifically about sustainability certification:
sustainability-scoring skill, which handles LEED-ND, BREEAM Communities, Estidama, Green Mark, and other green certification systems.If the user asks about public space quality specifically:
references/evaluation-criteria.md for the full rubric.If the user asks about safety and security:
references/evaluation-criteria.md.If the user asks about inclusivity, accessibility, or universal design:
references/evaluation-criteria.md.If the user asks about street quality:
references/evaluation-criteria.md.If the user asks for a comprehensive or full evaluation:
references/benchmarks.md.If the user provides a specific project name without specifying scope:
Always ask clarifying questions if the project description is too vague to score. You need at minimum: site location or context, land use program, approximate scale/density, and street/block layout information.
The Composite Scorecard distills the most important criteria from multiple established frameworks into a unified 30-criterion assessment. Each criterion is scored 1-5 (1 = very poor, 5 = exemplary). The total score is out of 150 points.
| # | Criterion | Source Framework | What to Assess |
|---|---|---|---|
| A1 | Permeability | Bentley | Number of route choices available to pedestrians; presence of through-routes; absence of dead ends and gated barriers |
| A2 | Street Connectivity | LEED-ND / Transport Planning | Intersection density (target >100/km2); connected street ratio; cul-de-sac ratio |
| A3 | Block Size and Grain | Jacobs / Gehl | Block perimeter (target 300-500m); block face length (target <100m); mid-block passages |
| A4 | Transit Accessibility | TOD Standards | Distance to nearest transit stop (<400m bus, <800m rail); service frequency; stop quality |
| A5 | Cycling Provision | Healthy Streets | Dedicated cycling infrastructure; bike parking; network continuity; safety at junctions |
| # | Criterion | Source Framework | What to Assess |
|---|---|---|---|
| B1 | Land Use Diversity | Jacobs / LEED-ND | Shannon diversity index of uses; number of distinct use categories within 400m walk |
| B2 | Active Ground Floors | Gehl / Bentley | Percentage of ground floor frontage with active uses (shops, cafes, lobbies, workshops) |
| B3 | 24-Hour Activity | Gehl / PPS | Presence of uses generating activity across morning, afternoon, evening, and weekend periods |
| B4 | Density Adequacy | Density Atlas / Local Standards | Dwelling units per hectare and FAR relative to context and transit capacity; avoidance of both under- and over-density |
| B5 | Housing Diversity | Inclusive Design | Mix of unit types (studio to 4-bed), mix of tenures (market, affordable, social), mix of building types (apartment, townhouse, live-work) |
| # | Criterion | Source Framework | What to Assess |
|---|---|---|---|
| C1 | Public Space Quantity | WHO / Local Standards | Total public open space per capita (target >9m2/person); distribution within 300m of all dwellings |
| C2 | Public Space Quality | PPS / Gehl | Comfort (seating, shade, shelter); programming; maintenance; social gathering capacity |
| C3 | Green Space Provision | WHO / LEED-ND | Accessible green space per capita; park hierarchy (pocket, neighborhood, district); biodiversity value |
| C4 | Streetscape Quality | Gehl / Healthy Streets | Street trees, paving quality, street furniture, lighting quality, absence of visual clutter |
| C5 | Edge Activation | Gehl | Quality of building-street interface; frequency of doors/windows per 100m; transparency; setback appropriateness |
| # | Criterion | Source Framework | What to Assess |
|---|---|---|---|
| D1 | Pedestrian Comfort | Gehl / Healthy Streets | Footpath width (>2m clear); surface quality; gradient; crossing frequency; pedestrian level of service |
| D2 | Traffic Safety | Vision Zero / Healthy Streets | Speed limit (target 30km/h or below in residential); traffic calming; conflict point design; crash data if available |
| D3 | Perceived Safety (CPTED) | CPTED | Natural surveillance; sightlines; lighting adequacy (>20 lux); active edges; absence of entrapment spots |
| D4 | Noise Environment | WHO / Healthy Streets | Distance from major noise sources; noise mitigation measures; quiet areas provision; facade treatment |
| D5 | Microclimate Comfort | Gehl / Biophilic Design | Wind protection; summer shade provision; winter sun access; rain shelter along key routes; thermal comfort hours |
| # | Criterion | Source Framework | What to Assess |
|---|---|---|---|
| E1 | Legibility | Lynch / Bentley | Clear paths, edges, districts, nodes, and landmarks; ease of wayfinding; mental map clarity |
| E2 | Visual Appropriateness | Bentley | Contextual fit; scale relationships; material palette; architectural language coherence |
| E3 | Human Scale | Gehl / Alexander | Building articulation at ground level; detail richness at eye level; H:W ratio (target 1:1 to 1:3); vertical rhythm |
| E4 | Richness of Experience | Bentley / Gehl | Sensory variety; material diversity; spatial sequence variety; seasonal interest; art and culture |
| E5 | Heritage Sensitivity | ICOMOS / Local Policy | Response to existing heritage assets; archaeological sensitivity; adaptive reuse; memory of place |
| # | Criterion | Source Framework | What to Assess |
|---|---|---|---|
| F1 | Environmental Performance | LEED-ND / BREEAM | Energy strategy; embodied carbon approach; renewable energy provision; operational carbon target |
| F2 | Water Management | SUDS / LEED-ND | Sustainable drainage systems; rainwater harvesting; permeable surfaces percentage; flood risk mitigation |
| F3 | Biodiversity | LEED-ND / Local Ecology | Habitat creation; native planting; ecological connectivity; green/brown roof provision; biodiversity net gain |
| F4 | Climate Adaptation | C40 / Resilience Planning | Urban heat island mitigation; flood resilience; drought preparedness; extreme weather adaptation measures |
| F5 | Resource Efficiency | Circular Economy Principles | Material sourcing strategy; construction waste targets; lifecycle thinking; adaptability of buildings for future use change |
Use the following detailed rubrics to assign scores. Each criterion has specific, observable evidence requirements for each score level.
A1 - Permeability
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Single or very few access points; gated/walled enclosure; no through-movement possible |
| 2 | Poor | Limited route choices; significant barriers; several dead-ends; circuitous routes required |
| 3 | Adequate | Reasonable route choice; some through-routes present; minor barriers exist but alternatives available |
| 4 | Good | Multiple direct routes available; few dead-ends; pedestrians can move freely in most directions |
| 5 | Excellent | Fine-grained network with abundant route choices; full permeability for pedestrians; mid-block passages; no barriers |
A2 - Street Connectivity
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Intersection density <40/km2; dominated by cul-de-sacs; dendritic road pattern |
| 2 | Poor | Intersection density 40-70/km2; some connectivity gaps; limited cross-connections |
| 3 | Adequate | Intersection density 70-100/km2; grid with some interruptions; reasonable connectivity |
| 4 | Good | Intersection density 100-140/km2; well-connected grid or modified grid; few dead ends |
| 5 | Excellent | Intersection density >140/km2; highly connected network; 4-way intersections predominate; all streets through-connected |
A3 - Block Size and Grain
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Block perimeters >800m; superblocks without internal pedestrian routes; monotonous grain |
| 2 | Poor | Block perimeters 600-800m; limited mid-block connections; coarse grain |
| 3 | Adequate | Block perimeters 450-600m; some variation in block size; occasional mid-block passages |
| 4 | Good | Block perimeters 300-450m; good variation; mid-block passages present; fine to medium grain |
| 5 | Excellent | Block perimeters 250-400m with fine grain; frequent mid-block passages; varied block shapes responding to context |
A4 - Transit Accessibility
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | No transit within 800m; car-dependent location |
| 2 | Poor | Bus stop within 800m but low frequency (>20 min headway); no rail access within 1.5km |
| 3 | Adequate | Bus within 400m at 10-20 min headway OR rail within 800m at moderate frequency |
| 4 | Good | Bus within 400m at <10 min headway AND rail within 800m; good stop/station quality |
| 5 | Excellent | Multiple transit modes within 400m; high frequency (<5 min headway); excellent station quality; integrated transfers |
A5 - Cycling Provision
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | No cycling infrastructure; hostile road conditions; no bike parking |
| 2 | Poor | Painted bike lanes on busy roads; minimal bike parking; disconnected network |
| 3 | Adequate | Some protected lanes; reasonable bike parking; connects to citywide network at some points |
| 4 | Good | Connected protected bike lane network; secure bike parking at destinations; junction treatments |
| 5 | Excellent | Comprehensive separated cycling network; abundant secure parking; bike-share; cargo bike facilities; cycling-priority intersections |
B1 - Land Use Diversity
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Single use (monoculture); no services within 400m walk |
| 2 | Poor | 2-3 use types; limited daily needs provision; car trip required for most errands |
| 3 | Adequate | 4-6 use types; basic daily needs within 400m; some evening activity |
| 4 | Good | 7-10 use types; most daily needs walkable; active day and evening economy |
| 5 | Excellent | >10 use types; 20-minute neighborhood achieved; vibrant mixed economy; fine-grained use integration |
B2 - Active Ground Floors
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | <20% active frontage; blank walls and parking structures dominate ground floor |
| 2 | Poor | 20-40% active frontage; significant stretches of dead frontage |
| 3 | Adequate | 40-60% active frontage; activity concentrated at nodes; some dead stretches |
| 4 | Good | 60-80% active frontage; most streets have active edges; minimal dead frontage |
| 5 | Excellent | >80% active frontage; continuous shop fronts, lobbies, and active uses; frequent doors per 100m (>15) |
B3 - 24-Hour Activity
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Activity only during single period (e.g., office hours only); dead outside that window |
| 2 | Poor | Activity during 2 periods but significant dead hours; no evening or weekend presence |
| 3 | Adequate | Activity during daytime and some evening; moderate weekend activity |
| 4 | Good | Consistent activity across 3 periods (morning, afternoon, evening); good weekend presence |
| 5 | Excellent | Genuine 18-hour activity; morning through late evening vibrancy; strong weekend programming; seasonal events |
B4 - Density Adequacy
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Density far below what context/transit supports (<20 DU/ha in urban area); land wasted |
| 2 | Poor | Under-density relative to location; insufficient to support transit or local services |
| 3 | Adequate | Density appropriate to context; supports basic local services and moderate transit frequency |
| 4 | Good | Density supports vibrant neighborhood life, walkable services, and frequent transit; 50-120 DU/ha urban |
| 5 | Excellent | Optimal density for location; supports full 20-minute neighborhood; transit-supportive; avoids overcrowding; 80-200 DU/ha with quality |
B5 - Housing Diversity
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Single unit type and tenure; no affordability provision |
| 2 | Poor | 2 unit types; single tenure; token affordability (<10%) |
| 3 | Adequate | 3-4 unit types; 2 tenures; 10-20% affordable; some building type variety |
| 4 | Good | 4-6 unit types; 3 tenures; 20-35% affordable; townhouses and apartments mixed |
| 5 | Excellent | Full spectrum of unit types (studio to 4-bed+); market, affordable, social, co-op tenures; >35% affordable; intergenerational design |
C1 - Public Space Quantity
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | <3 m2 public open space per person; major gaps in provision |
| 2 | Poor | 3-6 m2/person; uneven distribution; some areas >500m from any public space |
| 3 | Adequate | 6-9 m2/person; most areas within 400m of a public space |
| 4 | Good | 9-15 m2/person; all areas within 300m; good hierarchy of spaces |
| 5 | Excellent | >15 m2/person; all areas within 300m; full hierarchy (pocket, neighborhood, district); well-distributed |
C2 - Public Space Quality
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Poorly maintained; no seating; no shade/shelter; feels unsafe; unused |
| 2 | Poor | Basic maintenance; minimal seating; limited shade; little programming |
| 3 | Adequate | Reasonable maintenance; adequate seating; some shade; occasional use |
| 4 | Good | Well-maintained; comfortable seating variety; good shade/shelter; regular programming; well-used |
| 5 | Excellent | Exceptional quality; varied seating options; excellent microclimate management; active programming; social gathering hub; loved by community |
C3 - Green Space Provision
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | <5 m2 green space per person; no park access within 400m |
| 2 | Poor | 5-9 m2/person; limited park access; low biodiversity |
| 3 | Adequate | 9-15 m2/person; park within 400m; some biodiversity value |
| 4 | Good | 15-25 m2/person; multiple parks within 400m; good biodiversity; hierarchy present |
| 5 | Excellent | >25 m2/person; rich park hierarchy; high biodiversity; ecological corridors; community growing spaces |
C4 - Streetscape Quality
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | No street trees; poor paving; no furniture; hostile environment |
| 2 | Poor | Sparse trees; basic paving; minimal furniture; cluttered signage |
| 3 | Adequate | Regular tree planting; decent paving; functional furniture; acceptable lighting |
| 4 | Good | Mature tree canopy; quality paving materials; coordinated furniture suite; good lighting; low clutter |
| 5 | Excellent | Abundant tree canopy (>25% coverage); premium materials; elegant coordinated furniture; excellent lighting; rain gardens; public art |
C5 - Edge Activation
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Blank walls; parking frontage; no windows or doors facing street; hostile edges |
| 2 | Poor | Minimal openings; large setbacks; infrequent entries; garage-dominated frontage |
| 3 | Adequate | Regular windows at ground level; entries every 15-20m; moderate transparency |
| 4 | Good | Frequent entries (<15m apart); high transparency; displays and activity visible; building life spills to street |
| 5 | Excellent | Continuous active edge; entries every 5-10m; full transparency; interior activity visible; seating spills out; awnings and canopies |
D1 - Pedestrian Comfort
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Footpaths <1.2m or absent; poor surfaces; no crossings; pedestrians marginalized |
| 2 | Poor | Footpaths 1.2-1.8m; uneven surfaces; infrequent crossings; obstacles present |
| 3 | Adequate | Footpaths 1.8-2.5m; reasonable surfaces; crossings at main intersections; some obstacles |
| 4 | Good | Footpaths 2.5-4m clear; smooth surfaces; frequent crossings; minimal obstacles; accessible gradients |
| 5 | Excellent | Footpaths >4m clear; premium surfaces; pedestrian-priority crossings; fully accessible; generous pedestrian realm |
D2 - Traffic Safety
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Speed limits >50km/h in residential; no traffic calming; high conflict points |
| 2 | Poor | Speed limits 40-50km/h; minimal calming; some conflict points unmanaged |
| 3 | Adequate | Speed limits 30-40km/h; basic traffic calming; main conflict points addressed |
| 4 | Good | Speed limits 30km/h; comprehensive calming (raised tables, chicanes, narrowings); safe junction design |
| 5 | Excellent | 20km/h zones or car-free areas; shared space design; Vision Zero principles fully applied; near-zero conflict |
D3 - Perceived Safety (CPTED)
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Poor natural surveillance; dark areas; entrapment spots; no territorial definition |
| 2 | Poor | Limited surveillance from buildings; inconsistent lighting; some hidden areas |
| 3 | Adequate | Moderate surveillance; adequate lighting (>10 lux); few hidden areas; basic territorial markers |
| 4 | Good | Good natural surveillance from active uses; consistent lighting (>15 lux); clear sight lines; defined territories |
| 5 | Excellent | Excellent natural surveillance; bright consistent lighting (>20 lux); no entrapment spots; clear ownership; maintained environment |
D4 - Noise Environment
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | >70 dB Lden in living areas; no noise mitigation; adjacent to motorway or rail without buffer |
| 2 | Poor | 65-70 dB Lden; minimal mitigation; significant traffic noise throughout |
| 3 | Adequate | 55-65 dB Lden; some noise mitigation; quiet side facades available |
| 4 | Good | 50-55 dB Lden in most areas; effective noise mitigation; quiet courtyards and parks |
| 5 | Excellent | <50 dB Lden in living areas; designated quiet areas; acoustic design excellence; traffic noise eliminated from public spaces |
D5 - Microclimate Comfort
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | No wind protection; no shade in summer; no sun access in winter; uncomfortable >50% of year |
| 2 | Poor | Minimal wind/shade strategy; some discomfort issues; large exposed areas |
| 3 | Adequate | Basic wind and shade consideration; mostly comfortable in moderate conditions |
| 4 | Good | Effective wind protection; good shade provision; winter sun access; rain shelter on key routes |
| 5 | Excellent | Comprehensive microclimate design; wind comfort verified by CFD; summer shade >60%; winter sun optimized; thermal comfort >80% of daylight hours |
E1 - Legibility
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Disorienting; no landmarks; repetitive layout; impossible to form mental map |
| 2 | Poor | Weak structure; few landmarks; confusing wayfinding; limited spatial hierarchy |
| 3 | Adequate | Basic structure readable; some landmarks; functional wayfinding; identifiable center |
| 4 | Good | Clear paths, nodes, landmarks; intuitive wayfinding; distinct character areas; strong spatial hierarchy |
| 5 | Excellent | Highly legible; memorable landmarks; effortless navigation; rich mental map; clear district identity within city context |
E2 - Visual Appropriateness
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Completely out of context; alien scale and materials; no relationship to setting |
| 2 | Poor | Weak contextual response; jarring scale shifts; unrelated material palette |
| 3 | Adequate | Acceptable contextual relationship; reasonable scale; some material connections |
| 4 | Good | Thoughtful contextual response; harmonious scale; complementary materials; contemporary-contextual balance |
| 5 | Excellent | Masterful contextual integration; enriches the setting; confident contemporary identity rooted in place; material excellence |
E3 - Human Scale
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Overwhelming scale; no ground-level articulation; H:W >1:5 or undefined; inhuman proportions |
| 2 | Poor | Dominant large scale; minimal ground articulation; H:W issues; limited pedestrian-level detail |
| 3 | Adequate | Moderate scale; some ground-level detail; H:W roughly 1:2 to 1:3; acceptable proportions |
| 4 | Good | Comfortable scale; good ground-level articulation; H:W 1:1 to 1:2; vertical rhythm; canopies and projections |
| 5 | Excellent | Exquisite human scale; rich ground-level detail and texture; H:W around 1:1; fine vertical rhythm; sense of enclosure and intimacy |
E4 - Richness of Experience
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Monotonous; single material; no sensory variation; sterile environment |
| 2 | Poor | Limited variety; 1-2 materials; minimal sensory interest; repetitive |
| 3 | Adequate | Some variety in materials and spaces; moderate sensory interest; functional planting |
| 4 | Good | Rich material palette; varied spatial sequence; seasonal planting; water features or art; multi-sensory |
| 5 | Excellent | Extraordinary richness; diverse materials, textures, sounds, scents; surprising spatial sequences; public art; seasonal transformation; delight |
E5 - Heritage Sensitivity
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Heritage assets destroyed or ignored; no acknowledgment of site history |
| 2 | Poor | Minimal heritage response; important features lost; token gestures |
| 3 | Adequate | Heritage assets retained; basic setting respected; some interpretation |
| 4 | Good | Heritage assets enhanced; setting improved; adaptive reuse; meaningful interpretation |
| 5 | Excellent | Heritage assets celebrated; exemplary adaptive reuse; rich storytelling; archaeological sensitivity; memory of place woven into design |
F1 - Environmental Performance
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | No energy strategy; conventional construction; no renewables |
| 2 | Poor | Basic code compliance only; minimal sustainability measures |
| 3 | Adequate | Energy-efficient design; some renewables; meets current standards |
| 4 | Good | Near-zero carbon operation; significant renewables; low embodied carbon strategy; exceeds standards |
| 5 | Excellent | Net-zero or net-positive energy; comprehensive lifecycle carbon strategy; on-site renewables; Passivhaus or equivalent |
F2 - Water Management
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Conventional drainage; full surface runoff to sewer; no water strategy |
| 2 | Poor | Basic SUDS; limited permeable surfaces; no rainwater harvesting |
| 3 | Adequate | Reasonable SUDS integration; some permeable surfaces (20-40%); basic rainwater collection |
| 4 | Good | Comprehensive SUDS; >40% permeable surfaces; rainwater harvesting; greywater recycling; bioswales |
| 5 | Excellent | Water-sensitive urban design; >60% permeable; closed-loop water; sponge city principles; visible water celebration; flood-positive |
F3 - Biodiversity
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | Net biodiversity loss; no habitat provision; all hard landscape |
| 2 | Poor | Minimal biodiversity; ornamental planting only; no ecological strategy |
| 3 | Adequate | Biodiversity maintained; some native planting; basic habitat provision |
| 4 | Good | Biodiversity net gain; significant native planting; green roofs; habitat corridors; ecological connectivity |
| 5 | Excellent | Significant biodiversity net gain (>20%); rich habitat mosaic; ecological corridors connected to wider network; community growing; urban forest strategy |
F4 - Climate Adaptation
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | No climate adaptation measures; vulnerable to flooding, heat, drought |
| 2 | Poor | Minimal adaptation; addresses one climate risk only; reactive approach |
| 3 | Adequate | Addresses main climate risks; moderate heat island mitigation; basic flood resilience |
| 4 | Good | Comprehensive adaptation; urban heat island reduction; flood resilience; drought preparedness; cool materials |
| 5 | Excellent | Climate-positive design; extensive urban forest; cool surfaces throughout; flood resilience for 1-in-100+; adaptive capacity for 2050+ scenarios |
F5 - Resource Efficiency
| Score | Description | Observable Evidence |
|---|---|---|
| 1 | Very Poor | No resource strategy; demolish-and-rebuild; no waste targets |
| 2 | Poor | Basic waste management; conventional materials; no lifecycle thinking |
| 3 | Adequate | Recycled content; construction waste targets (<15 kg/m2); some adaptable buildings |
| 4 | Good | Circular economy principles; design for disassembly; significant recycled/local materials; adaptable buildings |
| 5 | Excellent | Full circular economy; cradle-to-cradle materials; design for disassembly throughout; material passport; adaptable infrastructure; zero waste target |
In addition to the qualitative scoring, check the following quantitative metrics against established benchmarks. Report each as pass/fail with the actual value.
| Metric | Target Range | Source Standard | Notes |
|---|---|---|---|
| Block Perimeter | 300-500m | Gehl / LEED-ND | <300m may be too fine for vehicles; >500m reduces walkability |
| Intersection Density | >100 per km2 | LEED-ND | Measured as 3+ leg intersections per square kilometer |
| Floor Area Ratio (FAR) | Context-dependent: 0.5-1.5 suburban, 1.5-4.0 urban, 4.0-10.0 central | Local zoning + Density Atlas | Must relate to transit capacity and infrastructure |
| Green Space per Capita | >9 m2/person | WHO recommendation | Accessible within 300m; higher targets in family neighborhoods |
| Parking Ratio | <0.5 spaces/unit (urban), <1.0 (suburban) | TOD Standard | Lower near high-frequency transit; includes shared parking |
| Height-to-Width Ratio (streets) | 1:1 to 1:3 | Gehl / Alexander | Proportional enclosure; >1:4 feels exposed; <1:0.5 feels oppressive |
| Active Frontage | >80% on primary streets, >50% on secondary | Gehl | Measured as linear meters of active use / total frontage |
| Tree Canopy Coverage | >25% of public realm area | Urban Forest Standards | At maturity; species diversity required |
| Dwelling Density | 50-200 DU/ha (urban) | Density Atlas / LEED-ND | Context-dependent; must support desired service threshold |
| Walk + Cycle Mode Share Target | >50% of trips | Sustainable Transport | Measured by trip generation model or comparable precedent |
| Footpath Width | >2.0m clear (minimum), >3.0m (preferred) | Accessibility Standards | Clear width excluding furniture and obstructions |
| Cycling Network Density | >3 km/km2 | Dutch CROW Standard | Protected or separated facilities |
| Public Space within 300m | 100% of dwellings | WHO / LEED-ND | Any public space >0.1 ha within 300m walking distance |
| Energy Performance | Net-zero operational carbon target | Paris Agreement / LEED-ND | Pathway to net-zero by 2050 at minimum |
| Affordable Housing | >20% of total units | Local policy dependent | Mix of affordable, social, and intermediate tenures |
Present evaluation results using the following standardized report format. Always complete every section.
# Design Evaluation Report: [Project Name]
**Location:** [City, Country]
**Scale:** [Site area in hectares] | [Approximate number of dwellings/GFA]
**Evaluator:** Claude (Urban Design Skills)
**Date:** [Current date]
**Framework Applied:** [Composite Scorecard / Gehl Deep Dive / CPTED / etc.]
---
## Overall Score: [X] / 150 - [Rating]
| Rating Band | Score Range | Description |
|-------------|------------|-------------|
| Excellent | 120-150 | Exemplary urban design; benchmark quality |
| Good | 90-119 | Strong design with minor improvements possible |
| Adequate | 60-89 | Acceptable design with significant improvement opportunities |
| Poor | <60 | Fundamental design issues requiring major revision |
---
## Category Summary
| Category | Score (/25) | Average (/5) | Rating |
|----------|------------|--------------|--------|
| A. Connectivity & Access | [X] | [X.X] | [Rating] |
| B. Vitality & Mix | [X] | [X.X] | [Rating] |
| C. Public Realm | [X] | [X.X] | [Rating] |
| D. Comfort & Safety | [X] | [X.X] | [Rating] |
| E. Identity & Character | [X] | [X.X] | [Rating] |
| F. Sustainability & Resilience | [X] | [X.X] | [Rating] |
| **TOTAL** | **[X]/150** | **[X.X]** | **[Rating]** |
---
## Detailed Scorecard
| # | Criterion | Category | Score (1-5) | Evidence / Justification | Recommendation |
|---|-----------|----------|-------------|--------------------------|----------------|
| A1 | Permeability | Connectivity | [X] | [Specific observed evidence] | [Specific improvement action] |
| A2 | Street Connectivity | Connectivity | [X] | ... | ... |
| ... | ... | ... | ... | ... | ... |
| F5 | Resource Efficiency | Sustainability | [X] | ... | ... |
---
## Quantitative Metrics Check
| Metric | Target | Actual / Estimated | Pass/Fail | Notes |
|--------|--------|--------------------|-----------|-------|
| Block Perimeter | 300-500m | [Xm] | [P/F] | [Notes] |
| Intersection Density | >100/km2 | [X/km2] | [P/F] | ... |
| ... | ... | ... | ... | ... |
---
## Radar Chart Data (for visualization)
Category A: [X.X]
Category B: [X.X]
Category C: [X.X]
Category D: [X.X]
Category E: [X.X]
Category F: [X.X]
---
## Top 5 Strengths
1. [Strength with evidence and score reference]
2. ...
3. ...
4. ...
5. ...
## Top 5 Areas for Improvement
1. [Weakness with evidence, score reference, and impact]
2. ...
3. ...
4. ...
5. ...
---
## Priority Recommendations
### Quick Wins (low cost, high impact, no redesign required)
1. [Action] - Expected improvement: [criterion] from [X] to [Y]
2. ...
3. ...
### Medium-Term Improvements (moderate cost/effort)
1. [Action] - Expected improvement: [criterion] from [X] to [Y]
2. ...
3. ...
### Structural Changes (significant redesign or investment required)
1. [Action] - Expected improvement: [criterion] from [X] to [Y]
2. ...
3. ...
---
## Benchmark Comparison
| Metric | This Project | [Exemplar 1] | [Exemplar 2] | [Exemplar 3] |
|--------|-------------|--------------|--------------|--------------|
| FAR | ... | ... | ... | ... |
| DU/ha | ... | ... | ... | ... |
| Green Space m2/pp | ... | ... | ... | ... |
| Active Frontage % | ... | ... | ... | ... |
(Select 2-3 comparable exemplars from references/benchmarks.md)Rating Scale Interpretation:
For deeper framework-specific evaluation criteria, refer to:
references/evaluation-criteria.md - Full criteria from Gehl, Bentley, PPS, Healthy Streets, CPTED, Universal Design, and Biophilic Design frameworksreferences/benchmarks.md - Exemplar project metrics for benchmarking comparisonsExternal 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
SKILL.md and 2 other files (references) in skills/design-evaluation of Abhinavbwj/Urban-Design-Skills-Claude.
Open the folder on GitHubat commit 666327b
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.
Design Evaluation 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Design Evaluation this skillAbhinavbwj/Urban-Design-Skills-Claude | 132 | 1 repos | ~9.2k | Automated safety check: Pass | MIT | |
| Cleanupsimstudioai/sim | 30k | — | ~1.4k | Automated safety check: Pass | Apache-2.0 | |
| 122 Java Type Designjabrena/plinth | 446 | — | ~977 | Automated safety check: Pass | Apache-2.0 | |
| Vercel Composition Patternssupabase/supabase | 111k | 59 repos | ~726 | Automated safety check: Pass | MIT | |
| Swiftui View RefactorDimillian/Skills | 4k | 5 repos | ~2k | Automated safety check: Pass | MIT | |
| RTK Rust Design Patternsrtk-ai/rtk | 83k | — | ~1.9k | Automated safety check: Pass | Apache-2.0 |
simstudioai/sim
Run all code quality skills — effects, memo, callbacks, state, React Query, emcn design review, url-state, comments, and test-audit — analyzing in parallel, then applying fixes sequentially
jabrena/plinth
A skill your agent uses when you need to review, improve, or refactor Java code for type design quality — including establishing clear type hierarchies, applying consistent naming conventions…
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
Dimillian/Skills
Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow, stable view trees, explicit dependency injection, and correct Observation usage.
rtk-ai/rtk
Describes seven Rust design patterns for the RTK CLI filter modules, with when to use each, RTK examples, and notes on when a pattern is overkill.
UsefulSoftwareCo/executor
Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect.
Abhinavbwj/Urban-Design-Skills-Claude
Estimate construction costs, infrastructure costs, soft costs, and total development costs for urban design projects.
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.
Abhinavbwj/Urban-Design-Skills-Claude
Design urban blocks and optimize density using typological analysis, FAR calculations, and building configuration strategies.
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…
Abhinavbwj/Urban-Design-Skills-Claude
Research and analyze urban design precedents systematically.
Abhinavbwj/Urban-Design-Skills-Claude
Conduct comprehensive multi-scale site analysis from regional to neighborhood to site scale.
Categories
Evaluate urban designs against comprehensive criteria drawn from all major global standards, certification systems, and theoretical frameworks. Design Evaluation is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. Evaluate urban designs against comprehensive criteria drawn from all major global standards, certification systems, and theoretical frameworks.
Design Evaluation fits situations like: the user asks to evaluate a design; review a masterplan; score a proposal; critique an urban scheme.
Run `npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a claude-code`. Or copy the skill folder (skills/design-evaluation in Abhinavbwj/Urban-Design-Skills-Claude) into .claude/skills/design-evaluation in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill design-evaluation -a codex`. Or copy the skill folder (skills/design-evaluation in Abhinavbwj/Urban-Design-Skills-Claude) into .agents/skills/design-evaluation in your project. Codex loads it when a task matches its description.
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 design-evaluation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-evaluation, .gemini/skills/design-evaluation, .github/skills/design-evaluation and .opencode/skills/design-evaluation in your project.
SKILL.md names no scripts, command-line tools or credentials: Design Evaluation is instructions for the agent only.
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.
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.
Design Evaluation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
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 19k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Design Evaluation: Cleanup (simstudioai/sim, 30k stars), 122 Java Type Design (jabrena/plinth, 446 stars), Vercel Composition Patterns (supabase/supabase, 111k stars) and Swiftui View Refactor (Dimillian/Skills, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
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.