Install
$ agentstack add skill-human-avatar-skills-for-agriculture-s4ag-land-reading ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Land Reading
Before any input or enterprise decision, you need to understand the land itself. Land reading is structured observation: you are translating the physical, ecological, and historical record of a site into a map of what it can do and what it needs. Every landform, plant community, drainage pattern, and soil profile is a data point. This skill gives you the method to read them systematically rather than guessing.
How this skill works: Each sub-tool pauses at a Checkpoint to confirm the assumptions it is about to build on before producing output. A recommendation built on a wrong assumption wastes time and money — confirm the checkpoint before acting. Each sub-tool ends with Next steps — the skills worth running once you have acted on this one.
Expert Lineage
The thinkers whose frameworks underpin this skill — and what they specifically discovered that changes how you farm.
P.A. Yeomans — Keyline Design and Landscape Water Reading Yeomans developed the keyline as the critical topographic line on any landscape — the inflection point between diverging and concentrating water flow. His specific contribution: on every slope, there is a line above which water spreads out and below which it converges. Farming above this line with keyline-pattern cultivation moves water from the valley (where it concentrates) toward the ridge (where it's scarce), equalising soil moisture across the whole property. Before any earthworks or irrigation investment, reading the keyline tells you where water naturally wants to go — and how to work with that rather than against it.
Charles Massy — Five Landscape Functions Massy's framework names the five functions that determine whether a landscape is gaining or losing ecological health: the solar energy cycle, the water cycle, the mineral/nutrient cycle, the soil biological community, and biodiversity. His insight from Call of the Reed Warbler is diagnostic: any landscape can be assessed across these five dimensions in a single walk-over. A farm that appears productive on conventional metrics may be failing two or three of these functions and moving toward degradation. The five functions give you a language for what you are seeing before you have any lab data.
Masanobu Fukuoka — Observation Before Action Fukuoka's practice, documented in One-Straw Revolution, established a principle that changed how many farmers approach land: observe for a full year before changing anything. His specific finding was that most management decisions — including his own early ones — imposed assumptions on the land that the land then had to overcome. The farmer who watches first — how water moves after heavy rain, where frost settles, which plants emerge without help — spends less and achieves more than the farmer who acts on first impressions. This skill embeds that principle in the observation methodology.
Jerome Osentowski — Microclimate Reading for Site Design Osentowski's work at the Central Rocky Mountain Permaculture Institute demonstrated that microclimate variation within a single property can span the equivalent of two to three climate zones. His specific contribution: aspect, slope angle, wind exposure, and thermal mass (rock, water, soil type) interact to create pockets of radically different growing conditions within walking distance of each other. A site reading that ignores microclimate misses the most important design variable for enterprise placement and species selection.
Elaine Ingham — Vegetation as Food Web Indicator Ingham's soil food web framework makes vegetation reading diagnostic rather than merely descriptive. Annual weeds — dock, thistle, pigweed, annual grasses — dominate bacteria-dominated, disturbed soils. Perennial forbs, clovers, and diverse grasslands indicate recovering fungal communities. Deep-rooted perennials with intact mycorrhizal networks change the plant community that establishes. Reading the plant community tells you the food web status before any lab test — and that status determines which enterprise choices are realistic without major biological rehabilitation.
David Holmgren — Pattern Language in Landscape Holmgren's contribution through permaculture design is the use of pattern recognition as an analytical tool: branching, spiraling, edge, and mosaic patterns in landscape reveal how energy and material cycle through that system. His specific insight: edges between two ecosystems (forest/grassland, wet/dry, slope/flat) are where biological diversity and productivity are highest — they should be read as assets, not as management problems. Every fence line, watercourse, or slope break is a potential edge zone worth designing toward rather than managing away.
Which tool fits
| You need to... | Tool | |---|---| | Understand the shape of the land and what it means for water and enterprise | landform-reading | | Identify what the plant community is telling you about soil and history | vegetation-indicators | | Do a hands-on soil assessment without lab tests | soil-profile | | Map where water flows, ponds, infiltrates, and drains | water-patterns | | Understand what has happened on this land before you | history-reading | | Translate all observations into an enterprise potential map | potential-mapping |
Routing Decision
- Just acquired or assessing unfamiliar land → start with landform-reading, then follow the natural sequence through to potential-mapping
- Familiar land but something has changed or is not working → vegetation-indicators first to check food web signals, then soil-profile
- Planning earthworks or water infrastructure → water-patterns before any design work
- Making an enterprise decision — what to grow or raise here → potential-mapping, drawing on prior sub-tools for data
- Buying or leasing a property and need a structured assessment → history-reading first to surface legacy issues, then full sequence
- Unsure where to start → landform-reading; the shape of the land determines everything else
Landform Reading
Translates the contour, slope, aspect, and drainage patterns of the land into farm design constraints and opportunities.
The shape of the land controls water, temperature, and productive potential more than any other single variable. Reading landform correctly takes thirty minutes and changes every subsequent decision. Do this before putting a spade in the ground.
Work through the landform in this order:
1. Identify the slope categories.
| Slope | Description | Farming implication | |---|---|---| | 0–2% | Flat | Water ponds, drainage critical; machinery efficient; frost risk in hollows | | 2–8% | Gentle | Good all-purpose; keyline cultivation practical; erosion manageable | | 8–15% | Moderate | Contour management essential; cultivation requires care; perennial or pasture preferred | | 15–25% | Steep | Cultivation inadvisable; perennial systems only; high erosion risk | | 25%+ | Very steep | Forestry or revegetation; no cultivation; erosion permanent if disturbed |
2. Identify aspect — which direction does the slope face?
In the northern hemisphere:
- North-facing slopes: cooler, shadier, hold moisture longer; suited to shade-tolerant species; frost risk higher
- South-facing slopes: warmer, drier, earlier season; suited to warmth-demanding crops; drought risk higher
- East-facing: morning sun, afternoon shade; moderate microclimate; suits most enterprises
- West-facing: afternoon sun, can be hot and dry in summer; wind exposure often higher
In the southern hemisphere, reverse north/south.
3. Find the keyline (Yeomans).
Walk the slope from ridge to valley. Find the inflection point — where the slope changes from convex (steepening) to concave (flattening toward the valley floor). This is the keyline. Above it, water spreads; below it, water converges. The keyline is where you site swales for maximum lateral water distribution. It is also where keyline ripping achieves the most soil aeration.
Mark the keyline mentally or physically — it is the single most important line on the property for water management design.
4. Read the ridge-to-valley sequence.
- Ridge and upper slopes: drying, erosion-prone, exposed; wind shelter and windbreaks have high value here
- Mid-slopes around the keyline: highest agricultural potential; water balanced; deep soils typical
- Lower slopes and valley floor: water accumulates; cold air drains here (frost pockets); richest soils but highest waterlogging risk
5. Identify frost hollows.
Cold air is denser than warm air and flows downhill, pooling in hollows and low-lying areas. In areas with frost risk, note every hollow, flat bottom, and area surrounded by higher ground — these are frost pockets and should not receive frost-sensitive enterprises. This is a standard observation error: planting fruit trees in the warmest-seeming spot (south-facing) while missing that it is also a frost trap.
6. Read existing drainage channels.
Follow any natural drainage lines. Note whether they are:
- Cutting down (incising): indicates erosion; water moving too fast; loss of topsoil
- Shallow and spreading: water moving slowly, infiltrating well; good soil structure
- Dry except in heavy rain: limited catchment or high infiltration
- Permanently damp: high water table; drainage issue or spring presence
Checkpoint — confirm before finalising:
- What hemisphere and climate zone is this land in? Aspect interpretation reverses between hemispheres; frost risk varies by climate.
- Is this an assessment for purchase/lease decision, or for active design on land already farmed? The depth of analysis differs.
- Are there any known drainage problems, seasonal flooding, or problem areas the farmer has already identified?
A landform reading that misses the hemisphere, or that recommends enterprise placements without confirming existing known problems, produces a plan that conflicts with reality on the ground.
Output:
LANDFORM READING — [Property/Paddock Name]
SLOPE PROFILE
Dominant slope category: [0–2% / 2–8% / 8–15% / 15–25% / 25%+]
Secondary slope areas: [description]
ASPECT
Primary aspect: [N/S/E/W facing]
Implication: [warmer/cooler/drier/wetter — suited to what]
KEYLINE
Keyline location: [description or rough distance from valley floor]
Water movement above keyline: [spreads or concentrates?]
Water management opportunity: [swales / keyline ripping / other]
RIDGE-TO-VALLEY ZONES
Ridge/upper slopes: [note condition and risk]
Mid-slope (keyline zone): [note productive potential]
Lower slopes/valley floor: [note waterlogging or frost risk]
FROST RISK AREAS
[List any identified hollow or low-lying frost pockets]
DRAINAGE CHANNELS
[Channel 1]: [condition — incising/stable/damp]
[Channel 2]: [condition]
DESIGN IMPLICATIONS
- [most important landform-driven constraint]
- [most important landform-driven opportunity]
Next steps:
- Run water-patterns (within this skill) to follow the drainage detail the landform reading points to.
/s4ag-earthworks— if the keyline analysis identifies water management opportunity, design earthworks around the keyline.- Run potential-mapping (within this skill) once landform and water are understood.
Vegetation Indicators
Reads the plant community as a biological record of soil condition, disturbance history, and food web status.
The plants growing on a piece of land did not arrive randomly. Each species prefers specific conditions — soil pH, compaction level, moisture regime, nutrient excess or deficiency, and biological activity. A careful vegetation reading tells you the food web status, drainage condition, and disturbance history of each paddock without any lab analysis.
Reading the indicator plant communities:
Disturbance and biology indicators:
| Plant observed | What it indicates | |---|---| | Annual thistles (Cirsium, Sonchus) | Disturbed, bacteria-dominated soil; low fungal activity; often follows tillage or compaction | | Dock (Rumex) | Compaction and poor drainage; phosphorus-rich but poorly available; disturbed food web | | Nettles | High nitrogen and phosphorus; often indicates animal manure concentration or past human activity | | Annual grasses (ryegrass, barley grass) | Bacterial-dominated, low-OM soil; responds well to added fertility but needs biology rebuilt | | Pigweed / fat hen (Chenopodium) | Fertile, disturbed soil; bacteria-dominated; indicates tillage history | | Creeping buttercup | Waterlogged, compacted, poorly drained soil; food web likely anaerobic in wet periods | | Rush (Juncus) | Waterlogging; high water table; drainage required | | Bracken | Acid soil, often low phosphorus; can indicate previous woodland or heath |
Recovery and biology indicators:
| Plant observed | What it indicates | |---|---| | Clover (Trifolium) | Nitrogen-fixing bacterial communities active; soil pH adequate; food web recovering | | Yarrow | Deep-rooted; indicates drier, better-drained ground; attracts beneficials | | Plantain (Plantago) | Compaction tolerant but also common in recovering pastures; deep tap root | | Chicory | Deep tap root breaking compaction; indicates low calcium common | | Dandelion | Calcium-drawing deep root; fungal-associated; indicates soil recovery underway | | Diverse pasture (multiple grass and forb species) | Biologically diverse, recovering food web; high-value pasture | | Legume presence in pasture | Active bacterial N-fixation; soil pH above 6.0; good foundation |
Weed pressure as food web signal: Annual weeds dominate bacteria-dominated soils. Perennial diverse plant communities indicate fungal recovery. The transition from annual weed pressure to perennial forb and grass diversity is a visible proxy for the transition from bacterial to fungal soil biology — which is the direction of travel toward greater resilience and productivity in most farm contexts.
Tree and shrub presence:
- Native trees and shrubs in hedgerows: deep mycorrhizal network; landscape continuity
- Scrub invasion (blackthorn, hawthorn, bramble) on open ground: indicates grazing pressure reduction or abandonment; food web likely intact beneath
- Dead trees or die-back: check drainage and root zone condition; waterlogging or compaction often causal
Mapping the plant communities:
Walk each paddock systematically. Note:
- The dominant species (>30% cover)
- The subdominant species (10–30% cover)
- Any indicator species present regardless of abundance
Mark the observations onto a simple paddock map. Compare paddock to paddock — differences in plant community between paddocks farmed similarly indicate differences in soil condition, drainage, or history.
Checkpoint — confirm before finalising:
- What region and climate is the property in? Plant communities and indicator species differ by geography.
- What has this land been used for in recent years — grazed, cropped, fallow, managed, neglected? This context changes the interpretation of what you see.
- Is this a spring, summer, or autumn observation? Seasonal plant communities shift; annual weeds most visible in summer, some indicators only present in spring.
Identifying indicator plants without regional and seasonal context leads to misinterpretation — a rush-dominated paddock on a property with a known spring means waterlogging; on a property with a known history of irrigation ponding it means infrastructure damage.
Output:
VEGETATION INDICATOR REPORT — [Paddock/Area Name]
DOMINANT PLANT COMMUNITY
Dominant species: [species, % cover]
Subdominant: [species, % cover]
INDICATOR SPECIES PRESENT
[Species]: [what it indicates]
[Species]: [what it indicates]
FOOD WEB STATUS READING
Biology level: [bacteria-dominated / transitional / fungal-recovering / diverse]
Evidence: [list indicator species that support this reading]
DRAINAGE SIGNAL
[Waterlogged indicators present? / Well-drained indicato
…
## Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- **Author:** [human-avatar](https://github.com/human-avatar)
- **Source:** [human-avatar/skills-for-agriculture](https://github.com/human-avatar/skills-for-agriculture)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/@human-avatar/skills-for-agriculture
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.