nddipiazza/robos / .agents/skills/shopping-lists
shopping-lists
VerifiedManage 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:
- π₯¬ Grocery (
grocery) - π― Target (
target) - π¦ 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 totalsadd "<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 listqty "<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 listcheck-all [--list ...]/uncheck-all [--list ...]β Check or uncheck all items in a listundoβ Restore the last removed or cleared itemssync [--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 inpackages/householdCSV formatprint [grocery|target|costco|all]β Output a clean, fridge-ready printable checklist grouped by aisleguideβ Print the complete Shopping Lists Skills & Text Commands Quick-Reference Guide
Procedure
-
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 guideAdd
--jsonfor structured JSON output or--spokenfor the single-sentence summary that RobOS Voice speaks aloud. -
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" -
Smart Multi-Store Shorthand Syntax:
- Store tags:
@grocery,@target,@costco, or phrasesat 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.99sets 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)
- Store tags:
-
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.25or[ ] Avocados β 4 ea - Checked:
β Avocados β 4 ea Β· $1.25or[x] Avocados β 4 ea - Sub-note:
β³ Pick medium-ripe ones
- Unchecked:
Validation
node --test packages/robos-test/tests/shopping-lists/unit.test.jsnode packages/shopping-lists/bin/shopping-lists.js list --jsonreturnsok: truewithgrocery,target, andcostcolists.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 467k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |