# S4ag Aquaculture

> Set up, stock, or manage a fish pond, tank, crayfish system, or aquaponics unit. Use when the user says anything like 'fish pond', 'trout tank', 'aquaponics', 'crayfish', 'water quality fish', 'fish production', or 'integrate fish with plants'.

- **Type:** Skill
- **Install:** `agentstack add skill-human-avatar-skills-for-agriculture-s4ag-aquaculture`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [human-avatar](https://agentstack.voostack.com/s/human-avatar)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [human-avatar](https://github.com/human-avatar)
- **Source:** https://github.com/human-avatar/skills-for-agriculture/tree/main/skills/s4ag-aquaculture
- **Website:** https://www.npmjs.com/package/@human-avatar/skills-for-agriculture

## Install

```sh
agentstack add skill-human-avatar-skills-for-agriculture-s4ag-aquaculture
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Aquaculture

Small-scale aquaculture is a high-value protein and fertility system that most farms can support. A well-managed pond, tank, or aquaponics unit produces food, generates biological fertility for the rest of the farm, and integrates naturally into any water-harvesting design. Your first decision is not which fish to grow — it is what kind of system fits your land, climate, water supply, and management capacity. Get the system match right and the fish largely look after themselves. Get it wrong and you will be managing a slow-motion emergency.

**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.*

**Murray Hallam — Practical Aquaponics**
Hallam documented that the key failure mode in small-scale aquaponics is not fish disease or plant deficiency — it is mismatched fish-to-plant ratios leading to ammonia spikes that crash the bacterial nitrification cycle. His most actionable finding: start with fewer fish than you think you need, and add incrementally as the system matures. A system cycled for 4–6 weeks before fish are added survives; one that isn't rarely does.

**Nick Savidov — Nutrient Dynamics in Aquaponics**
Savidov's Alberta Agriculture research demonstrated that plants grown in aquaponic systems develop larger, more complex root systems than hydroponically grown equivalents, and that the microbial community on those roots — not just dissolved nutrients — is responsible for the productivity difference. His finding: aquaponics is not hydroponics with fish; it is a biological ecosystem where the bacteria are as important as the fish.

**Will Allen — Systems Integration**
Allen's Growing Power operation in Milwaukee demonstrated that aquaponics integrated with compost systems and soil-based growing outperforms either approach alone. His contribution: the effluent from fish tanks is not waste to be managed — it is a biological inoculant loaded with bacteria, bioavailable nutrients, and organic carbon. Pump it to soil beds and it functions as a live fertility input that soil farmers pay large sums to approximate.

**James Rakocy — Recirculating Aquaponics Research**
Rakocy at the University of the Virgin Islands developed the UVI aquaponics system and the design ratios that practitioners still use: stocking density, feed rate, plant bed sizing, solids management. His key finding: solids removal is the most underestimated maintenance task — uneaten feed and fish waste accumulate on the bottom of tanks and, if not removed, generate hydrogen sulphide and crash the system. Build the solids management into the design from day one.

**Elaine Ingham — Water Biology**
Ingham's soil food web framework extends into aquatic systems. The nitrification cycle in aquaponics — ammonia converted to nitrite by Nitrosomonas, nitrite to nitrate by Nitrobacter — is a food web within the water, not just chemistry. Her insight: healthy diverse bacterial populations in the water and on every surface in the system (media, tank walls, pipes) buffer against ammonia spikes better than any chemical intervention. Biological stability is achieved through diversity and biomass, not through chemistry.

**Peter Moodie — Pond-Based Polyculture**
Moodie's work on integrated pond systems in temperate climates demonstrated that combining species at multiple trophic levels — surface feeders, mid-water feeders, bottom-feeders, algae consumers — significantly increases total biomass production per hectare compared to monoculture ponds. His finding: in pond polyculture, each species' waste becomes another species' food, mimicking a natural lake ecosystem and reducing the need for external feed inputs.

---

## Which tool fits

| You need to... | Tool |
|---|---|
| Choose between pond, tank, or aquaponics | system-selection |
| Diagnose or prevent water quality problems | water-quality |
| Plan feeding, reduce feed costs, or grow your own feed | feeding-and-nutrition |
| Design or troubleshoot an aquaponics system | aquaponics |
| Connect aquaculture to the rest of the farm | integrated-systems |

## Routing Decision

- **Starting from scratch and unsure which system fits** → system-selection
- **Have an existing system with fish health or algae problems** → water-quality
- **Feed costs are too high or fish growth is slow** → feeding-and-nutrition
- **Want to grow fish and plants together** → aquaponics
- **Want to use fish effluent for crops or link water systems** → integrated-systems
- **Unclear** → system-selection first; it identifies which other sub-tools apply

---

## System Selection

*Matches the aquaculture system type to the farm's land, water, climate, and management capacity.*

Before choosing a species, choose the right system. Species can be swapped out. Infrastructure is expensive to rebuild.

**The four system types:**

| System | Capital cost | Management intensity | Production type | Best for |
|---|---|---|---|---|
| Earth pond | Low–medium | Low | Fish only | Farms with suitable topography and water supply |
| Lined tank (outdoor) | Medium | Medium | Fish only | Limited land, urban/peri-urban, no suitable pond site |
| Recirculating aquaculture (RAS) | High | High | Fish, premium species | Small footprint, high-value species, year-round production |
| Aquaponics | Medium–high | High | Fish + plants | Integrating food production; maximising fertility use |

**Decision sequence — work through these in order:**

**1. Water supply.** How much water do you have access to, and how reliably?
- Earth pond requires significant initial fill volume; top-up from rainfall, spring, or stream.
- Tanks and RAS require ongoing water input but less than ponds per kg fish produced.
- Aquaponics is the most water-efficient — evaporation losses only after initial fill.

**2. Land and topography.** Is there a natural depression, clay-heavy area, or spring-fed hollow?
- Earth ponds are cheapest where topography helps — a hollow requiring minimal excavation.
- Flat or sloping land without natural hollows makes pond construction expensive.
- Tanks and aquaponics can go anywhere with a level surface.

**3. Climate.** What are the winter temperatures?
- Trout and perch tolerate near-freezing water; carp survive freeze-over in dormancy.
- Tilapia die below 15°C — not suitable for outdoor unheated systems in cold climates.
- RAS and indoor aquaponics can maintain temperature year-round but at energy cost.

**4. Management time.** Be honest.
- Earth ponds with the right species can require as little as 2–3 hours per week.
- Aquaponics and RAS require daily monitoring — ammonia and dissolved oxygen crises develop in hours, not days.
- If management time is constrained, a low-intensity pond system almost always outperforms a poorly managed intensive system.

**5. Production goal.** What are you trying to produce?
- Protein for the farm household → earth pond, low-intensity, carp or perch.
- Premium market fish (trout, barramundi) → RAS or cool-water pond.
- Fish + vegetables for market → aquaponics.
- Fertility for the farm → any system with effluent management (see integrated-systems).

**Species matching by system:**

| Species | System | Climate | Notes |
|---|---|---|---|
| Common carp | Earth pond | Cool–warm temperate | Hardy; tolerates poor water quality; good polyculture anchor |
| Rainbow trout | Earth pond / RAS | Cool (10–18°C water) | High oxygen requirement; premium market value |
| Perch | Earth pond / tank | Temperate | Good flavour; slower growth; suits low-intensity systems |
| Crayfish | Earth pond / channel | Temperate–cool | Very low management; good margin; needs clean cold water |
| Tilapia | Aquaponics / indoor tank | Warm (>22°C) | Fast growth; tolerates crowding; temperature-limited |
| Murray cod | RAS | Warm temperate | Premium; slow; requires high management |
| Duckweed-fed carp | Earth pond | Warm temperate | On-farm feed production; very low external inputs |

**Checkpoint — confirm before finalising:**
- What is the water supply source and reliable annual volume?
- What is the winter low temperature for air and available water?
- How many hours per week can you commit to aquaculture management?

Recommending an aquaponics or RAS system to a time-limited farmer, or a tilapia system to someone in a cold climate, produces a failing system.

**Output:**
```
SYSTEM SELECTION
Recommended system type: [earth pond / lined tank / RAS / aquaponics]
Primary species: [species]
Secondary/polyculture species: [species or none]

Rationale:
- Water: [supply assessment]
- Land/topography: [assessment]
- Climate: [suitability]
- Management fit: [hours per week required vs. available]
- Production goal match: [assessment]

What to do first:
1. [first action — site survey / water test / planning permission check]
2. [second action]

What this system cannot do: [limits to set expectations]
```

**Next steps:**
- Run **water-quality** (within this skill) to understand what monitoring the chosen system requires before stocking.
- `/s4ag-water` — if this system is part of a larger farm water design, map the water flows together.
- `/s4ag-earthworks` — earth pond siting and construction connects directly to keyline and water-harvesting design.

---

## Water Quality

*Measures, maintains, and diagnoses the parameters that keep fish alive and growing.*

Water quality is the single most important management variable in aquaculture. Everything else — feed, stocking density, species choice — is secondary. Fish die from water quality problems, not from feed deficiency. Plants stall in aquaponics from water quality problems. Learn to read the water before you need to react to a crisis.

**The six parameters and what they mean:**

| Parameter | Healthy range | Critical level | What goes wrong |
|---|---|---|---|
| Dissolved oxygen (DO) | >6 mg/L | 9.0 | Stress at extremes; nitrification disrupted |
| Ammonia (NH3/NH4) | 2 mg/L | Gill damage; immune suppression; death |
| Nitrite (NO2) | 0.5 mg/L | Brown blood disease; blocks oxygen uptake |
| Nitrate (NO3) | 200 mg/L | Chronic stress; important in closed systems |
| Temperature | Species-dependent | See table below | Stress; reduced immunity; spawning triggers |

**Temperature ranges by species:**

| Species | Optimal range | Stress threshold |
|---|---|---|
| Rainbow trout | 12–18°C | >22°C dangerous |
| Carp | 18–28°C | 28°C stress |
| Tilapia | 24–30°C | 28°C stress |

**The ammonia cycle — the most important thing to understand:**
Fish excrete ammonia from their gills continuously. In a new system, ammonia accumulates to toxic levels within days unless the nitrifying bacteria (Nitrosomonas, Nitrobacter) are established first. This is called "cycling" the system.

Cycling protocol:
1. Fill the system and run the pump for 2–3 days.
2. Add an ammonia source (pure ammonia solution to 2–4 mg/L, or a small number of fish).
3. Test ammonia and nitrite daily.
4. After 2–4 weeks, ammonia and nitrite will spike then drop as bacteria establish.
5. System is cycled when ammonia and nitrite both read zero within 24 hours of dosing.
6. Only then stock at full density.

*Skipping this step is the most common reason new aquaculture systems fail in the first month.*

**Diagnosing common problems:**

| Observation | Likely cause | Immediate action |
|---|---|---|
| Fish at surface gulping | Low DO | Add aeration immediately; check pump |
| Fish lethargic, off feed | High ammonia or low DO | Test both; water change if ammonia >2 |
| Gills pale or bloody | Nitrite toxicity | 0.5% salt addition buys time; water change |
| pH dropping steadily | Biofiltration acid production | Lime or bicarbonate buffer |
| Algae bloom (green water) | Excess nutrients + sunlight | Shade pond; reduce feed; increase plant load |
| Fish flashing, scratching | Parasites | Observe; salt treatment if confirmed |

**Monitoring schedule:**

| System type | DO | Ammonia/Nitrite | pH | Temperature |
|---|---|---|---|---|
| Earth pond | Weekly | Monthly | Monthly | Weekly |
| Outdoor tank | Twice weekly | Weekly | Weekly | Daily in extremes |
| RAS | Daily | Daily | Daily | Continuous |
| Aquaponics | Daily | Daily | Daily | Daily |

**Aeration:** In all systems except low-density ponds, aeration is not optional. Dissolved oxygen is the first variable to crash in a stressed system — a cheap air pump or paddlewheel aerator is cheap insurance against mass mortality.

**Checkpoint — confirm before finalising:**
- What system type are you monitoring (pond, tank, RAS, aquaponics)? Monitoring intensity differs substantially.
- Do you have a test kit capable of measuring ammonia, nitrite, and pH, or just a general strip test?
- Is this a new system (cycling phase) or an established system with an existing problem?

Recommending a monthly monitoring schedule to someone in the first month of a new system will produce dead fish.

**Output:**
```
WATER QUALITY ASSESSMENT
System type: [type]
Date of assessment: [date]

PARAMETER READINGS
Dissolved oxygen: [value mg/L] — [status]
pH: [value] — [status]
Total ammonia nitrogen: [value mg/L] — [status]
Nitrite: [value mg/L] — [status]
Nitrate: [value mg/L] — [status if measured]
Temperature: [value °C] — [status for species]

ISSUES IDENTIFIED
[parameter]: [problem description and urgency]

IMMEDIATE ACTIONS (do today)
1. [action]
2. [action if needed]

ONGOING MONITORING SCHEDULE
[parameter]: [frequency]
```

**Next steps:**
- Run **feeding-and-nutrition** (within this skill) — overfeeding is the most common cause of ammonia spikes and poor water quality.
- Run **aquaponics** (within this skill) if this is a coupled system — plant bed sizing directly affects water quality buffering.
- `/s4ag-water` — if water quality problems are linked to the source water, assess the water supply.

---

## Feeding and Nutrition

*Reduces feed costs, optimises fish growth, and builds toward on-farm feed self-sufficiency.*

Feed is usually the largest ongoing operating cost in aquaculture, and the most direct driver of water quality problems. Overfeeding kills fish through ammonia. Underfeeding slows growth and undermines the economic case. The target is not maximum feed — it is optimal conversion.

**Feed conversion ratio (FCR):** The mass of feed required to produce 1 kg of fish. A well-managed system should achieve:
- Trout: FCR 1.0–1.5
- Tilapia: FCR 1.5–2.0
- Carp: FCR 2.0–3.0 (lower with natural food supplementation)
- Crayfish: FCR 1.5–2.5

An FCR rising above these ranges means feed is being wasted (water quality problem), fish are stressed (health problem), or feed quality is poor.

**Feeding rate by temperature:**

Feed conversion and appetite both depend on water temperature.

| Temperature | Feeding rate (% body weight/day) |
|---|---|
| 25°C | Reduce to 2–3% (stress threshold for many species) |

Never feed fish that are not actively eating — uneaten feed sinks, decays, and spikes ammonia. Do the 5-minute rule: add a small amount of feed; if it is not consumed in 5 minutes, stop feeding for that session.

**On-farm feed production:**

Replacing purchased pelleted feed with on-farm produced feed can reduce feed costs by 40–80% for the right system.

| Feed input | Suitable species | Production method | Notes |
|---|---|---|---|
| Duckweed (Lemna spp.) | Carp, tilapia, ducks-to-fish | Surface pond or channel | Up to 40% of diet replacement; high protein (~35%) |
| Black soldier fly larvae (BSFL) | Most species | Organic waste processing | Very high protein and fat; excellent FCR replacement |
| Earthworms | Perch, trout, crayfish | Vermicompost system | High quality

…

## 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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-human-avatar-skills-for-agriculture-s4ag-aquaculture
- Seller: https://agentstack.voostack.com/s/human-avatar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.