Agent skill

Urban Calculator

by Abhinavbwj in 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.

MITAuto-check passed

Install Urban Calculator

skills CLI
$ npx skills add Abhinavbwj/Urban-Design-Skills-Claude --skill urban-calculator -a claude-code

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

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

At a glance

Python computational tools for urban design metric calculations including density, FAR, walkability scoring, parking requirements, green space analysis, and block optimization.

  • Works in 4 steps: From a design skill: After generating a… → From a masterplan skill: Use… → From an analysis skill: Run… → …
  • The user asks to calculate density
  • SKILL.md covers Available Calculators, Usage Instructions, Formula Reference and Integration, plus 1 more section
  • Runs Python scripts from its folder; calls python

What it does

Urban Calculator is an agent skill from 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. Use when the user asks to calculate density, compute FAR, score walkability, determine parking requirements, analyze green space provision, optimize block dimensions, run urban metrics, or perform any quantitative urban design calculation. Also use when precise numbers are needed for any urban design metric rather than rules of thumb.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `references/formulas.md`, `scripts/block_optimizer.py` and `scripts/density_calculator.py`).

It works with Python. The repository describes itself as: Urban Design Skills Claude. The licence is MIT.

When your agent uses it

  • The user asks to calculate density
  • Score walkability
  • Determine parking requirements
  • Analyze green space provision

Example prompts

  • “/urban-calculator”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash(python *)

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. From a design skill: After generating a site layout, call density_calculator.py and far_calculator.py with the computed areas to validate…
  2. From a masterplan skill: Use block_optimizer.py to determine block dimensions before laying out the street grid.
  3. From an analysis skill: Run walkability_scorer.py and green_space_analyzer.py to evaluate design proposals against standards.
  4. Chaining calculators: Use the --json flag to pipe outputs between scripts programmatically.

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 these tools, so the agent can use them without asking each time:

    • Bash(python *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 6 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Urban Calculator loads about 1.9k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 133 tokens; SKILL.md has 531 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Abhinavbwj/Urban-Design-Skills-Claude at commit 666327b, republished under its MIT licence (© Abhinavbwj). 531 words, ~1,865 tokens.

Download SKILL.mdSave it as .claude/skills/urban-calculator/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
urban-calculator
description
Python computational tools for urban design metric calculations including density, FAR, walkability scoring, parking requirements, green space analysis, and block optimization. Use when the user asks to calculate density, compute FAR, score walkability, determine parking requirements, analyze green space provision, optimize block dimensions, run urban metrics, or perform any quantitative urban design calculation. Also use when precise numbers are needed for any urban design metric rather than rules of thumb.
allowed-tools
Bash(python *)

Urban Calculator

A suite of Python computational tools for precise urban design metric calculations. Each script is self-contained, accepts inputs via command-line arguments, and outputs both human-readable text and structured JSON.

Available Calculators

ScriptPurposeKey InputsKey Outputs
density_calculator.pyPopulation and dwelling densitySite area, FAR, unit sizes, efficiencyDU/ha, persons/ha, population
far_calculator.pyFAR and GFA optimizationSite area, coverage, floors, usesFAR, GFA per use, total GFA
walkability_scorer.pyWalk Score estimationAmenity distances, network connectivityScore 0-100, category
parking_calculator.pyParking requirementsUses, areas, ratios, reductionsTotal spaces, area needed
green_space_analyzer.pyGreen space adequacyPopulation, park areas, distancesPer capita m2, service coverage
block_optimizer.pyBlock dimension optimizationTarget FAR, height, coverage, daylightOptimal block dimensions

Usage Instructions

All scripts are located in the scripts/ subdirectory relative to this skill. Run them with Python 3 via the command line. Every script supports a --json flag to output structured JSON instead of formatted text.

Density Calculator

Calculate population and dwelling density for a development site:

bash
python scripts/density_calculator.py --site-area 20000 --far 2.5 --avg-unit-size 85 --efficiency 0.75 --household-size 2.5 --residential-pct 0.7 --streets-pct 0.30

Minimal example (uses defaults for optional parameters):

bash
python scripts/density_calculator.py --site-area 15000 --far 3.0

JSON output:

bash
python scripts/density_calculator.py --site-area 20000 --far 2.5 --json
FAR Calculator

Calculate Floor Area Ratio and Gross Floor Area by use:

bash
python scripts/far_calculator.py --site-area 10000 --coverage 0.6 --floors 4,6,8 --use-split "res:60,com:25,civic:10,open:5"

With bonus FAR for affordable housing:

bash
python scripts/far_calculator.py --site-area 10000 --coverage 0.6 --floors 6 --bonus-far 0.5

With explicit floor areas per zone:

bash
python scripts/far_calculator.py --site-area 10000 --floor-areas "2000,3000,1500" --floors "4,6,8"
Walkability Scorer

Estimate a Walk Score based on amenity distances and intersection density:

bash
python scripts/walkability_scorer.py --grocery 200 --restaurants 150 --shopping 400 --coffee 100 --parks 300 --schools 500 --intersection-density 150

Minimal example (unspecified amenities default to 9999m = not present):

bash
python scripts/walkability_scorer.py --grocery 300 --parks 200
Parking Calculator

Determine parking requirements with transit and TDM reductions:

bash
python scripts/parking_calculator.py --residential-units 200 --office-area 5000 --retail-area 2000 --transit-reduction 0.2 --shared-reduction 0.1 --space-type structured

Surface parking example:

bash
python scripts/parking_calculator.py --residential-units 50 --space-type surface
Green Space Analyzer

Analyze green space provision against international standards:

bash
python scripts/green_space_analyzer.py --population 5000 --parks "Central Park:8000:neighborhood,Pocket Plaza:400:pocket,River Walk:2000:linear" --standard who

JSON output with UN-Habitat standard:

bash
python scripts/green_space_analyzer.py --population 12000 --parks "Main Park:15000:district,Local Green:1200:neighborhood" --standard un-habitat --json
Block Optimizer

Find optimal block dimensions for a target FAR:

bash
python scripts/block_optimizer.py --target-far 2.5 --max-height 6 --building-depth 14 --min-courtyard 21 --daylight-angle 25

Higher density example:

bash
python scripts/block_optimizer.py --target-far 4.0 --max-height 10 --max-coverage 0.7 --building-depth 16

Formula Reference

All formulas, worked examples, unit conversions, and standard assumptions are documented in references/formulas.md. Key formulas used across the calculators:

  • FAR = Total GFA / Site Area
  • Net Density (DU/ha) = Dwelling Units / Net Site Area (ha)
  • Gross Density (DU/ha) = Dwelling Units / Gross Site Area including streets (ha)
  • Population Density = Net Density x Household Size
  • Walk Score = Weighted sum of distance-decay scores per amenity category, normalized to 0-100
  • Parking Spaces = Sum of (use area x ratio) x (1 - transit reduction) x (1 - shared reduction) x (1 - TDM reduction)
  • Green Space Per Capita = Total Green Space Area / Population

See references/formulas.md for the complete reference with worked examples.

Show full SKILL.md (167 more words)Show less

Integration

Other skills in the Urban Design Skills can invoke these calculators to get precise numbers. The recommended integration pattern is:

  1. From a design skill: After generating a site layout, call density_calculator.py and far_calculator.py with the computed areas to validate metrics.
  2. From a masterplan skill: Use block_optimizer.py to determine block dimensions before laying out the street grid.
  3. From an analysis skill: Run walkability_scorer.py and green_space_analyzer.py to evaluate design proposals against standards.
  4. Chaining calculators: Use the --json flag to pipe outputs between scripts programmatically.

Example chain (compute density then check green space):

bash
# Step 1: Calculate density to get population
python scripts/density_calculator.py --site-area 50000 --far 2.5 --json > density_output.json

# Step 2: Use the population estimate to check green space adequacy
python scripts/green_space_analyzer.py --population 3500 --parks "Park A:5000:neighborhood,Park B:800:pocket" --json

Output Formats

All scripts support two output modes:

  1. Human-readable text (default): Formatted tables and summaries suitable for reports and presentations. Includes section headers, aligned columns, and contextual notes.

  2. JSON (with --json flag): Structured data suitable for programmatic consumption, piping between scripts, and integration with other tools. All numeric values are provided as numbers (not strings), and all units are documented in the JSON keys.

Example JSON output structure (density calculator):

json
{
  "inputs": {
    "site_area_m2": 20000,
    "far": 2.5,
    "avg_unit_size_m2": 85,
    "efficiency": 0.75,
    "household_size": 2.5,
    "residential_pct": 0.7,
    "streets_pct": 0.30
  },
  "results": {
    "total_gfa_m2": 50000,
    "residential_gfa_m2": 35000,
    "net_internal_area_m2": 26250,
    "dwelling_units": 308,
    "population": 771,
    "net_density_du_per_ha": 154.0,
    "gross_density_du_per_ha": 107.8,
    "population_density_persons_per_ha": 385.0
  }
}

© 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 7 other files (scripts, references) in skills/urban-calculator of Abhinavbwj/Urban-Design-Skills-Claude.

  • SKILL.md
  • references/formulas.md
  • scripts/block_optimizer.py
  • scripts/density_calculator.py
  • scripts/far_calculator.py
  • scripts/green_space_analyzer.py
  • scripts/parking_calculator.py
  • scripts/walkability_scorer.py

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

Urban Calculator 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.

Urban Calculator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Urban Calculator this skillAbhinavbwj/Urban-Design-Skills-Claude1321 repos~1.9kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
PDF Processinganthropics/skills180k47 repos~2kAutomated safety check: PassProprietary
NotebookLM Research AssistantPleasePrompto/notebooklm-skill7.8k14 repos~2.4kAutomated safety check: NotesMIT
Manim Video Productionbrowser-use/video-use29k6 repos~3kAutomated safety check: PassMIT
PPT Masterhugohe3/ppt-master59k1 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • PDF Processing

    anthropics/skills

    Official

    Handles everyday PDF jobs in Python and on the command line: extract text and tables, merge, split, rotate, watermark, fill forms, encrypt and OCR.

    180k GitHub starsUsed in 47 repos~2k tokens
    Documents & OfficeAuto-check passed
  • NotebookLM Research Assistant

    PleasePrompto/notebooklm-skill

    Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.

    7.8k GitHub starsUsed in 14 repos~2.4k tokens
    Knowledge ManagementAuto-check: notes
  • Manim Video Production

    browser-use/video-use

    Produces math and technical explainer videos with Manim Community Edition: concept animations, equation derivations, algorithm walkthroughs and data stories.

    29k GitHub starsUsed in 6 repos~3k tokens
    Media & CreativeAuto-check passed
  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    59k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed
  • Scikit Learn

    zLanqing/codex-claude-academic-skills

    Machine learning in Python with scikit-learn. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 16 repos~3.9k tokens
    Data & AnalyticsAuto-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
  • Block And Density

    Abhinavbwj/Urban-Design-Skills-Claude

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

    132 GitHub starsUsed in 1 repo~7.5k 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

Works with

Questions about Urban Calculator

What does Urban Calculator do?

Python computational tools for urban design metric calculations including density, FAR, walkability scoring, parking requirements, green space analysis, and block optimization. Urban Calculator is an agent skill from 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.

When should I use Urban Calculator?

Urban Calculator fits situations like: the user asks to calculate density; score walkability; determine parking requirements; analyze green space provision.

How do I install Urban Calculator in Claude Code?

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

How do I install Urban Calculator in Codex?

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

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

What does Urban Calculator need to run?

Going by SKILL.md and its folder, Urban Calculator needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(python *).

Does Urban Calculator access the network?

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.

Is Urban Calculator 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Urban Calculator use?

Urban Calculator 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 Urban Calculator use?

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

What are the alternatives to Urban Calculator?

Skills that share tags, products or a category with Urban Calculator: MCP Server Builder (anthropics/skills, 180k stars), PDF Processing (anthropics/skills, 180k stars), NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars) and Manim Video Production (browser-use/video-use, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Urban Calculator?

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.