jwynia/agent-skillsMIT1 file

Settlement Design

Design cities, towns, and settlements for fictional worlds. Use when creating urban environments, mapping city districts, or when settlements need realistic layered development and spatial logic.

Specification
Skill ID
jwynia/agent-skills/settlement-design
Publisher
jwynia
Repository
agent-skills
Installs
0
Files
1
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

jwynia/agent-skills/settlement-designInstalls these files
  • SKILL.md

What this skill tells the agent

Settlement Design: Urban Development Skill

You help writers create realistic settlements by applying the ten core principles that govern how real cities and towns form, grow, and evolve. This produces urban environments that feel lived-in rather than designed-for-plot.

Core Principles

  1. Geographic Determinism: Natural features profoundly shape settlement patterns and growth
  2. Functional Necessity: Settlements develop to fulfill specific economic, defensive, or social needs
  3. Network Emergence: Settlements exist within interconnected systems, not isolation
  4. Layered Development: Urban spaces evolve through accretion rather than comprehensive planning
  5. Power Projection: Settlement design reflects and reinforces social and political hierarchies
  6. Resource Constraint: Available materials and technologies limit construction possibilities
  7. Cultural Expression: Built environments embody cultural values and social organization
  8. Adaptive Reuse: Structures and spaces are repurposed as needs change over time
  9. Disaster Response: Settlements evolve in reaction to catastrophes
  10. Spatial Stratification: Social hierarchies manifest in physical organization of space

The Ten Parameter Categories

1. Site Selection Parameters

ParameterOptions to Consider
Water AccessRivers, lakes, coastlines, springs, wells
Defensive PositionElevation, natural barriers, visibility
Resource ProximityMines, timber, fertile soil, wildlife
Trade Route PlacementCrossroads, harbors, mountain passes
Climate SuitabilityTemperature, rainfall, seasonal patterns
Spiritual SignificanceSacred sites, astronomical alignments

2. Morphological Parameters

ParameterOptions to Consider
Street PatternGrid, radial, organic, hierarchical
Density GradientConcentrated to dispersed population
Boundary DefinitionWalls, natural features, markers
Building TypologyPredominant architectural forms
Open Space DistributionPlazas, parks, markets, fields
Vertical DevelopmentHeight variation and skyline

3. Functional Parameters

ParameterOptions to Consider
Economic BaseAgricultural, industrial, commercial, administrative
Defense SystemsFortifications, surveillance, escape routes
Civic OrganizationGovernance spaces and structures
Social InfrastructureMeeting places, recreational areas
Religious FacilitiesTemples, shrines, ceremonial spaces
Knowledge CentersSchools, libraries, universities

4. Infrastructure Parameters

ParameterOptions to Consider
Water ManagementSupply, drainage, waste disposal
Transportation NetworkRoads, bridges, canals, ports
Food Storage/DistributionGranaries, markets, warehouses
Energy SystemsFuel sources, power distribution
Waste ManagementDisposal, recycling, sanitation
Communication InfrastructureMessage systems, signals

5. Socio-Spatial Parameters

ParameterOptions to Consider
Elite SpacesHigh-status residential and ceremonial areas
Common QuartersEveryday residential areas
Marginalized ZonesLow-status or excluded populations
Transitional SpacesAreas between different social domains
Contested TerritoriesDisputed or ambiguous ownership
Ethnoreligious DistrictsCultural/religious group clustering

6. Symbolic Parameters

ParameterOptions to Consider
Monumental ExpressionPower and identity representations
Ritual PathwaysProcession routes and ceremonial ways
Collective Memory SitesHistorical event markers
Identity BoundariesCultural and social group divisions
Cosmic AlignmentAstronomical and religious orientations
Status SignificationSocial rank indication through space

Settlement Typologies

By Primary Function

TypeCharacteristics
Market SettlementTrade-focused community
Administrative CenterGovernance-oriented city
Religious ComplexFaith-centered settlement
Military OutpostDefense-focused installation
Production CenterManufacturing/resource extraction
Agricultural CommunityFarming-based settlement
Transport HubMovement-facilitating location
Knowledge CenterEducation/research community

By Morphological Pattern

TypeCharacteristics
Planned GridRegular, organized street network
Concentric SettlementRings around central point
Linear DevelopmentElongated along path/feature
Organic ClusterIrregular, emergent organization
Radial PatternStreets extending from central hub
Composite StructureMultiple morphological sections
Dispersed SettlementScattered buildings without center
Nucleated VillageTightly clustered around focal point

By Geographic Setting

TypeCharacteristics
River SettlementWaterway-oriented community
Coastal PortSea-facing trade center
Hill TownElevated defensive position
Valley CommunityNestled between heights
Plains SettlementFlat terrain development
Mountain OutpostHigh-altitude location
Island DevelopmentWater-surrounded community
Desert OasisArid region water-centered

By Scale and Complexity

TypePopulation Range
Isolated HomesteadSingle family/small group
HamletSmall cluster, no specialization
VillageBasic community, simple division of labor
TownMedium settlement, some specialization
CityLarge settlement, complex organization
MetropolisMajor urban center, regional dominance
MegalopolisInterconnected urban region
Imperial CapitalPolitical/cultural center of empire

Development Patterns

Settlement Evolution Sequences

  • Camp → Hamlet → Village → Town → City → Metropolis
  • Military Outpost → Frontier Settlement → Regional Center → Capital
  • Religious Shrine → Pilgrimage Site → Temple Complex → Holy City
  • Trading Post → Market Town → Commercial Center → Trade Metropolis
  • Mining Camp → Industrial Town → Manufacturing City
  • Fishing Settlement → Port Town → Maritime Hub → Naval Center

Spatial Growth Patterns

PatternDescription
Concentric ExpansionGrowth in rings around original settlement
Axial DevelopmentExpansion along transportation corridors
Leap-frog GrowthDiscontinuous development with gaps
Infill DensificationFilling empty spaces within existing areas
Satellite FormationSecondary settlements around primary center
Linear ExtensionGrowth along single axis
Cellular AccretionAddition of whole neighborhoods/districts
Polycentric EvolutionMultiple growing centers merging

Crisis and Adaptation Cycles

CrisisResponse Pattern
Fire DestructionRebuilding with fire prevention
Flood DamageElevated construction, flood control
Disease OutbreakSanitation improvement
Siege/InvasionEnhanced fortification
Resource DepletionEconomic diversification
OvercrowdingPeripheral expansion, vertical growth
Political CollapseFragmentation, repurposing

Setting-Specific Adaptations

Use this skill in a project

Open any RiverX project, search the Skills panel for jwynia/agent-skills/settlement-design, and install it in one click.

Use this skill