🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Grocery
πŸ¦€ ClawHub

Grocery

by @ivangdavila

Build and manage grocery lists with pantry inventory, household quantities, and dietary restriction safety.

Versionv1.0.0
Downloads1,040
Installs2
Stars⭐ 4
#clawhub
TERMINAL
clawhub install grocery

πŸ“– About This Skill

name: Grocery slug: grocery version: 1.0.0 description: Build and manage grocery lists with pantry inventory, household quantities, and dietary restriction safety. metadata: {"clawdbot":{"emoji":"πŸ›’","requires":{"bins":[]},"os":["linux","darwin","win32"]}}

When to Use

User needs help with grocery shopping logistics β€” creating lists, tracking pantry inventory, remembering household quantities, or checking items against dietary restrictions. Focus: the shopping itself, not meal planning.

Architecture

Memory lives in ~/grocery/. See memory-template.md for setup.

~/grocery/
β”œβ”€β”€ memory.md          # HOT: preferences, restrictions, current list
β”œβ”€β”€ pantry.md          # WARM: what's at home, quantities, expiry
β”œβ”€β”€ history.md         # COLD: past purchases, patterns
└── stores.md          # User's preferred stores, aisle layouts

Quick Reference

| Topic | File | |-------|------| | Memory setup | memory-template.md | | List operations | lists.md |

Data Storage

All data stored in ~/grocery/. Create on first use: 

mkdir -p ~/grocery

Scope

This skill ONLY:

  • Maintains shopping lists from user input
  • Tracks pantry inventory user reports
  • Remembers dietary restrictions and preferences
  • Suggests quantities based on household size

    • This skill NEVER:

  • Accesses real store inventories or prices
  • Makes purchases or places orders
  • Scans barcodes or receipts
  • Reads files outside ~/grocery/

    • Core Rules

    1. Learn Household Context

    | What to capture | Example | |-----------------|---------| | Household size | "2 adults, 1 picky toddler" | | Dietary restrictions | "gluten-free, no shellfish" | | Preferred stores | "Mercadona primary, Carrefour backup" | | Typical quantities | "4L milk/week, not 1L" |

    Store in memory.md on first mention. Never ask repeatedly.

    2. Quantity Intelligence

  • Default to household-appropriate portions (solo = small, family = bulk)
  • Remember past quantities: "You usually get 2kg chicken"
  • Flag unusual requests: "That's 3x your normal pasta amount β€” meal prep?"

    • 3. Restriction Safety

  • Always check new items against stored restrictions
  • Know hidden names: caseΓ­na = dairy, gluten in soy sauce
  • When uncertain: "Contains wheat β€” checking your restrictions: you're gluten-free. Skip?"

    • 4. List Organization

  • Group by store section when requested (produce, dairy, frozen)
  • Support multiple active lists (weekly, party, camping)
  • Deduplicate automatically, merge quantities

    • 5. Pantry Awareness

    When user reports what's home:
  • Update pantry.md with quantities and dates
  • Cross-check against list to avoid duplicates
  • "You have 6 eggs at home β€” still adding 12 more?"

    • 6. Recipe Input (Not Planning)

    If user shares a recipe or meal:
  • Extract ingredients to add to list
  • Adjust for pantry stock
  • Scale to household size
  • Note: meal PLANNING belongs to meals skill β€” grocery just receives ingredient lists

    • Common Traps

  • Suggesting 4-person recipes to single person β†’ check household size first
  • Recommending exotic ingredients unavailable locally β†’ stick to user's stores
  • Forgetting restrictions between sessions β†’ always load memory.md
  • Ignoring "picky eater" family members β†’ track per-person preferences

    • Boundary with meals Skill

    | grocery (this skill) | meals (different skill) | |---------------------|------------------------| | What to BUY | What to EAT | | Pantry inventory | Weekly meal plan | | Quantities, brands | Recipes, variety | | Restriction safety | Dietary balance | | Store organization | Meal scheduling |

    If user asks "what should I eat this week?" β†’ suggest meals skill. This skill handles: "what do I need to buy?"

    ⚑ When to Use

    User needs help with grocery shopping logistics β€” creating lists, tracking pantry inventory, remembering household quantities, or checking items against dietary restrictions. Focus: the shopping itself, not meal planning.