Back to Skills

prepare-soil

pjt222
Updated 2 days ago
3 views
17
2
17
View on GitHub
Metatestingdesign

About

This skill helps developers create a Claude agent that can assess and improve garden soil health. It provides methods for soil testing, amendments, composting, and biodynamic preparations. Use it when building agents for gardening advice, particularly for new beds, underperforming plants, or transitioning to organic methods.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/prepare-soil

Copy and paste this command in Claude Code to install this skill

Documentation

Prepare Soil

Assess soil + build healthy living soil via amendment, composting, biological activation.

Use When

  • Starting new bed → assess existing soil
  • Plants underperform despite water + light (soil = likely cause)
  • Transition conventional → organic or biodynamic
  • Soil compacted, depleted, hydrophobic
  • Build composting system
  • Apply biodynamic preps (500-508)

In

  • Required: Soil access (bed, field, container)
  • Optional: Soil test results (pH, N-P-K, organic matter %)
  • Optional: Garden history (prev crops, amendments, years cultivated)
  • Optional: Target crops/plants
  • Optional: Approach pref (organic, biodynamic, permaculture)

Do

Step 1: Assess Soil

3 field tests, no lab — do all 3.

Test 1: Jar Test (Texture — Sand/Silt/Clay Ratio)
1. Fill a quart jar 1/3 full with soil from 15cm depth
2. Fill to top with water, add 1 tablespoon dish soap
3. Shake vigorously for 3 minutes, then set on level surface
4. Read layers after settling:
   - Sand settles in 1 minute (bottom layer)
   - Silt settles in 4-6 hours (middle layer)
   - Clay settles in 24-48 hours (top layer)
5. Measure each layer as % of total soil depth
   - Ideal garden soil: ~40% sand, ~40% silt, ~20% clay (loam)

Test 2: Spade Test (Structure and Compaction)
1. Push a spade into moist soil to full depth (25cm)
2. Lever up a block of soil and place on a board
3. Observe:
   - Crumbles easily → good structure
   - Breaks into angular blocks → compacted
   - Smears or is sticky → too much clay or waterlogged
   - Layers visible → hardpan or plough pan present
4. Smell the soil:
   - Sweet, earthy → healthy aerobic biology
   - Sour, sulphurous → anaerobic conditions (drainage problem)

Test 3: Earthworm Count (Biological Activity)
1. Dig a 30cm × 30cm × 30cm cube of soil
2. Place on a tarp or board
3. Gently break apart and count earthworms
   - 0-5: Poor biology — needs organic matter
   - 5-10: Fair — improving but not yet thriving
   - 10-20: Good — healthy biological activity
   - 20+: Excellent — this soil is alive

→ Clear picture of texture, structure, biology. Jar result, structure rating, worm count.

If err: jar layers hard to distinguish → repeat w/ cleaner water + more vigorous shake. Worm count zero + sour smell → anaerobic, drainage must be addressed before amendment.

Step 2: Diagnose + Plan Amendment

Match assessment → amendment plan.

Amendment by Soil Type:
┌────────────────┬─────────────────────────┬──────────────────────────────┐
│ Diagnosis      │ Symptoms                │ Amendment                    │
├────────────────┼─────────────────────────┼──────────────────────────────┤
│ Heavy clay     │ Sticky, slow drainage,  │ Gypsum (calcium sulfate)     │
│                │ >40% clay in jar test   │ 1 kg/m², worked into top     │
│                │                         │ 15cm. Add coarse compost.    │
│                │                         │ Plant daikon radish to break │
│                │                         │ hardpan biologically.        │
├────────────────┼─────────────────────────┼──────────────────────────────┤
│ Sandy          │ Drains instantly, won't │ Compost 5-10cm thick, worked │
│                │ hold moisture, <20%     │ into top 20cm. Add biochar   │
│                │ silt+clay in jar test   │ (pre-charged with compost    │
│                │                         │ tea) for moisture retention.  │
├────────────────┼─────────────────────────┼──────────────────────────────┤
│ Depleted       │ Pale colour, low worm   │ 10cm compost top-dress.      │
│                │ count, poor growth      │ Cover crop (legume mix) for  │
│                │ despite watering        │ nitrogen fixation. Foliar    │
│                │                         │ seaweed spray monthly.       │
├────────────────┼─────────────────────────┼──────────────────────────────┤
│ Compacted      │ Angular blocks in spade │ Broadfork (not rototiller)   │
│                │ test, surface pooling,  │ to fracture without          │
│                │ hard when dry           │ inverting. Deep mulch (15cm  │
│                │                         │ wood chips on paths). Plant  │
│                │                         │ deep-rooted comfrey.         │
├────────────────┼─────────────────────────┼──────────────────────────────┤
│ Acidic (pH<6)  │ Blueberries thrive but  │ Wood ash (light application) │
│                │ brassicas struggle      │ or dolomite lime. Test pH    │
│                │                         │ before and after — adjust    │
│                │                         │ slowly over 2 seasons.       │
├────────────────┼─────────────────────────┼──────────────────────────────┤
│ Alkaline (pH>7)│ Iron chlorosis (yellow  │ Elemental sulphur or acidic  │
│                │ leaves, green veins)    │ compost (pine needles, oak   │
│                │                         │ leaves). Very slow to shift. │
└────────────────┴─────────────────────────┴──────────────────────────────┘

→ Specific amendment plan matched to diagnosed condition.

If err: multiple conditions overlap (heavy clay AND depleted) → structure first (gypsum + broadfork), then biology (compost + cover crop). Trying to fix everything at once overwhelms soil.

Step 3: Build Compost

Method by space, materials, timeline.

Composting Methods:
┌────────────────┬──────────────┬──────────────┬─────────────────────────┐
│ Method         │ Time to      │ Space Needed │ Best For                │
│                │ Finished     │              │                         │
├────────────────┼──────────────┼──────────────┼─────────────────────────┤
│ Hot compost    │ 4-8 weeks    │ 1m³ minimum  │ Large gardens, weed     │
│                │              │              │ seed / disease kill      │
├────────────────┼──────────────┼──────────────┼─────────────────────────┤
│ Cold compost   │ 6-12 months  │ Any size     │ Low effort, small       │
│                │              │              │ quantities              │
├────────────────┼──────────────┼──────────────┼─────────────────────────┤
│ Vermicompost   │ 3-6 months   │ 0.5m² indoor │ Kitchen scraps, indoor  │
│                │              │              │ / apartment gardens     │
└────────────────┴──────────────┴──────────────┴─────────────────────────┘

Hot Compost Protocol:
1. Build pile in layers — 2 parts brown (carbon) to 1 part green (nitrogen)
   - Brown: dried leaves, straw, cardboard, wood chips
   - Green: kitchen scraps, fresh grass, manure, coffee grounds
2. Moisten each layer (damp sponge consistency)
3. Pile must be at least 1m × 1m × 1m to reach temperature
4. Internal temperature should reach 55-65°C (130-150°F) within 3-5 days
5. Turn pile when temperature drops below 45°C (every 5-7 days)
6. After 3-4 turns, cure for 2-4 weeks without turning
7. Finished compost: dark, crumbly, smells like forest floor, no recognizable inputs

Never Compost:
- Meat, dairy, oils (attract pests)
- Diseased plant material (unless hot compost reaches 60°C+ for 3 days)
- Treated wood, glossy paper
- Pet waste (pathogen risk)

→ Composting system established + first batch in progress.

If err: hot compost won't heat → check moisture (too dry/wet), C:N ratio (more green for N), pile size (<1m³ won't heat reliably).

Step 4: Apply No-Till + Cover Cropping

Protect + build structure w/o inversion.

No-Till Sheet Mulching (New Bed from Lawn or Weeds):
1. Mow or scythe existing vegetation as low as possible
2. Layer cardboard (overlapping edges) directly on ground — no gaps
3. Wet cardboard thoroughly
4. Add 5cm compost on top of cardboard
5. Add 10-15cm organic mulch (straw, wood chips, leaves)
6. Wait 3-6 months (autumn application → spring planting)
7. Plant through mulch by pulling it aside — do not till

Cover Crop Quick Reference:
┌─────────────────┬────────────────┬───────────────────────────────┐
│ Crop            │ Season         │ Benefit                       │
├─────────────────┼────────────────┼───────────────────────────────┤
│ Crimson clover  │ Autumn sow     │ Nitrogen fixation, bee forage │
│ Winter rye      │ Autumn sow     │ Biomass, weed suppression     │
│ Buckwheat       │ Summer sow     │ Fast cover, phosphorus mining │
│ Phacelia        │ Spring/autumn  │ Pollinator magnet, breaks up  │
│                 │                │ compaction                    │
│ Daikon radish   │ Autumn sow     │ Deep root breaks hardpan,     │
│                 │                │ decomposes in place over      │
│                 │                │ winter (bio-drill)            │
└─────────────────┴────────────────┴───────────────────────────────┘

Terminate cover crops by:
- Crimp and roll (best — leaves roots in place)
- Scythe and lay as mulch
- Never rototill — this destroys the soil structure you're building

→ Soil protected year-round, biology undisturbed, organic matter increasing.

If err: cover crop fails → check sowing depth (most need surface or shallow) + moisture. Resow or apply thick mulch as substitute.

Step 5: Biodynamic Preparations (Optional — Advanced)

For Demeter or biodynamic practitioners.

Biodynamic Preparations Overview:
┌──────┬───────────────┬──────────────────────┬─────────────────────────┐
│ Prep │ Material      │ Application          │ Purpose                 │
├──────┼───────────────┼──────────────────────┼─────────────────────────┤
│ 500  │ Horn manure   │ Spray on soil,       │ Stimulate soil biology,  │
│      │               │ autumn & spring      │ root growth, humus      │
├──────┼───────────────┼──────────────────────┼─────────────────────────┤
│ 501  │ Horn silica   │ Spray on foliage,    │ Light metabolism, fruit  │
│      │               │ morning, summer      │ quality, ripening       │
├──────┼───────────────┼──────────────────────┼─────────────────────────┤
│ 502  │ Yarrow        │ Added to compost     │ Sulphur and potassium   │
│ 503  │ Chamomile     │ Added to compost     │ Calcium, stabilizes N   │
│ 504  │ Stinging nettle│ Added to compost    │ Iron, stimulates soil   │
│ 505  │ Oak bark      │ Added to compost     │ Calcium, disease resist │
│ 506  │ Dandelion     │ Added to compost     │ Silica, light forces    │
│ 507  │ Valerian      │ Sprayed on compost   │ Warmth, phosphorus      │
├──────┼───────────────┼──────────────────────┼─────────────────────────┤
│ 508  │ Horsetail tea │ Spray on foliage     │ Fungal disease prevent  │
└──────┴───────────────┴──────────────────────┴─────────────────────────┘

Preparation 500 Application:
1. Stir 100g horn manure in 35 litres warm water
2. Stir dynamically for 1 hour — create vortex, reverse, create vortex
   (alternating direction every minute)
3. Apply within 1 hour of stirring
4. Spray in large droplets on soil surface — late afternoon, descending moon
5. Apply autumn (before winter) and early spring (before sowing)

Note: Biodynamic preparations are available from certified suppliers
or local biodynamic farming groups. Making your own requires the
previous season's preparations and specific animal horn sheaths.

→ Preps applied at correct time + moon phase. Biology activation visible over 1-2 seasons.

If err: preps unavailable → good compost + cover cropping achieve 80% of biological benefit. Preps enhance, not substitute for sound soil management.

Step 6: Heal Checkpoint — Post-Amendment Assessment

6 wks post-amendment, reassess.

Post-Amendment Soil Health Check:
1. Repeat the spade test:
   - Has structure improved? (Crumbles more easily)
   - Are roots penetrating deeper?
   - Any remaining hardpan layers?

2. Repeat the earthworm count:
   - Has the count increased? (Even 2-3 more is progress)
   - Are worms distributed through the depth or just at surface?

3. Drainage test:
   - Dig a 30cm hole, fill with water, let drain, refill
   - Second fill should drain within 1-4 hours
   - <1 hour: very free draining (may need more organic matter)
   - >4 hours: still compacted or clay-heavy (continue treatment)

4. Surface observation:
   - Fungal threads visible in mulch layer? (Good — decomposition active)
   - Green algae on surface? (Too wet or too compacted)
   - Mulch layer breaking down? (Biology is working)

Triage:
- All improving → Continue current approach, reassess next season
- Structure improved but worms low → Add more diverse organic matter
- Worms present but drainage poor → Broadfork again, add coarse material
- No improvement → Soil may have contamination — consider lab test for heavy metals

→ Measurable improvement in ≥2 of 3 indicators (structure, biology, drainage).

If err: no improvement after 6 wks → may be deeper than topsoil amendment. Raised beds w/ imported soil mix as parallel strategy while improving in-ground over multiple seasons.

Check

  • All 3 field tests done (jar, spade, earthworm)
  • Soil type correctly diagnosed
  • Amendment plan matches diagnosed condition
  • Compost system established (hot, cold, vermi)
  • Soil covered year-round (mulch, cover crop, living plants)
  • No rototilling or inversion
  • Heal checkpoint done 6 wks post-amendment
  • Garden journal updated w/ test results + amendment

Traps

  1. Add w/o testing: Random amendments waste money + worsen imbalances. Always test first.
  2. Rototill: Feels productive but destroys structure, kills worms, brings weed seeds to surface. Use broadfork if must loosen.
  3. Bare soil: Loses moisture, structure, biology. Always mulch or cover crop.
  4. Fresh manure on beds: Burns roots + introduces pathogens. Compost ≥6 months before soil contact.
  5. Lime w/o testing pH: Overliming makes nutrients unavailable. Adjust only based on actual test.
  6. Expect instant results: Soil building = seasons + years, not weeks.

  • cultivate-bonsai — bonsai soil mix (akadama/pumice/lava) = specialized prep
  • plan-garden-calendar — amendment timing aligns w/ seasonal calendar (autumn lime, spring compost)
  • read-garden — soil observation = part of garden reading protocol
  • heal — post-amendment assess follows heal triage pattern
  • forage-plants — soil-plant relationships aid wild plant habitat reading
  • make-fire — wood ash = traditional soil amendment (potassium + lime)

GitHub Repository

pjt222/agent-almanac
Path: i18n/caveman-ultra/skills/prepare-soil
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

content-collections

Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill

polymarket

Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill

creating-opencode-plugins

Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill

sglang

Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill