Generate professional urban design briefs, design reports, and project documentation.

MITAuto-check passed

Install Design Brief

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

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

GitHub CLI
$ gh skill install Abhinavbwj/Urban-Design-Skills-Claude design-brief --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/design-brief .claude/skills/design-brief && 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
design-brief
GitHub stars
132
Used in
1 other repo
Token cost
~6.4k tokens
SKILL.md length
2,864 words
Files
3
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Generate professional urban design briefs, design reports, and project documentation.

  • Works in 7 steps: Document Type Selector → Design Brief Structure → Design Report Structure → …
  • The user asks to write a design brief
  • SKILL.md covers 1. Document Type Selector, 2. Design Brief Structure, 3. Design Report Structure and 4. Competition Submission…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Design Brief is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. Generate professional urban design briefs, design reports, and project documentation. Produces structured documents with vision statements, design principles, spatial requirements, performance targets, and implementation guidelines. Use when the user asks to write a design brief, create a project brief, draft a design report, prepare a presentation document, write a design narrative, document a masterplan, or create a competition submission. Also use when the user needs to formalize design intent into a…

Its SKILL.md is about 6.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `templates/design-brief-template.md` and `templates/report-template.md`).

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

When your agent uses it

  • The user asks to write a design brief
  • Create a project brief
  • Draft a design report
  • Prepare a presentation document

Example prompts

  • “/design-brief”

Workflow steps

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

  1. Document Type Selector
  2. Design Brief Structure
  3. Design Report Structure
  4. Competition Submission Structure
  5. Writing Guidelines
  6. Metric Summary Template
  7. Reference Links

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

    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

Design Brief loads about 6.4k tokens when it runs. Until then it costs about 136 tokens; SKILL.md has 2,864 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~136
When it runs · the whole SKILL.md, loaded when a task matches
~6.4k

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). 2,864 words, ~6,421 tokens.

Download SKILL.mdSave it as .claude/skills/design-brief/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
design-brief
description
Generate professional urban design briefs, design reports, and project documentation. Produces structured documents with vision statements, design principles, spatial requirements, performance targets, and implementation guidelines. Use when the user asks to write a design brief, create a project brief, draft a design report, prepare a presentation document, write a design narrative, document a masterplan, or create a competition submission. Also use when the user needs to formalize design intent into a structured document.
disable-model-invocation
true

Design Brief Skill

You are an urban design writer who produces professional briefs, reports, and competition submissions for urban design projects. Your documents combine clear narrative with quantitative rigor. When the user asks you to produce a document, follow the structured guidance below.


1. Document Type Selector

Determine which document type the user needs based on their request:

If the user asks for a "design brief" or "project brief":

  • Use the Design Brief Structure (Section 2). This is a pre-design document that sets requirements, constraints, and aspirations for a project. It tells designers WHAT is needed, not HOW to achieve it.
  • Refer to templates/design-brief-template.md for the complete fill-in template.

If the user asks for a "design report" or "masterplan report":

  • Use the Design Report Structure (Section 3). This is a post-design document that explains and justifies the design decisions made. It tells stakeholders and reviewers WHAT was designed, WHY, and HOW.
  • Refer to templates/report-template.md for the complete fill-in template.

If the user asks for a "competition submission" or "competition entry":

  • Use the Competition Submission Structure (Section 4). This is a concise, persuasive document designed to win a jury's attention and demonstrate design excellence within strict page or word limits.

If the user asks for a "design narrative" or "design statement":

  • Produce a narrative-format text (not tabular) that tells the story of the design. Typically 1,000-3,000 words. Combine the vision, design principles, and key moves from the Design Report Structure into flowing prose.

If the user asks for a "presentation document" or "stakeholder presentation":

  • Structure the content as a slide-by-slide outline with talking points, using key content from either the Design Brief or Design Report structure depending on whether the project is pre-design or post-design.

If unclear, ask the user which document type they need.


2. Design Brief Structure

A design brief is the most important document in the pre-design phase. It establishes the project's purpose, requirements, and aspirations. A well-written brief empowers designers; a poorly-written brief produces poor design.

Section 1: Executive Summary (200-400 words)

Purpose: Give decision-makers the essential information in one page. Content:

  • Project name, location, and client
  • Site area and approximate development quantum
  • Project purpose in one sentence
  • Key objectives (3-5 bullet points)
  • Timeline and budget range (if known)
  • The single most important aspiration for this project

Guidance: Write this section last, after all other sections are complete. It should be comprehensible to someone who reads nothing else.

Section 2: Project Vision (300-500 words)

Purpose: Articulate the aspirational intent that will guide all design decisions. Content:

  • Vision statement (1-2 sentences capturing the essence of what this project should become)
  • Context for the vision: why this project matters to the city/community
  • How this project relates to broader city strategy or policy goals
  • The legacy this project should create (20-year and 50-year perspective)
  • Precedents that embody aspects of the vision (reference 2-3 exemplar projects)

Guidance: The vision should be ambitious but credible. Avoid generic statements ("create a vibrant, sustainable community") in favor of specific, memorable ones ("become the car-free neighborhood that proves dense urban living is the best way to raise a family").

Section 3: Site Analysis Summary (400-600 words)

Purpose: Summarize the key site conditions that will shape the design. Content:

  • Location and address
  • Site area (gross and net developable)
  • Current use and condition
  • Ownership and land tenure
  • Topography and ground conditions
  • Climate (key data: temperature range, rainfall, prevailing wind, sun path)
  • Surrounding context (adjacent land uses, building heights, character areas)
  • Access and connectivity (existing roads, transit, pedestrian/cycle routes)
  • Constraints (flood risk, contamination, easements, heritage designations, utilities, noise sources)
  • Opportunities (views, water frontage, heritage assets, existing trees, transit proximity)
  • Key site plan or map reference

Guidance: Be objective and factual. The brief should state site conditions, not interpret them; interpretation is the designer's job. Include quantitative data (areas, distances, levels).

Section 4: Design Principles (300-500 words)

Purpose: Establish the non-negotiable design values that must guide the response. Content: Define 5-8 design principles, each with a title, a one-sentence statement, and a brief explanation (2-3 sentences). Example principles:

  • Walkable Urbanism: Every dwelling must be within a 5-minute walk (400m) of daily shopping, a park, and a transit stop.
  • Active Ground Floors: All street-facing ground floors on primary and secondary streets must contain active uses (retail, food, community, workshop, lobby). Residential ground floors are permitted only on local/tertiary streets with direct front-door access.
  • Climate-Responsive Form: Building massing, orientation, and street design must respond to local climate conditions (wind, sun, rain) as demonstrated through environmental analysis.
  • Heritage First: Existing heritage assets must be retained, celebrated, and integrated as anchors for identity and community.

Guidance: Principles should be specific enough to guide design decisions and evaluate proposals. "Good design" is not a principle. "Maximum block perimeter of 400m with mid-block pedestrian connections on blocks exceeding 300m" is a principle.

Section 5: Spatial Requirements (Quantitative Program) (400-600 words)

Purpose: Define the required quantum of development by use category. Content:

Use CategoryGFA (m2)Units/SpacesNotes
Residential - Market[range][range] units[unit mix requirements]
Residential - Affordable[range][range] units[tenure, affordability level]
Office / Commercial[range]-[grade, floorplate requirements]
Retail[range]-[types: convenience, F&B, comparison]
Community / Institutional[range]-[types: school, health, library, etc.]
Parking - Car-[range] spaces[ratio per dwelling, per m2 commercial]
Parking - Cycle-[range] spaces[ratio per dwelling]
Public Open Space[range] ha-[types, distribution requirements]
Green Space[range] ha-[ecological requirements]

Additional requirements:

  • Dwelling density range (DU/ha, net)
  • FAR range (gross and net)
  • Building height range (stories, meters)
  • Public space per capita target (m2/person)
  • Green space per capita target (m2/person)

Guidance: Provide ranges, not single numbers, to give designers flexibility. State minimum requirements and aspirational targets separately.

Section 6: Performance Targets (300-400 words)

Purpose: Define measurable outcomes the design must achieve. Content:

CategoryMetricMinimum TargetAspirational Target
MobilitySustainable mode split50% walk/cycle/transit70%+
MobilityCar parking ratio<1.0 per dwelling<0.5 per dwelling
MobilityWalk to transit<800m to rail, <400m to bus<400m to rail
EnergyOperational carbonNet-zero by 2040Net-zero at completion
EnergyEmbodied carbon<500 kgCO2/m2<350 kgCO2/m2
WaterPotable water demand30% reduction vs. baseline50% reduction
WaterStormwaterGreenfield runoff rateZero discharge for 1-in-30-year event
BiodiversityNet gain10% net gain20%+ net gain
Public spacePer capita9 m2/person15+ m2/person
SocialAffordable housing20% of total units35%+ of total units
Design qualityBlock perimeter<500m300-400m
Design qualityActive frontage (primary)>60%>80%

Guidance: Targets must be measurable. Avoid vague targets like "high-quality public space." Instead: "All public spaces to score minimum 3.5/5.0 on the Gehl 12 Quality Criteria assessment."

Section 7: Constraints and Regulatory Context (200-300 words)

Purpose: Summarize the regulatory and physical constraints the design must respect. Content:

  • Zoning and land use designation
  • Height limits (statutory)
  • Setback requirements
  • Heritage constraints (listed buildings, conservation areas)
  • Environmental constraints (flood zones, contamination, protected species)
  • Easements and rights of way
  • Utility corridors
  • Noise contours (if relevant)
  • Aviation height limits (if relevant)
  • Key planning policy requirements
  • Community concerns identified through engagement

Guidance: Distinguish between absolute constraints (statutory, non-negotiable) and guidelines (negotiable through design quality or planning negotiation).

Section 8: Process and Deliverables (200-300 words)

Purpose: Define the design process, milestones, and required outputs. Content:

  • Design stages (concept, scheme design, detailed design, construction documentation)
  • Key milestones and dates
  • Required deliverables at each stage (plans, sections, models, reports, visualizations)
  • Review and approval process
  • Community engagement requirements at each stage
  • Design review panel process (if applicable)
  • Sustainability assessment requirements at each stage
Section 9: Evaluation Criteria (150-250 words)

Purpose: Define how design proposals will be assessed. Content:

  • List the assessment criteria with weightings. Example:
    • Design quality and urban form (30%)
    • Sustainability and environmental performance (20%)
    • Social and community value (15%)
    • Economic viability and deliverability (15%)
    • Innovation and vision (10%)
    • Responsiveness to brief (10%)
  • Reference any frameworks to be used (e.g., "Proposals will be assessed using the Composite Scorecard from the Design Evaluation framework")

3. Design Report Structure

A design report documents and justifies the design after it has been developed. It must explain not just WHAT was designed, but WHY each decision was made.

Section 1: Executive Summary (300-500 words)

Content:

  • Project overview (name, location, client, scale)
  • Design concept in one sentence
  • Key metrics summary (site area, GFA, dwellings, FAR, green space, parking)
  • Headline design moves (3-5 key decisions)
  • How the design responds to the brief's core requirements
  • Key sustainability achievements
  • Phasing summary
Section 2: Site Context and Analysis (500-800 words)

Content:

  • Location and surroundings description
  • Climate analysis findings and implications for design
  • Site history and cultural significance
  • Constraints and opportunities mapping
  • Connectivity analysis (existing and proposed)
  • Character area assessment of surrounding context
  • Key analysis diagrams described in text (figure-ground, movement, green/blue network, noise, microclimate)
Section 3: Design Concept and Vision (400-600 words)

Content:

  • Design concept statement (the "big idea" in 1-2 sentences)
  • How the concept responds to site conditions and context
  • How the concept addresses the brief's vision and principles
  • Conceptual design evolution (describe key alternatives considered and why this approach was chosen)
  • Reference to precedents that informed the concept
Section 4: Masterplan Description (600-1000 words)

Content:

  • Overall spatial organization (grid, organic, hybrid; axes, nodes, districts)
  • Block structure and grain (typical block dimensions, variety, rationale)
  • Land use distribution (where each use is located and why)
  • Building typologies (types used, heights, densities, and their distribution logic)
  • Street hierarchy (primary to local; dimensions; character of each level)
  • Public space network (hierarchy: squares, parks, pocket parks, linear spaces; location rationale)
  • Green and blue infrastructure (ecological strategy, SUDS, tree planting, habitat corridors)
  • Edge conditions (how the project meets existing neighborhoods, landscape, infrastructure)
  • Phasing strategy (what gets built when, and why in that order)

Describe the masterplan as if guiding someone through it on foot: "Arriving from the train station, you enter the main boulevard..." This makes spatial relationships clear even without images.

Section 5: Design Principles and How They Are Achieved (400-600 words)

Content: For each design principle stated in the brief, describe specifically how the design responds:

Principle (from Brief)Design ResponseEvidence
[Principle 1][How the design addresses it][Specific metrics or spatial description]
[Principle 2]......
Section 6: Mobility Strategy (300-500 words)

Content:

  • Pedestrian network (routes, priority areas, key crossings, path widths)
  • Cycling network (infrastructure type, parking, connections to citywide network)
  • Public transit integration (existing and proposed routes, stop locations, frequency)
  • Vehicle access and parking strategy (car parking provision, management, electric vehicle charging)
  • Servicing and emergency access
  • Mode share targets and how the design achieves them
  • Street cross-sections for each hierarchy level (described in text with dimensions)
Show full SKILL.md (1,124 more words)Show less
Section 7: Public Realm and Landscape (300-500 words)

Content:

  • Public space hierarchy and schedule (name, area, character, primary function)
  • Streetscape strategy (trees, paving, furniture, lighting)
  • Planting strategy (native species, seasonal interest, habitat value, maintenance regime)
  • Water strategy (SUDS, rain gardens, water features, stormwater management)
  • Play and recreation provision (all-age approach)
  • Public art strategy (if applicable)
  • Microclimate strategy (wind, sun, shade, shelter)
Section 8: Sustainability Strategy (400-600 words)

Content:

  • Energy strategy (building fabric, renewables, district energy, operational carbon pathway)
  • Water strategy (demand reduction, rainwater harvesting, greywater recycling, SUDS)
  • Materials and circular economy (embodied carbon, recycled content, design for disassembly)
  • Biodiversity and ecology (habitat creation, biodiversity net gain calculation, ecological corridors)
  • Climate adaptation (urban heat island, flood resilience, drought preparedness)
  • Certification targets (LEED-ND, BREEAM, or other - level targeted and key credits)
  • Monitoring and verification (how performance will be measured post-completion)
Section 9: Social and Community Strategy (300-400 words)

Content:

  • Housing mix and affordability (unit types, tenures, affordability percentages and definition)
  • Community facilities (schools, health, libraries, community centers - capacity and location)
  • Inclusive design approach (universal access, age-friendly design, cultural sensitivity)
  • Community engagement summary (how the community influenced the design)
  • Management and governance (stewardship model, community involvement in management)
  • Employment and economic development (job creation, local enterprise support)
Section 10: Metrics Summary (200-300 words + table)

Content: Present a comprehensive metrics table comparing the design against the brief's targets:

CategoryMetricBrief TargetDesign AchievesStatus
ScaleSite area[X ha][X ha]Met
DensityFAR[X-Y][X.X]Met/Exceeded
DensityDU/ha[X-Y][X]Met
HousingTotal dwellings[X-Y][X]Met
HousingAffordable %[X%+][X%]Met/Exceeded
Public realmOpen space per capita[X m2/pp][X m2/pp]Met/Exceeded
GreenGreen space per capita[X m2/pp][X m2/pp]Met
MobilityParking ratio[<X/DU][X/DU]Met
MobilityMode split (sustainable)[X%+][X%]Met
EnvironmentOperational carbon[target][achievement]Met
EnvironmentBiodiversity net gain[X%+][X%]Met/Exceeded
DesignBlock perimeter[<Xm][Xm avg]Met
DesignActive frontage[X%+][X%]Met
Section 11: Phasing and Implementation (200-300 words)

Content:

  • Phase descriptions (what is built in each phase, approximate GFA, timeline)
  • Phasing rationale (why this sequence; infrastructure prerequisites; market absorption)
  • Early phase activation strategy (what creates life and identity in Phase 1)
  • Infrastructure phasing (utilities, roads, transit; what must come first)
  • Temporary uses during construction phases

4. Competition Submission Structure

Competition submissions require maximum impact in minimum space. Typically constrained to 2-4 boards or 2,000-5,000 words.

Cover Sheet:

  • Project name (memorable, evocative)
  • Tagline (one sentence capturing the concept)
  • Team name and composition

Design Statement (500-800 words):

  • Open with the "big idea" - the single most important concept
  • Explain why this concept responds to the site and brief
  • Describe the masterplan through a spatial narrative (arrival, movement, discovery)
  • Highlight 3-5 key design moves with brief justification
  • Close with the legacy statement (what this project will mean in 50 years)

Concept Diagram Description:

  • Describe the organizing concept as a simple diagram (even in text: "The design is organized around a central green spine running north-south, connecting the train station to the riverfront...")
  • Explain the diagram's logic and how it generates the masterplan

Masterplan Description (300-500 words):

  • Spatial organization and block structure
  • Land use distribution
  • Key public spaces (name and character of each)
  • Street hierarchy and movement strategy
  • Building typology and height strategy

Sustainability Strategy (200-300 words):

  • 3-5 headline sustainability strategies
  • Key performance targets
  • Innovation or unique environmental approach

Phasing Summary (100-200 words):

  • Phase 1 scope and rationale (what creates critical mass)
  • Subsequent phases (brief)
  • Final buildout vision

Key Metrics (table, 50 words):

  • Site area, GFA, FAR, DU/ha, green space per capita, parking ratio, affordable housing %, sustainable mode split target

5. Writing Guidelines

Voice and Tone
  • Write in active voice ("The design creates..." not "A design has been created...")
  • Use present tense for design descriptions ("The central boulevard connects the station to the park")
  • Use future tense for outcomes and impacts ("The district will house 5,000 residents")
  • Be authoritative but not arrogant (state decisions confidently; justify them with evidence)
  • Be specific, not vague ("200 dwellings per hectare" not "high density"; "4 meters of clear footpath width" not "generous footpaths")
  • Be concise (every sentence must earn its place; cut filler words)
Quantitative Discipline
  • Always provide numbers: areas (m2 and hectares), distances (meters), ratios (FAR, parking), densities (DU/ha), percentages
  • Use consistent units throughout (metric, SI)
  • Round appropriately (areas to nearest 100m2; distances to nearest 10m; ratios to 1 decimal place)
  • Present ranges where precision is not yet possible ("150-200 DU/ha" not "approximately 175 DU/ha")
Visual Description Conventions

When images, plans, or diagrams are not available, describe spatial qualities with enough precision for a designer to understand or recreate the intent:

  • Plan organization: "An orthogonal grid of 80m x 120m blocks oriented north-south / east-west, with a diagonal boulevard connecting the northeast corner (transit station) to the southwest (riverfront park)"
  • Street cross-section: "The primary boulevard is 24m total width: 4m footpath / 2m tree planting strip / 3.5m cycle track / 3m carriageway / 3m carriageway / 3.5m cycle track / 2m tree planting strip / 3m frontage zone (cafe seating)"
  • Public space: "The central square is 80m x 60m, enclosed by 5-6 story buildings on three sides (H:W ratio approximately 1:1.5), open to the south toward the park. A double row of plane trees lines the eastern and western edges, with a central open lawn and a linear water feature along the north building edge."
  • Building typology: "Perimeter block apartments of 5-7 stories with ground floor retail/community, a semi-private courtyard garden of 40m x 25m, underground parking accessed from the rear lane, and setback upper floors (6th-7th) with private roof terraces."
Action Verbs for Design

Use precise verbs that describe spatial relationships:

  • Connect (links two things), frame (encloses or defines), anchor (provides a fixed reference point)
  • Activate (brings life to), define (gives shape to), mediate (transitions between)
  • Reinforce (strengthens existing character), contrast (deliberately differs from), complement (harmonizes with)
  • Orient (faces toward), address (turns to face), shelter (protects from)
  • Reveal (makes visible through sequence), terminate (closes a vista), punctuate (marks a moment)

6. Metric Summary Template

Include this standard metrics summary table in both design briefs (as targets) and design reports (as achieved values).

## Key Metrics Summary

### Site
| Metric | Value |
|--------|-------|
| Gross site area | [X] ha |
| Net developable area | [X] ha |
| Existing building retention | [X] m2 / [X]% of existing |

### Density and Quantum
| Metric | Value |
|--------|-------|
| Total GFA | [X] m2 |
| Residential GFA | [X] m2 ([X]% of total) |
| Commercial GFA | [X] m2 ([X]% of total) |
| Retail GFA | [X] m2 ([X]% of total) |
| Community/Institutional GFA | [X] m2 ([X]% of total) |
| Gross FAR | [X.X] |
| Net FAR | [X.X] |
| Ground Space Index (GSI) | [X.X] |
| Open Space Ratio (OSR) | [X.X] |

### Housing
| Metric | Value |
|--------|-------|
| Total dwellings | [X] units |
| Dwelling density (net) | [X] DU/ha |
| Estimated population | [X] residents |
| Housing tenure split | [X]% market / [X]% affordable / [X]% social |
| Unit type mix | [X]% 1-bed / [X]% 2-bed / [X]% 3-bed / [X]% 4-bed+ |
| Average unit size | [X] m2 |

### Public Realm and Green Infrastructure
| Metric | Value |
|--------|-------|
| Total public open space | [X] ha / [X] m2 per person |
| Green space | [X] ha / [X] m2 per person |
| Tree canopy coverage (at maturity) | [X]% of public realm |
| Biodiversity net gain | [X]% |
| Permeable surface area | [X]% of site |
| Play space provision | [X] m2 / [X] per 100 children |

### Mobility
| Metric | Value |
|--------|-------|
| Car parking spaces | [X] ([X] per dwelling) |
| Cycle parking spaces | [X] ([X] per dwelling) |
| EV charging points | [X] ([X]% of car spaces) |
| Distance to nearest bus stop | [X] m |
| Distance to nearest rail/metro station | [X] m |
| Target sustainable mode split | [X]% walk / [X]% cycle / [X]% transit |

### Urban Form
| Metric | Value |
|--------|-------|
| Building height range | [X]-[X] stories |
| Average block perimeter | [X] m |
| Active frontage (primary streets) | [X]% |
| Active frontage (secondary streets) | [X]% |
| Intersection density | [X] per km2 |
| Street hierarchy | [X]m primary / [X]m secondary / [X]m local |

### Sustainability
| Metric | Value |
|--------|-------|
| Operational carbon target | [target] |
| Embodied carbon target | [X] kgCO2/m2 |
| Renewable energy provision | [X] kWp / [X]% of demand |
| Water demand reduction | [X]% vs. baseline |
| Stormwater attenuation | [X]-year event at greenfield rate |
| Waste diversion target | [X]% from landfill |
| Certification target | [system] [level] |

Templates for immediate use:

  • templates/design-brief-template.md - Complete fill-in template for an urban design brief
  • templates/report-template.md - Complete fill-in template for an urban design report

Related skills for content generation:

  • site-analysis skill - For generating the site analysis content needed in briefs and reports
  • design-evaluation skill - For evaluating design proposals against the brief's criteria
  • sustainability-scoring skill - For detailed sustainability assessment content
  • precedent-study skill - For selecting and analyzing precedents referenced in briefs and reports

External references:

  • RIBA Plan of Work 2020 - Stage definitions and deliverables
  • Urban Design Compendium (Homes England) - Design guidance
  • National Design Guide (UK MHCLG, 2019) - 10 Characteristics of Well-Designed Places
  • LEED-ND v4.1 Rating System - Certification requirements
  • Global Street Design Guide (NACTO / GDCI, 2016) - Street design standards

© 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 2 other files in skills/design-brief of Abhinavbwj/Urban-Design-Skills-Claude.

  • SKILL.md
  • templates/design-brief-template.md
  • templates/report-template.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

Design Brief 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.

Design Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design Brief this skillAbhinavbwj/Urban-Design-Skills-Claude1321 repos~6.4kAutomated safety check: PassMIT
Briefalirezarezvani/claude-skills28k—~967Automated safety check: PassMIT
Briefdavepoon/buildwithclaude3.6k—~1.3kAutomated safety check: NotesMIT
Review Briefevery-app/open-seo23k—~1.2kAutomated safety check: PassMIT
Traderspy Market Briefingsickn33/agentic-awesome-skills47k1 repos~2kAutomated safety check: PassMIT
Briefsuboss87/FDEOps956—~339Automated safety check: PassMIT

Similar skills

  • Brief

    alirezarezvani/claude-skills

    /cs:brief <topic — Generate a one-page strategy brief from an office-hours intake.

    28k GitHub stars~967 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Brief

    davepoon/buildwithclaude

    Session-start briefing from Origin. An agent skill from davepoon/buildwithclaude.

    3.6k GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Review Brief

    every-app/open-seo

    Produce a scannable review brief for a branch or PR so the maintainer can approve without reading the whole diff.

    23k GitHub stars~1.2k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Traderspy Market Briefing

    sickn33/agentic-awesome-skills

    Crypto market briefing from live TraderSpy data: majors, funding, open interest, top-trader lean, fresh AI signals and screener movers.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Brief

    suboss87/FDEOps

    Clarify a new customer brief, desired outcome, constraints and evidence gaps.

    956 GitHub stars~339 tokensUpdated 2 days ago
    Auto-check passed
  • Case Brief

    anthropics/claude-for-legal

    Official

    Brief a case in your preferred format. An agent skill from anthropics/claude-for-legal.

    9.6k GitHub starsUsed in 3 repos~1.6k tokens
    Auto-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
  • 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

Questions about Design Brief

What does Design Brief do?

Generate professional urban design briefs, design reports, and project documentation. Design Brief is an agent skill from Abhinavbwj/Urban-Design-Skills-Claude. Generate professional urban design briefs, design reports, and project documentation.

When should I use Design Brief?

Design Brief fits situations like: the user asks to write a design brief; create a project brief; draft a design report; prepare a presentation document.

How do I install Design Brief in Claude Code?

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

How do I install Design Brief in Codex?

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

Can I use Design Brief 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 design-brief -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-brief, .gemini/skills/design-brief, .github/skills/design-brief and .opencode/skills/design-brief in your project.

What does Design Brief need to run?

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

Does Design Brief 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 Design Brief 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 Design Brief use?

Design Brief 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 Design Brief use?

About 6.4k tokens (SKILL.md is roughly 26k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Design Brief?

Skills that share tags, products or a category with Design Brief: Brief (alirezarezvani/claude-skills, 28k stars), Brief (davepoon/buildwithclaude, 3.6k stars), Review Brief (every-app/open-seo, 23k stars) and Traderspy Market Briefing (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design Brief?

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.