Gsd-skill-creator ecosystem-mapping

Reading a habitat — identifying biome, plant community, food web structure, successional stage, and the keystone species that hold the system together. Covers the elevational and latitudinal gradients that Humboldt first mapped, the structural vocabulary for describing a habitat, the core concepts of food-web and trophic analysis, and the practice of diagnosing habitat health from indicator species. Use when the task is to understand a place rather than a species.

install
source · Clone the upstream repo
git clone https://github.com/Tibsfox/gsd-skill-creator
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Tibsfox/gsd-skill-creator "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/nature-studies/ecosystem-mapping" ~/.claude/skills/tibsfox-gsd-skill-creator-ecosystem-mapping && rm -rf "$T"
manifest: examples/skills/nature-studies/ecosystem-mapping/SKILL.md
source content

Ecosystem Mapping

A species exists in a context. The same bird in a salt marsh, a pine barren, and a high-elevation meadow is playing a different role in each ecosystem, foraging on different prey, interacting with different neighbors, and responding to different pressures. Ecosystem mapping is the discipline of reading a habitat as a structured whole — identifying which biome it belongs to, what plant community anchors it, what food web connects the species within it, what successional stage it is in, and which species are keystones whose loss would reorganize the entire system. This skill gives the naturalist a framework for going from "what is this?" to "what is this place?"

Agent affinity: von-humboldt-nat (biogeography, elevational gradients, regional assemblages), linnaeus (species list construction for a habitat)

Concept IDs: nature-ecology-habitats, nature-plants-fungi, nature-animals-birds

The Biogeographic Frame

Before reading a habitat, place it on the global map. Biomes are the largest ecological units, defined by climate and the dominant vegetation structure rather than by any particular species.

The Major Biomes

BiomeClimate signatureDominant vegetationExample region
Tropical rainforestWarm, wet year-roundMulti-layered broadleaf canopyAmazon, Congo, Indo-Malay
Tropical savannaWarm, seasonal rainfallGrasses with scattered treesEast Africa, Cerrado
DesertLow precipitationSparse drought-adapted plantsSahara, Sonoran, Gobi
Mediterranean shrublandWet winter, dry summerSclerophyll shrubs and oaksCalifornia, Mediterranean basin, Cape
Temperate grasslandHot summer, cold winter, limited rainfallPerennial grassesGreat Plains, Eurasian steppe
Temperate deciduous forestFour seasons, adequate rainfallBroadleaf trees, winter leaf dropEastern US, western Europe, East Asia
Temperate rainforestMild, very wetConifers, ferns, mossesPacific Northwest, southern Chile, New Zealand
Boreal forest (taiga)Cold, short summerSpruce, fir, larchCanadian shield, Siberia, Fennoscandia
TundraCold year-round, short growing seasonLichens, sedges, dwarf shrubsArctic, alpine

Why Biome Matters

Biome sets the expectation. A warbler in boreal forest is not interchangeable with a warbler in temperate deciduous forest, even if the ID is the same. The climate, the prey base, the competitors, and the seasonal pressures differ. Biogeography is the first filter before any habitat reading.

Humboldt's Elevational Gradient

Alexander von Humboldt's 1802 ascent of Chimborazo in Ecuador produced the foundational insight that elevation recapitulates latitude. As you climb a tropical mountain, you pass through plant communities that resemble those of progressively higher latitudes: tropical lowland forest, montane forest, cloud forest, paramo grassland, alpine tundra, and finally bare rock. A single mountain can contain the climate range from Panama to Alaska.

Why This Matters

  • Species sort by elevation. On any mountain in the Americas, you can predict which species of warblers, hummingbirds, or oaks you will find at a given altitude.
  • Climate shifts move the bands. A warming climate moves elevation bands upward. Species that cannot climb fast enough — or cannot climb because the mountain has no more elevation — are squeezed out.
  • Mountain biogeography is a natural experiment. Each mountain is an "island" for high-elevation species, with its own isolated population and its own evolutionary trajectory.

Humboldt's gradient is the single most useful concept for reading a place in a region with any topographic relief.

Reading a Plant Community

Plants anchor an ecosystem. They produce the energy that supports every animal, they structure the physical habitat, and they are easier to observe and name than most other groups. A naturalist who can name the dominant plants of a habitat can predict much of its animal community.

Vocabulary of Plant Communities

  • Dominants: the plant species with the most biomass. Usually the largest and most abundant trees or shrubs.
  • Canopy: the top layer of vegetation in a forest.
  • Midstory: the smaller trees and tall shrubs below the canopy.
  • Understory: the herbaceous and shrub layer at ground level.
  • Ground cover: mosses, low herbs, and seedlings.
  • Indicator species: plants whose presence signals specific environmental conditions (soil pH, moisture, disturbance history).

Community Types in a Region

In any region, practitioners develop a vocabulary of community types. In the temperate deciduous forest of eastern North America, the standard types include: oak-hickory forest, maple-beech forest, northern hardwood forest, floodplain forest, cove hardwood forest, pine-oak barrens, and bottomland swamp. Each has a predictable dominant set, a predictable understory, and a predictable bird and mammal community.

Learning the community types for your region is the single most efficient way to go from "I know the species" to "I know the ecosystem."

Food Webs and Trophic Structure

A food web is the graph of who eats whom in an ecosystem. It is the mechanism by which energy and nutrients move from primary producers (plants) through herbivores, carnivores, and decomposers.

Trophic Levels

LevelRoleExamples
Primary producersConvert sunlight (or chemical energy) to biomassPlants, algae, cyanobacteria
Primary consumersEat producersHerbivores, seed-eaters, nectar-feeders
Secondary consumersEat primary consumersInsectivores, small predators
Tertiary consumersEat secondary consumersHawks, wolves, ocean apex predators
DecomposersBreak down dead biomass, return nutrientsFungi, bacteria, scavenging insects

Only about 10 percent of energy at one trophic level is available to the next. This "10 percent rule" explains why top predators are rare: the energy pyramid narrows sharply with each level.

Links and Interactions

A full food web does not resolve into neat levels. Many species eat at multiple levels (omnivores), many species depend on specific plants or hosts (specialists), and many links are indirect (keystone effects, trophic cascades). Reading a food web usually means tracing the most important links rather than mapping all of them.

Keystone Species

Some species contribute disproportionately to the structure of their ecosystem. Their removal reorganizes the community even if they are not particularly abundant.

Classic Examples

  • Sea otters in Pacific kelp forests. Without otters, urchins proliferate, kelp is grazed to nothing, and the three-dimensional kelp habitat disappears along with all the species that depend on it.
  • Beavers in riparian zones. Dams raise water tables, create wetlands, and support amphibian, fish, waterfowl, and insect communities that do not exist in unmodified streams.
  • Pisaster ochraceus (ochre sea star) in Pacific rocky intertidal zones — the original keystone example, from Robert Paine's 1966 experiments. Removing the starfish allowed mussels to dominate and reduced intertidal diversity from 15 species to 8.
  • Fig trees in tropical forests. Figs fruit year-round, sustaining frugivores through lean seasons; without figs, fruit-eating communities collapse.

Why the Concept Matters

Keystone analysis identifies where an intervention or a loss will have outsized consequences. Conservation effort directed at keystones yields much larger ecosystem returns than effort directed at species with equivalent biomass but less structural importance.

Succession

Ecosystems change over time. A clear-cut forest, an abandoned field, a flooded wetland — each follows a characteristic sequence of communities as it recovers. Understanding succession is understanding where a habitat is in its trajectory.

Stages

  1. Pioneer stage: fast-growing, disturbance-tolerant species colonize bare ground or disturbed areas. Annuals, grasses, and early-successional shrubs.
  2. Intermediate stage: slower-growing species displace pioneers. Perennial herbs, mid-successional shrubs, and fast-growing trees.
  3. Mature stage: long-lived dominants establish the community's mature form. Large trees in a forest, tall perennials in a grassland.
  4. Late-successional or old-growth stage: the community reaches maximum structural complexity, with multiple age cohorts and high species diversity.

Succession Is Not Linear

Classical ecology imagined succession as a fixed progression toward a single "climax" community. Modern ecology treats succession as contingent: different starting conditions, different disturbance regimes, and different climate trajectories produce different outcomes. A fire-suppressed oak forest becomes a shade-tolerant maple forest; a fire-restored oak forest stays oak. The stage at any moment depends on the full history of disturbance.

Diagnosing Habitat Health

Indicator species let a naturalist assess habitat condition quickly. Certain species appear only when specific conditions are met; their presence or absence is evidence about the habitat.

Common Indicators

  • Lichens indicate air quality. Many species are highly sensitive to sulfur dioxide and disappear near polluted areas.
  • Amphibians indicate water quality and terrestrial moisture. Many species have permeable skin and cannot tolerate contaminants.
  • Mycorrhizal fungi indicate soil health and long-term ecosystem stability.
  • Old-growth specialists (certain warblers, flying squirrels, cavity nesters) indicate stand age and structural complexity.
  • Invasive species indicate disturbance. Heavy invasion signals past disturbance that the native community has not recovered from.

When to Use This Skill

  • The user wants to understand a specific place rather than a specific species.
  • The user is planning a trip and wants to know what to expect from the habitat.
  • The user wants to interpret a species list in ecological context.
  • The user is evaluating habitat condition or change over time.
  • The user wants to understand how climate change is reshaping a biome or community.

When NOT to Use This Skill

  • The user wants to identify a single organism (promote to
    field-identification
    ).
  • The user wants taxonomic detail (promote to
    taxonomic-classification
    ).
  • The user wants behavioral interpretation of a named species (promote to
    species-interaction-tracking
    ).
  • The user wants to record field observations in a notebook (promote to
    nature-journaling
    ).

Decision Guidance

  • Start broad, narrow fast. Biome → community type → dominant species → indicator and keystone species. Each narrowing step reduces the candidate list for everything else.
  • Use plants as the anchor. Animals are mobile and transient. Plants reflect the stable conditions of the site.
  • Respect succession. A young forest and an old forest are different ecosystems even if they share the same species list.
  • Look for indicators, not totals. A habitat's health is visible in a handful of species, not in a long checklist.

Cross-References

  • von-humboldt-nat agent: Biogeographic reasoning, elevational gradients, species assemblages.
  • linnaeus agent: Species-list construction and taxonomic placement.
  • peterson agent: Identifying the indicator species whose presence or absence diagnoses the habitat.
  • field-identification skill: Identifying the organisms that populate the habitat.
  • species-interaction-tracking skill: Behavioral data feeding food-web reconstruction.

References

  • von Humboldt, A., & Bonpland, A. (1805). Essai sur la géographie des plantes. Fr. Schoell.
  • Paine, R. T. (1966). "Food web complexity and species diversity." The American Naturalist, 100(910), 65–75.
  • Clements, F. E. (1916). Plant Succession. Carnegie Institution.
  • Whittaker, R. H. (1970). Communities and Ecosystems. Macmillan.
  • MacArthur, R. H., & Wilson, E. O. (1967). The Theory of Island Biogeography. Princeton University Press.
  • Power, M. E. et al. (1996). "Challenges in the quest for keystones." BioScience, 46(8), 609–620.
  • Odum, E. P., & Barrett, G. W. (2005). Fundamentals of Ecology, 5th ed. Thomson Brooks/Cole.