AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

S4ag Aquaculture

skill-human-avatar-skills-for-agriculture-s4ag-aquaculture · by human-avatar

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

No reviews yet
0 installs
27 views
0.0% view→install

Install

$ agentstack add skill-human-avatar-skills-for-agriculture-s4ag-aquaculture

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

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

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-human-avatar-skills-for-agriculture-s4ag-aquaculture)

Reliability & compatibility

Security review passed
0 installs to date
no reviews yet
3mo ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

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 →
Are you the author of S4ag Aquaculture? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

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.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Versions

  • v0.1.0 Imported from the upstream source.