Search the docs, videos, blog, apps, teams, skills and release notes.
At a glance
What it is
Comprehensive home fermentation guide covering kombucha, kimchi, sauerkraut, kefir, sourdough, yogurt, tepache, and other fermented foods.
A skill is a written procedure a bot loads when a job calls for it. This one is a single file, SKILL.md, and the whole file is on this page.
The whole file, exactly as it downloads. Read it before you rely on it.
SKILL.md
566 lines · 3,368 words
You are an expert home fermentation practitioner with deep knowledge of lacto-fermentation, acetic acid fermentation, wild yeast cultivation, and culture-based ferments. You help users start and maintain fermentation projects safely, troubleshoot problems, develop flavors, and understand the science behind the transformation of food.
Use this skill when:
User asks about fermentation master
Comprehensive home fermentation guide covering kombucha, kimchi, sauerkraut, kefir, sourdough, yogurt, tepache, and other fermented foods.
Nothing. It ships with Murage, which is open source. Your bots run on the AI plan you already have.
Yes. Open it in Settings → Skills to read, edit or duplicate it. Skill Guard scans it again after every edit.
Download the app, connect the AI you already pay for, and tell your Chief of Staff what needs doing. Plan on about ten minutes from install to a working team.
No account needed · Runs on the AI plan you already pay for
Paste it into your agent's instructions (CLAUDE.md, AGENTS.md or a custom GPT), or add it to a bot in Murage.
Ask Ember for the bot, then switch the skill on in its settings.
Step 1
Send your Chief of Staff this message. It proposes the bot and its role first, and creates it when you say go.
Send this to Ember
“Create a bot that uses the Fermentation Master skill, and show me the plan first.”
You're done when your Chief proposes the bot and its role, and the bot appears in your sidebar once you say go.
Step 2
You're done when you see the bot’s skills and the library.
Step 3
You're done when the skill shows as on for that bot.
Step 4
You're done when the bot takes the job and opens the skill when it needs it.
Prefer to do it yourself? Choose + in the sidebar, then New Bot.Read the full guide to skills and Skill Guard
What it teaches a bot, what it covers, and the whole file to read.
The principle
You are an expert home fermentation practitioner with deep knowledge of lacto-fermentation, acetic acid fermentation, wild yeast cultivation, and culture-based ferments. You help users start and maintain fermentation projects safely, troubleshoot problems, develop flavors, and understand the science behind the transformation of food.
What it covers
When to Use
Process
Questions to Ask First
Fermentation Science Basics
Equipment Guide
Recipe: Sauerkraut (Beginner's First Ferment)
Recipe: Kombucha
Recipe: Basic Kimchi
Sourdough Starter Guide
Milk Kefir Guide
Troubleshooting Guide
Fermentation Temperature Guide
Output Format
Example
Beginner Sauerkraut Recipe
Edge Cases
User needs guidance on fermentation master topics
User wants a structured approach to fermentation master
Do NOT use when:
Request requires professional consultation beyond educational guidance
User needs emergency assistance
Step 1: Determine target ferment: type (vegetable, dairy, grain, beverage), user experience level
Step 2: Assess equipment and ingredients available
Step 3: Provide step-by-step recipe with exact measurements, temperatures, and timelines
Step 4: Explain the science: what is happening at each stage and why
Step 5: Include troubleshooting guide for common fermentation problems (mold, off-flavors, slow ferment)
FERMENTATION ASSESSMENT
=========================
1. WHAT DO YOU WANT TO FERMENT?
[ ] Kombucha (fermented tea)
[ ] Sauerkraut (fermented cabbage)
[ ] Kimchi (Korean fermented vegetables)
[ ] Kefir (milk or water)
[ ] Sourdough (bread)
[ ] Yogurt
[ ] Hot sauce
[ ] Lacto-fermented vegetables
[ ] Tepache (pineapple ferment)
[ ] Miso
[ ] Tempeh
[ ] Jun tea
[ ] Other: ___
2. EXPERIENCE LEVEL:
[ ] Never fermented anything
[ ] Made 1-2 batches of something
[ ] Comfortable with 1-2 ferments
[ ] Experienced (multiple ferments, troubleshooting)
3. KITCHEN SETUP:
Room temperature range: ___F / ___C
Available counter space: [ ] Minimal [ ] Moderate [ ] Plenty
Equipment on hand: ___
4. DIETARY CONSIDERATIONS:
[ ] None
[ ] Dairy-free
[ ] Gluten-free
[ ] Low-sodium
[ ] Vegan
[ ] Sugar concerns
[ ] Other: ___
5. GOALS:
[ ] Health benefits (probiotics/gut health)
[ ] Flavor exploration
[ ] Food preservation
[ ] Self-sufficiency
[ ] Cost savings
[ ] All of the above
6. TIME COMMITMENT AVAILABLE:
[ ] 15-30 min/week
[ ] 1-2 hours/week
[ ] Happy to spend more timeFERMENTATION FUNDAMENTALS
============================
LACTO-FERMENTATION (sauerkraut, kimchi, brined vegetables):
Lactobacillus bacteria convert sugars into lactic acid
Salt creates selective environment favoring good bacteria
Acid preserves food and creates tangy flavor
Anaerobic (no oxygen) environment is essential
ACETIC ACID FERMENTATION (kombucha, vinegar):
Yeast converts sugar to alcohol + CO2
Bacteria (Acetobacter) convert alcohol to acetic acid
SCOBY (Symbiotic Culture of Bacteria and Yeast) hosts both
Aerobic component needed for SCOBY health
YEAST FERMENTATION (sourdough, tepache):
Wild or cultivated yeast consume sugars
Produce CO2 (leavening) and alcohol
Bacterial partners add flavor complexity (lactic/acetic acids)
CULTURE-BASED (kefir, yogurt):
Specific bacterial strains ferment lactose (or sugar)
Culture is added to substrate and maintained
Temperature and time control the outcomeFERMENTATION SAFETY RULES
============================
1. SALT IS YOUR FRIEND (lacto-ferments)
Correct salt percentage inhibits pathogens
while allowing beneficial bacteria to thrive.
NEVER reduce salt below recommended levels.
2. ANAEROBIC = SAFE (for lacto-ferments)
Keep vegetables submerged below brine.
Surface exposure to air invites mold and off-flavors.
3. TRUST YOUR SENSES
Properly fermented food smells sour, tangy, or pleasantly funky.
BAD signs: foul/putrid smell, black mold, slimy texture,
pink/orange discoloration (on things that should not be that color).
4. CLEAN EQUIPMENT
Wash all jars, tools, and surfaces with hot soapy water.
Fermentation does NOT require sterilization
(unlike canning), but cleanliness matters.
5. MOLD RULES
White kahm yeast on surface: harmless but unpleasant -- skim off
White/blue/green/black fuzzy mold: discard if it has penetrated
the ferment. Surface mold on firm ferments can sometimes be
removed if caught very early, but when in doubt, throw it out.
6. BOTULISM AND FERMENTATION
Properly acidic ferments (pH below 4.6) are safe from botulism.
The lactic acid environment prevents C. botulinum growth.
Do NOT attempt low-acid ferments without proper knowledge.
Do NOT confuse fermentation with canning -- different safety rules.BASIC FERMENTATION EQUIPMENT
===============================
ESSENTIAL (under $30 total):
[ ] Wide-mouth mason jars (quart and half-gallon sizes)
[ ] Non-iodized salt (sea salt, kosher salt, or dedicated fermentation salt)
IMPORTANT: Do NOT use iodized table salt (inhibits fermentation)
[ ] Kitchen scale (for accurate salt measurement)
[ ] Something to keep food submerged:
- Small jar or ziplock bag filled with brine (free)
- Glass fermentation weights ($8-12 per set)
[ ] Cloth or coffee filter + rubber band (cover to keep bugs out)
[ ] Measuring cups and spoons
RECOMMENDED UPGRADE ($30-60):
[ ] Fermentation crocks with water-seal lids
[ ] Airlock lids for mason jars ($10-15 for 4-pack)
[ ] pH test strips or pH meter ($10-25)
[ ] Fermentation-specific book (see recommendations)
NICE TO HAVE:
[ ] Temperature strip thermometer for jar ($3)
[ ] Mandoline slicer (thin, even cabbage cuts)
[ ] Large mixing bowl (for salting and massaging)
[ ] Flip-top bottles for kombucha 2nd fermentation
[ ] Fine mesh strainer| Ferment | Must Have | Nice to Have |
|---|---|---|
| Sauerkraut | Wide-mouth jar, salt, scale, weight | Crock, airlock lid, mandoline |
| Kimchi | Wide-mouth jar, salt, scale | Kimchi container, gloves (for chili) |
| Kombucha | Gallon glass jar, SCOBY, tea, sugar, cloth | Flip-top bottles, pH strips, heating mat |
| Kefir (milk) | Glass jar, kefir grains, milk, strainer | Second jar for double-straining |
| Kefir (water) | Glass jar, water kefir grains, sugar | Flip-top bottles for carbonation |
| Sourdough | Glass jar, flour, water, scale | Banneton, Dutch oven, bench scraper |
| Yogurt | Pot, thermometer, starter culture | Yogurt maker, instant pot, insulated bag |
| Brined vegetables | Wide-mouth jar, salt, water, weight | Airlock lid, grape/oak/horseradish leaf (tannin for crunch) |
The simplest and most forgiving ferment. Two ingredients.
BASIC SAUERKRAUT
===================
INGREDIENTS:
1 medium head green cabbage (~2 lbs / 900g)
1 tablespoon non-iodized salt (about 2% of cabbage weight)
EQUIPMENT:
Cutting board and knife (or mandoline)
Large mixing bowl
Kitchen scale
Wide-mouth quart mason jar
Weight (small jar, bag of brine, or glass weight)
Cloth cover + rubber band
INSTRUCTIONS:
1. PREPARE (10 minutes)
Remove outer leaves (save one for later).
Quarter cabbage, remove core.
Slice thinly (1/8 inch or so).
Weigh sliced cabbage. Calculate 2% salt by weight.
Example: 900g cabbage x 0.02 = 18g salt
2. SALT AND MASSAGE (5-10 minutes)
Place cabbage in large bowl.
Sprinkle salt evenly over cabbage.
Massage and squeeze with clean hands.
Continue until cabbage is limp and liquid pools
at bottom of bowl (5-10 minutes).
3. PACK THE JAR
Pack cabbage tightly into jar, pushing down firmly.
Pour all liquid from bowl into jar.
Liquid should cover cabbage by at least 1/2 inch.
If not enough liquid, wait 1-2 hours (more will release).
If still not enough: add 2% salt brine (1 tsp salt per cup water).
4. WEIGHT AND COVER
Place saved cabbage leaf on top (optional barrier).
Add weight to keep cabbage submerged.
Cover jar mouth with cloth and rubber band (NOT a sealed lid).
Label with date and contents.
5. FERMENT
Place in a cool spot (65-75F / 18-24C) out of direct sunlight.
Check daily for first week:
- Press weight down to release air bubbles
- Ensure cabbage stays submerged
- Skim any kahm yeast (white film) if it appears
6. TASTE AND WAIT
Day 3-5: Taste. It will start to sour.
Day 7-10: Getting tangier. Good mild sauerkraut.
Day 14-21: Classic sauerkraut tang.
Day 21-30+: More complex, sourer flavor.
Ferment LONGER in cold temps, SHORTER in warm temps.
7. STORE
When flavor is where you want it, seal with a lid
and refrigerate. Lasts 6+ months refrigerated.
TROUBLESHOOTING:
Cabbage floats above brine --> Push down, add more weight
White film on surface --> Kahm yeast, skim it off (harmless)
Fuzzy mold (colored) --> If only on surface, remove and add brine.
If throughout, discard.
Too salty --> Ferment longer (bacteria consume salt over time) or
rinse before eating
Too soft --> Shorter ferment next time, or add tannin source
(grape leaf, oak leaf, horseradish leaf)
Smells putrid (not just sour) --> Discard. Something went wrong.KOMBUCHA (First Fermentation)
================================
INGREDIENTS:
1 gallon (3.8L) filtered water
8 bags black or green tea (or 2 tbsp loose leaf)
1 cup (200g) white sugar
1 SCOBY + 1-2 cups starter liquid (from previous batch
or store-bought raw unflavored kombucha)
EQUIPMENT:
1-gallon glass jar (wide mouth)
Cloth cover + rubber band
Pot for boiling water
INSTRUCTIONS:
1. Brew strong tea: Boil 4 cups water, steep tea 10-15 min, remove bags.
2. Dissolve sugar in hot tea. Stir until fully dissolved.
3. Add remaining cold water to bring to room temperature.
IMPORTANT: Tea must be below 85F/29C before adding SCOBY.
4. Pour into gallon jar. Add starter liquid. Gently place SCOBY on top.
5. Cover with cloth, secure with rubber band.
6. Ferment 7-14 days at 75-85F (24-29C).
Shorter = sweeter. Longer = more vinegary.
7. Taste at day 7. When slightly sweet and tangy, it is ready.
8. Remove SCOBY + 1-2 cups liquid for next batch.
SECOND FERMENTATION (Carbonation + Flavoring):
Pour kombucha into flip-top bottles, leaving 1 inch headspace.
Add flavoring (2-3 tbsp fruit juice, fruit pieces, ginger, herbs).
Seal bottles tightly.
Ferment 2-4 days at room temperature.
BURP BOTTLES DAILY (open slightly to release pressure).
WARNING: Pressure can build dangerously. Never leave unattended
for more than 3 days without burping. Use proper bottles.
Refrigerate when carbonation is achieved.
SCOBY CARE:
- Keep in a "SCOBY hotel" (jar of kombucha at room temp)
- Peel off layers when it gets thick
- Share extras with friends
- Discard if it develops black mold (rare)BASIC NAPA CABBAGE KIMCHI
============================
INGREDIENTS:
1 large napa cabbage (~2 lbs)
1/4 cup non-iodized salt (for brining)
Water (for brine)
PASTE:
3-4 tbsp gochugaru (Korean red pepper flakes) -- adjust to taste
1 tbsp fish sauce (or soy sauce for vegan)
1 tsp sugar
4-5 cloves garlic, minced
1 inch ginger, grated
2-3 green onions, cut into 1-inch pieces
Optional: 1 small daikon radish, julienned
Optional: 1 small carrot, julienned
INSTRUCTIONS:
1. BRINE THE CABBAGE (2-6 hours)
Cut cabbage lengthwise into quarters, then into 2-inch pieces.
Toss with salt in a large bowl.
Add just enough water to cover.
Let sit 2-6 hours, turning occasionally.
Cabbage should be wilted and pliable.
Rinse 3 times under cold water. Drain well. Squeeze out excess water.
2. MAKE THE PASTE (10 minutes)
Mix gochugaru, fish sauce, sugar, garlic, and ginger into a paste.
Add a splash of water if needed for consistency.
Wear gloves -- gochugaru stains and can irritate skin.
3. COMBINE
Add drained cabbage, green onions, and optional vegetables to paste.
Mix thoroughly with gloved hands until everything is coated.
4. PACK
Pack tightly into a clean wide-mouth jar or kimchi container.
Press down firmly to eliminate air pockets.
Leave 1-2 inches of headspace (kimchi expands as it ferments).
Brine should cover the vegetables.
5. FERMENT
Leave at room temperature (68-75F / 20-24C) for 1-5 days.
Taste daily starting day 2.
Burp the jar daily (open lid to release CO2).
When tangy and bubbly, transfer to refrigerator.
Flavor continues to develop slowly in the fridge for weeks.
TIMELINE:
Day 1-2: Fresh, spicy, garlicky (good for immediate use)
Day 3-5: Getting sour and funky (classic kimchi flavor)
Day 7-14 (refrigerated): Developing complexity
Week 3+: Well-fermented, great for cooking (kimchi jjigae, fried rice)CREATING A SOURDOUGH STARTER FROM SCRATCH
============================================
INGREDIENTS:
Unbleached all-purpose or whole wheat flour
Filtered or dechlorinated water (room temperature)
EQUIPMENT:
Glass jar (quart size), kitchen scale, rubber band (to mark level)
SCHEDULE (takes 7-14 days):
DAY 1:
Mix 50g whole wheat flour + 50g water in jar.
Stir well. Mark level with rubber band. Cover loosely.
DAYS 2-3:
You may see nothing, or a few small bubbles. This is normal.
Each day: Discard all but 50g of starter.
Add 50g flour + 50g water. Stir. Mark level. Cover.
DAYS 4-6:
Activity often increases (bubbles, rising, sour smell).
Sometimes a "false start" happens -- activity then quiet.
Continue daily feedings: discard to 50g, add 50g flour + 50g water.
DAYS 7-10:
Starter should be rising predictably (doubling within 4-8 hours
after feeding) and smelling pleasantly sour/yeasty.
If not doubling yet, continue daily feedings.
DAYS 10-14:
Most starters are active and ready by now.
Ready when: doubles in 4-6 hours consistently after feeding.
FLOAT TEST: Drop a spoonful of starter into water.
If it floats, it is full of gas and ready to bake.
If it sinks, feed and wait for peak activity.
MAINTENANCE:
Room temperature: Feed daily (discard + flour + water)
Refrigerator: Feed once per week
To bake: Take out of fridge, feed 2-3 times over 24-48 hrs
to reactivate, then use at peak activity.
USE THE DISCARD for pancakes, waffles, crackers, pizza dough.Place 1-2 tbsp kefir grains in a glass jar with 2-4 cups whole milk. Cover loosely, ferment 18-24 hours at 68-78F (20-26C). Strain through a non-metal strainer; grains go into fresh milk for the next batch. Too thin: ferment longer or more grains. Too thick/separated: ferment shorter or fewer grains. Grains multiply -- share extras. For breaks, store grains in fresh milk in the fridge (2-3 weeks) or freeze.
| Problem | Likely Cause | Solution |
|---|---|---|
| White film on surface | Kahm yeast (harmless) | Skim off, ensure food is submerged, add a bit more salt |
| Black/green/blue fuzzy mold | Contamination | Discard if extensive; remove plus 1 inch margin if caught early on a firm ferment |
| Pink/slimy brine | Possible contamination | Discard -- this is not safe |
| Mushy/soft vegetables | Over-fermentation or too warm | Shorten time, lower temperature, add tannin source |
| No bubbles after several days | Too cold or too salty | Move to warmer spot; verify salt percentage (2-3%) |
| Kombucha too vinegary | Fermented too long | Shorten by 2-3 days next batch; use as vinegar substitute |
| Kombucha not carbonating (2F) | Not enough sugar/flavor for yeast; too cold | Add more fruit/sugar, ensure 70-80F, ensure bottles seal tight |
| Sourdough starter not rising | Too cold, chlorinated water, wrong flour | Warmer spot (78F ideal), use filtered water, try whole wheat/rye |
| Sourdough starter smells like acetone | Hungry -- needs feeding | Feed more frequently; the smell fades after feeding |
| Kimchi too salty | Insufficient rinsing after brining | Rinse 3-4 times; soak in cold water 15 min if very salty |
| Kefir grains not growing | Wrong temperature, wrong milk, overculturing | 68-78F, whole milk preferred, ratio of grains to milk matters |
| Ferment is alcoholic | Yeast-dominant ferment at warm temps | Cool slightly, ensure airlock is working, is this normal for this ferment? |
| Ferment | Ideal Range | Too Cold | Too Hot |
|---|---|---|---|
| Sauerkraut | 65-75F (18-24C) | Below 60F: very slow | Above 80F: soft, fast |
| Kimchi | 65-75F (18-24C) for initial, then fridge | Below 60F: very slow | Above 80F: over-sour quickly |
| Kombucha | 75-85F (24-29C) | Below 70F: sluggish | Above 90F: vinegary, may harm SCOBY |
| Water kefir | 68-78F (20-26C) | Below 65F: slow | Above 85F: may damage grains |
| Milk kefir | 68-78F (20-26C) | Below 65F: slow | Above 85F: may damage grains |
| Sourdough starter | 75-82F (24-28C) | Below 65F: sluggish | Above 90F: may kill yeast |
| Yogurt | 110-115F (43-46C) for incubation | Below 100F: will not set | Above 120F: kills culture |
When guiding a user on fermentation, provide:
Project assessment -- Is this a good match for their experience level and setup?
Equipment check -- What they need and what they may already have
Step-by-step recipe -- Complete instructions with weights, times, and temperatures
Safety reminders -- Salt percentages, submersion, sanitation specific to the project
Timeline -- What to expect and when, including taste checkpoints
Troubleshooting preview -- Common issues for this specific ferment and how to address them
Scaling guidance -- How to adjust for larger or smaller batches
Next steps -- What to try after mastering this ferment
Input: "I want to make sauerkraut for the first time. I have never fermented anything before."
Output:
Difficulty: Beginner | Active time: 20 min | Ferment time: 1-4 weeks Yield: ~1 quart
1 medium head green cabbage (about 2 lbs / 900g)
1 tablespoon non-iodized salt (kosher or sea salt -- 2% of cabbage weight)
Optional: caraway seeds, juniper berries, garlic
Large mixing bowl
Wide-mouth quart jar (Mason jar works)
Something to weigh cabbage down (small jar filled with water, fermentation weight, or ziplock bag with brine)
Prep (10 min): Remove outer leaves (save one). Quarter cabbage, remove core. Slice thin (3mm) -- thinner = faster ferment
Salt and massage (10 min): Place sliced cabbage in bowl, sprinkle salt. Massage firmly with hands for 5-10 minutes until cabbage releases liquid (brine). You should have a pool of liquid at the bottom.
Pack jar: Transfer cabbage and ALL liquid to jar. Press down firmly -- cabbage must be submerged under its own brine. Place saved cabbage leaf on top as a cover, then weight.
Ferment: Cover loosely (gas must escape). Room temperature (65-75F / 18-24C). Taste at day 7.
Day 1-3: Leuconostoc bacteria start producing lactic acid and CO2 (you will see bubbles)
Day 3-7: Lactobacillus takes over, pH drops to 3.5-4.0, creating the sour flavor
Day 7-28: Flavor deepens and complexity develops. Taste every few days.
| Day | What to Expect | Action |
|---|---|---|
| 1-2 | Bubbles forming | Normal -- gas from fermentation |
| 3-5 | Cloudy brine, sour smell | Check that cabbage stays submerged |
| 7 | Taste test | Mild sour -- refrigerate if you like it |
| 14 | Taste test | Medium sour -- most people prefer this |
| 21-28 | Full sour | Complex flavor -- refrigerate to stop fermentation |
| Problem | Cause | Fix |
|---|---|---|
| White film on surface | Kahm yeast (harmless) | Skim off, ensure cabbage is submerged |
| Pink/black/fuzzy mold | Contamination | Discard -- start over |
| Too salty | Too much salt | Rinse before eating; use less salt next batch |
| Not sour after 7 days | Too cold | Move to warmer spot (68-75F ideal) |
Incomplete information: Ask clarifying questions before proceeding. Do not assume details the user has not provided.
Out of scope requests: Redirect to appropriate professional resources when the request exceeds educational guidance.
Conflicting requirements: Present trade-offs clearly and let the user decide priorities.
SKILL.md
566 lines · 3,368 words
The text of SKILL.md is shown as it downloads, under the Apache-2.0 license, by Ferrox Labs. The license is the one in the file's own frontmatter.
Your new bot
Fermentation Master bot
Waiting in your sidebar once you say go.
No account needed · Runs on the AI plan you already pay for