← Back to Skills Marketplace
p-salmon

Kefir Batch Manager

by Paul Salmon · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
583
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install kefir-batch-manager
Description
Comprehensive kéfir batch management system with cycle tracking, intelligent reminders, grain health monitoring, and recipe management. Use when managing kéf...
README (SKILL.md)

Kéfir Batch Manager

Complete management system for kéfir de fruits fermentation cycles, grain maintenance, and production tracking.

When to Use

  • Starting new fermentation batches
  • Tracking active fermentation cycles
  • Managing grain health and stock
  • Calculating ingredient ratios
  • Setting intelligent reminders based on temperature/season
  • Recording tasting notes and batch quality
  • Planning production schedules
  • Troubleshooting fermentation issues

Core Features

1. Batch Cycle Management

Start New Batch:

- Record start time, ingredients, ratios
- Calculate optimal fermentation duration based on temperature
- Set adaptive reminders (faster in summer, slower in winter)
- Photo documentation (before fermentation)

Track Active Batches:

- Monitor fermentation progress
- Adjust timing based on environmental conditions
- Log observations and changes
- Alert when ready for tasting/bottling

Complete Batch:

- Record end time and actual duration
- Document results, taste notes, quality rating
- Calculate yield and efficiency
- Photo documentation (final product)

2. Intelligent Reminders

Temperature-adaptive scheduling:

  • Summer (>25°C): 18-24 hours first fermentation
  • Spring/Autumn (20-25°C): 24-36 hours
  • Winter (\x3C20°C): 36-48 hours

Maintenance reminders:

  • Weekly: Check active batches
  • Monthly: Refresh mother grains
  • Seasonal: Deep clean equipment

3. Grain Management

Health Monitoring:

- Visual inspection checklist
- Color, firmness, multiplication rate tracking
- Problem diagnosis (mold, softness, inactivity)
- Stock management (mother + active portions)

Stock Tracking:

- Mother grain reserve (typically 200g)
- Active batch portions
- Grain multiplication calculations
- Sharing/backup planning

4. Recipe Database

Base Recipes:

  • Classic water kéfir (sugar ratios)
  • Fruit variations (seasonal recommendations)
  • Milk kéfir adaptations
  • Flavoring combinations (spices, herbs)

Personalization:

  • Save favorite recipes
  • Seasonal ingredient optimization
  • Success rate tracking per recipe
  • Custom ratio calculations

5. Production Dashboard

Calendar View:

  • Batch timeline visualization
  • Optimal start dates planning
  • Holiday/vacation scheduling
  • Production frequency analysis

Statistics:

  • Success rates by season/temperature
  • Favorite recipes and variations
  • Grain multiplication trends
  • Production consistency metrics

Usage Workflows

Daily Check-in

1. Review active batches status
2. Check temperature for timing adjustments
3. Update fermentation progress notes
4. Set next reminder if needed

Weekly Planning

1. Plan new batches based on consumption
2. Check grain health and stock levels
3. Review upcoming events/travel
4. Adjust production schedule

Monthly Maintenance

1. Refresh mother grain batch
2. Deep clean all equipment
3. Review month's production statistics
4. Plan seasonal recipe transitions

Specialized Knowledge

Paris Water Considerations

  • Chlorine removal techniques (24h standing, filtration)
  • Mineral content impacts on fermentation
  • Seasonal water quality variations

Double Fermentation Technique

  • Primary: 24-48h depending on temperature
  • Secondary: 12-24h in bottle for carbonation
  • Timing optimization for best results

Troubleshooting Guide

See troubleshooting.md for complete diagnostic guide.

Implementation Scripts

  • batch_tracker.py: Core batch lifecycle management
  • ratio_calculator.py: Ingredient calculations
  • reminder_scheduler.py: Intelligent timing alerts
  • grain_health.py: Health monitoring and diagnostics

Templates and Assets

  • batch_template.json: Standard batch record format
  • grain_health_guide.png: Visual health assessment guide
  • recipe_templates/: Collection of proven recipes

Getting Started

  1. Initialize your setup: Document current grain stock and equipment
  2. Start tracking: Begin with your next batch using the batch tracker
  3. Set preferences: Configure your temperature zone and timing preferences
  4. Build history: Record several batches to establish baselines

The skill learns from your specific environment and preferences to provide increasingly accurate timing and recommendations.

Usage Guidance
This package contains two benign-looking Python scripts that handle local batch tracking and ratio calculations and will read/write kefir_batches.json in the working directory. However, SKILL.md promises extra features (reminders, grain health scripts, image assets, and a learning component) that are missing from the manifest — the package appears incomplete. Before installing or enabling: 1) ask the author for the missing files (reminder_scheduler.py, grain_health.py, images/templates) or an updated manifest; 2) if you proceed, run the code in an isolated/sandbox environment and review the scripts yourself (they are short and readable) to confirm there are no network calls or hidden behavior; 3) back up your working directory because the scripts will create/modify kefir_batches.json; and 4) do not assume the advertised 'learning' or reminder features exist until you see the corresponding code. The inconsistencies are likely sloppy packaging rather than malicious intent, but verify before granting broader access or using in production.
Capability Analysis
Type: OpenClaw Skill Name: kefir-batch-manager Version: 1.0.0 The skill bundle is primarily benign, focusing on kéfir batch management. However, the `scripts/batch_tracker.py` file includes functions (`load_batch_history`, `save_batch`) that perform file I/O using a `data_file` parameter. While this parameter defaults to `kefir_batches.json`, if an AI agent were prompted to call these functions with an arbitrary file path, it could lead to arbitrary file read/write. This represents a vulnerability (lack of input sanitization/path validation) that could be exploited via prompt injection against the agent, rather than malicious intent within the script itself.
Capability Assessment
Purpose & Capability
Name/description match the included scripts' primary functions (batch tracking and ratio calculation). However SKILL.md advertises additional capabilities (reminder_scheduler.py, grain_health.py, learning/adaptive behavior, visual guides, recipe_templates) that are not present in the file manifest. That mismatch is disproportionate to the declared deliverables.
Instruction Scope
Runtime instructions mention scheduling reminders, photo documentation, grain health diagnostics and learning from environment. The provided scripts implement basic local batch tracking and ratio calculations only; there is no scheduler, no learning component, and no image handling code. The instructions also reference files/assets that are not present. The mismatch means the agent could be instructed to perform actions the code cannot implement.
Install Mechanism
No install spec (instruction-only with packaged scripts). Nothing is downloaded or executed automatically during install; code is static and included in the package. This is a low-risk installation mechanism.
Credentials
The skill requests no environment variables, no credentials, and does not reference system config paths. The included scripts read/write a local kefir_batches.json in the working directory only, which is proportionate to the stated purpose.
Persistence & Privilege
always:false and normal model invocation settings. The skill stores batch history to kefir_batches.json in the current directory (local persistence), which is reasonable for a tracker and does not request elevated system privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install kefir-batch-manager
  3. After installation, invoke the skill by name or use /kefir-batch-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
kefir-batch-manager 1.0.0 – Initial release - Comprehensive kéfir batch management system including cycle tracking, grain health monitoring, and intelligent reminders - Adaptive scheduling and reminders based on seasonal temperature variations - Visual grain health checklists, stock tracking, and problem diagnosis features - Recipe management with seasonal recommendations and personalized success tracking - Integrated calendar and production analytics dashboard for planning and review - Includes scripts and assets for fermentation tracking, health assessment, and documentation
Metadata
Slug kefir-batch-manager
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Kefir Batch Manager?

Comprehensive kéfir batch management system with cycle tracking, intelligent reminders, grain health monitoring, and recipe management. Use when managing kéf... It is an AI Agent Skill for Claude Code / OpenClaw, with 583 downloads so far.

How do I install Kefir Batch Manager?

Run "/install kefir-batch-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Kefir Batch Manager free?

Yes, Kefir Batch Manager is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Kefir Batch Manager support?

Kefir Batch Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Kefir Batch Manager?

It is built and maintained by Paul Salmon (@p-salmon); the current version is v1.0.0.

💬 Comments