← Back to Skills Marketplace
unlimitwave

food-expiry-reminder

by CYT · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
395
Downloads
1
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install food-expiry-reminder
Description
食品过期提醒技能。用于记录、管理和提醒食品过期情况。当用户需要记录食品信息、检查食品是否过期、查看即将过期的食品或管理食品库存时使用此技能。数据存储在food_data.json文件中。
README (SKILL.md)

食品过期提醒技能

本技能帮助用户记录、管理和提醒食品过期情况。所有食品数据存储在food_data.json文件中。

功能概述

  1. 记录食品信息 - 添加新的食品记录
  2. 检查过期状态 - 检查食品是否已过期或即将过期
  3. 查看所有食品 - 列出所有食品及其状态
  4. 提醒功能 - 提醒一周内将过期的食物
  5. 数据管理 - 更新或删除食品记录

数据结构

食品数据存储在food_data.json文件中,格式如下:

{
  "foods": [
    {
      "id": "唯一标识符",
      "name": "食品名称",
      "production_date": "生产日期 (YYYY-MM-DD)",
      "expiry_days": "保质期天数",
      "expiry_date": "过期日期 (自动计算)",
      "location": "存放位置",
      "quantity": "数量",
      "notes": "备注",
      "created_at": "创建时间",
      "updated_at": "更新时间"
    }
  ]
}

使用方法

1. 添加新食品

使用以下命令添加新食品:

python scripts/add_food.py "食品名称" "生产日期" "保质期天数" "存放位置" "数量" "备注"

或手动编辑food_data.json文件。

2. 检查过期状态

运行检查脚本查看过期和即将过期的食品:

python scripts/check_expiry.py

3. 查看所有食品

查看当前存储的所有食品:

python scripts/list_foods.py

4. 获取提醒

获取一周内将过期的食品提醒:

python scripts/get_reminders.py

脚本说明

scripts/add_food.py

添加新食品到数据库。参数:

  • 食品名称
  • 生产日期 (YYYY-MM-DD)
  • 保质期天数 (整数)
  • 存放位置
  • 数量 (可选,默认1)
  • 备注 (可选)

scripts/check_expiry.py

检查所有食品的过期状态,显示:

  • 已过期的食品
  • 一周内将过期的食品
  • 两周内将过期的食品
  • 安全的食品

scripts/list_foods.py

列出所有食品的详细信息,包括状态。

scripts/get_reminders.py

专门获取一周内将过期的食品提醒。

scripts/init_data.py

初始化food_data.json文件(如果不存在)。

工作流程

  1. 初始化数据文件 - 首次使用时运行init_data.py
  2. 添加食品记录 - 购买新食品后立即记录
  3. 定期检查 - 每天或每周运行check_expiry.py
  4. 处理提醒 - 根据提醒处理即将过期的食品

注意事项

  1. 生产日期格式必须为YYYY-MM-DD
  2. 保质期天数为整数
  3. 过期日期会自动计算
  4. 建议每天运行一次检查脚本
  5. 数据文件位于data/food_data.json

参考文件

Usage Guidance
This skill appears to do exactly what it says: local Python scripts that read and write data/food_data.json. Before installing or running: (1) review the scripts (they are small and use only the standard library); (2) be aware data is stored in plain JSON in the skill directory—don't put secrets or sensitive info in the notes field; (3) consider backups or version control for the JSON file if you care about data loss; (4) if you plan to schedule cron jobs, ensure the job runs in the expected directory and under the intended user account; (5) the scripts do not implement file-locking for concurrent writes—avoid running multiple writers simultaneously to prevent corruption. No network access or credentials are requested by this skill.
Capability Analysis
Type: OpenClaw Skill Name: food-expiry-reminder Version: 1.0.0 The food-expiry-reminder skill bundle is a legitimate tool for tracking food shelf life. The Python scripts (e.g., add_food.py, check_expiry.py) use standard libraries to manage a local JSON database and perform date calculations without any network activity, data exfiltration, or suspicious execution patterns. The documentation and instructions are consistent with the stated purpose and do not contain any prompt-injection attempts or hidden malicious commands.
Capability Assessment
Purpose & Capability
Name/description match the delivered functionality. The scripts implement adding, listing, checking, and reminding about food expiry and store data in data/food_data.json as documented.
Instruction Scope
SKILL.md instructions align with the scripts. Runtime instructions only reference local files and running the provided Python scripts; they do not instruct reading unrelated system files, contacting external endpoints, or collecting extra environment data.
Install Mechanism
No install spec; this is an instruction-only skill with bundled Python scripts that rely on the standard library. No downloads, package installs, or extracted archives are requested.
Credentials
The skill requires no environment variables, credentials, or config paths. All data access is confined to the skill directory (data/food_data.json). There are no requests for secrets or unrelated service tokens.
Persistence & Privilege
always:false and default autonomous invocation are used (normal). The skill writes only to its own data file and does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install food-expiry-reminder
  3. After installation, invoke the skill by name or use /food-expiry-reminder
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of food-expiry-reminder skill: - Record, manage, and get reminders for food expiry dates. - Store food data in food_data.json with fields like name, production date, expiry, location, and notes. - Add new food records, check expiry status, list all items, and get reminders for soon-to-expire foods via scripts. - Scripts provided for adding, checking, listing foods, setting reminders, and data initialization. - Documentation includes usage, data structure, and workflow guidance.
Metadata
Slug food-expiry-reminder
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is food-expiry-reminder?

食品过期提醒技能。用于记录、管理和提醒食品过期情况。当用户需要记录食品信息、检查食品是否过期、查看即将过期的食品或管理食品库存时使用此技能。数据存储在food_data.json文件中。 It is an AI Agent Skill for Claude Code / OpenClaw, with 395 downloads so far.

How do I install food-expiry-reminder?

Run "/install food-expiry-reminder" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is food-expiry-reminder free?

Yes, food-expiry-reminder is completely free (open-source). You can download, install and use it at no cost.

Which platforms does food-expiry-reminder support?

food-expiry-reminder is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created food-expiry-reminder?

It is built and maintained by CYT (@unlimitwave); the current version is v1.0.0.

💬 Comments