Skip to content

nddipiazza/robos / .agents/skills/shopping-lists

shopping-lists

Verified

Manage RobOS Household Shopping Lists (Grocery, Target, Costco) via CLI, natural-language text commands, Smart Multi-Store paste syntax, voice commands, and two-way Google Docs / Google Drive mobile sync.

RobOS Shopping Lists Skill

Manage the user's household shopping lists in ~/.config/robos/household/shopping-lists.json across the three pre-seeded store lists:

  1. πŸ₯¬ Grocery (grocery)
  2. 🎯 Target (target)
  3. πŸ“¦ Costco (costco)

No app needs to be open to read, add, check off, adjust quantities, remove items, print checklists, or sync with Google Docs & Google Drive. When the desktop app (packages/shopping-lists) or mobile companion server (:19225) is open, updates broadcast live over Server-Sent Events (/api/events).

Input

$ARGUMENTS β€” Subcommand or natural-language text command:

  • list [grocery|target|costco|all] [--unchecked|--checked] β€” Show items to buy, items in cart, aisle groupings, and estimated totals
  • add "<items>" [--list grocery|target|costco] β€” Add one or multiple items with Smart Multi-Store routing (@grocery, @target, @costco), quantities, units, inline prices ($4.99), notes ((extra firm)), and badges (#urgent, #organic, #kirkland, #deal)
  • check "<item name or id>" [--list ...] β€” Mark an item checked (in cart)
  • uncheck "<item name or id>" [--list ...] β€” Put an item back on the To-Buy list
  • qty "<item name or id>" <+N|-N|N> [--list ...] β€” Step quantity (+1, -1, +2) or set exact quantity (6)
  • remove "<item name or id>" [--list ...] β€” Remove an item from a list (pushes to the Undo stack)
  • clear-checked [--list ...] β€” Clear all checked items in a list
  • check-all [--list ...] / uncheck-all [--list ...] β€” Check or uncheck all items in a list
  • undo β€” Restore the last removed or cleared items
  • sync [--pull] β€” Run two-way Google Docs & Google Drive sync (creates/updates the 3 Google Docs and pulls mobile β˜‘/☐ edits)
  • export-csv [--list grocery|target|costco] β€” Export list items in packages/household CSV format
  • print [grocery|target|costco|all] β€” Output a clean, fridge-ready printable checklist grouped by aisle
  • guide β€” Print the complete Shopping Lists Skills & Text Commands Quick-Reference Guide

Procedure

  1. Run the Shopping Lists CLI (packages/shopping-lists/bin/shopping-lists.js):

    # Show all lists or a single store list
    node packages/shopping-lists/bin/shopping-lists.js list
    node packages/shopping-lists/bin/shopping-lists.js list costco --unchecked
    
    # Add items across Grocery, Target, and Costco in one command
    node packages/shopping-lists/bin/shopping-lists.js add "2 gal organic milk $4.89 (whole), 4 avocados, laundry pods @target, kirkland paper towels @costco"
    
    # Check off, adjust quantity, or remove items
    node packages/shopping-lists/bin/shopping-lists.js check "avocados"
    node packages/shopping-lists/bin/shopping-lists.js qty "avocados" +2
    node packages/shopping-lists/bin/shopping-lists.js remove "laundry pods" --list target
    
    # Clear checked items or undo last deletion
    node packages/shopping-lists/bin/shopping-lists.js clear-checked --list grocery
    node packages/shopping-lists/bin/shopping-lists.js undo
    
    # Two-way Google Docs & Google Drive sync
    node packages/shopping-lists/bin/shopping-lists.js sync --pull
    
    # Print checklist or command cheat sheet
    node packages/shopping-lists/bin/shopping-lists.js print all
    node packages/shopping-lists/bin/shopping-lists.js guide
    

    Add --json for structured JSON output or --spoken for the single-sentence summary that RobOS Voice speaks aloud.

  2. Natural-Language Text Commands: You can also pass any natural sentence directly to the CLI or POST http://127.0.0.1:19225/api/command:

    node packages/shopping-lists/bin/shopping-lists.js "what is on my costco list?" --spoken
    node packages/shopping-lists/bin/shopping-lists.js "add 2 bags of honeycrisp apples to grocery and AA batteries to target"
    node packages/shopping-lists/bin/shopping-lists.js "check off rotisserie chicken on costco"
    
  3. Smart Multi-Store Shorthand Syntax:

    • Store tags: @grocery, @target, @costco, or phrases at target, on costco list, kirkland, bulk
    • Quantities & units: 2 gal, 3 lb, 16 oz, 2 pack, 1 case, 2 bag, 1 box, 1 bunch, 2 bottle, 1 jar, 12 ct
    • Inline price: $4.99 sets the estimated unit price
    • Inline note: (medium ripe) at the end of an item sets its note
    • Badges: #urgent / must (πŸ”₯ Must Have), #organic (🌿 Organic), #kirkland (⭐ Store Brand), #deal / coupon / sale (🏷️ Sale / Coupon)
  4. Google Docs Mobile Text Syntax: When editing the synced Google Docs (Grocery β€” RobOS Shopping List, Target β€” RobOS Shopping List, Costco β€” RobOS Shopping List) in the Google Docs mobile app:

    • Unchecked: ☐ Avocados β€” 4 ea Β· $1.25 or [ ] Avocados β€” 4 ea
    • Checked: β˜‘ Avocados β€” 4 ea Β· $1.25 or [x] Avocados β€” 4 ea
    • Sub-note: ↳ Pick medium-ripe ones

Validation

  • node --test packages/robos-test/tests/shopping-lists/unit.test.js
  • node packages/shopping-lists/bin/shopping-lists.js list --json returns ok: true with grocery, target, and costco lists.
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product β€” it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product β€” not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial β€” a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK β€” model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER β€” read BEFORE opening the target file; don't skip because it "looks like a one-liner" β€” whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) β€” never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named β€” don't Read the file).Stars: 196kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 196kUpdated Claude CodeCodexVerifiedInstall