{ "schemaVersion": "1.0", "item": { "slug": "shopping-list", "name": "Shopping List", "source": "tencent", "type": "skill", "category": "内容创作", "sourceUrl": "https://clawhub.ai/ajeenkya/shopping-list", "canonicalUrl": "https://clawhub.ai/ajeenkya/shopping-list", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/shopping-list", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shopping-list", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "_meta.json", "data/active.json", "data/config.json", "data/history-2026-02.json", "references/commands.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/shopping-list" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/shopping-list", "agentPageUrl": "https://openagent3.xyz/skills/shopping-list/agent", "manifestUrl": "https://openagent3.xyz/skills/shopping-list/agent.json", "briefUrl": "https://openagent3.xyz/skills/shopping-list/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Shopping List", "body": "Manage the household shopping list. Add items with quantities, check them off,\norganize by category. Data lives in skills/shopping-list/data/.\n\nFor full command reference and output formats, read skills/shopping-list/references/commands.md." }, { "title": "Before Every Command", "body": "Run these checks before every shopping list operation, in order:\n\nIf skills/shopping-list/data/ directory does not exist, create it.\nIf data/active.json does not exist, create it with:\n{\n \"items\": [],\n \"categories\": [\"Produce\", \"Dairy\", \"Meat\", \"Pantry\", \"Frozen\", \"Beverages\", \"Household\", \"Personal\"],\n \"lastModified\": \"\"\n}\n\n\nIf data/active.json exists but fails to parse as valid JSON, rename it to data/active.json.corrupt and create a fresh default file. Tell the user: \"Shopping list data was corrupted. Saved backup as active.json.corrupt and started a fresh list.\"\nIf data/config.json does not exist, create it with: { \"user\": null, \"snoozes\": {} }\nIf config.json has \"user\": null, ask the user: \"What's your name? I'll use it to track who added each item.\" Store their answer (lowercased) in config.json before proceeding with the original command.\nRun the archive process (see Archive section below).\n\nAll file paths in this document are relative to skills/shopping-list/ unless stated otherwise." }, { "title": "data/active.json", "body": "The live shopping list. Contains all items that have not yet been archived.\n\n{\n \"items\": [\n {\n \"id\": \"F47AC10B-58CC-4372-A567-0E02B2C3D479\",\n \"name\": \"Whole Milk\",\n \"normalizedName\": \"whole milk\",\n \"quantity\": 2,\n \"unit\": \"gallons\",\n \"category\": \"Dairy\",\n \"checkedOff\": false,\n \"checkedOffDate\": null,\n \"addedBy\": \"aj\",\n \"addedDate\": \"2026-02-24T10:00:00Z\",\n \"notes\": null\n }\n ],\n \"categories\": [\"Produce\", \"Dairy\", \"Meat\", \"Pantry\", \"Frozen\", \"Beverages\", \"Household\", \"Personal\"],\n \"lastModified\": \"2026-02-24T10:00:00Z\"\n}\n\nField rules:\n\nid -- Generate via uuidgen in bash. If that command is unavailable, construct an ID from the current ISO timestamp concatenated with 4 random hex characters (e.g. 2026-02-24T10:00:00Z-a3f1).\nname -- The item name as the user provided it, with leading/trailing whitespace trimmed. Preserve original casing for display purposes.\nnormalizedName -- Always computed as name.toLowerCase().trim(). Recompute on every add or edit. This field is used for all matching and deduplication logic.\nquantity -- Optional. Defaults to null when the user does not specify a quantity. When present, must be a number greater than 0. Fractional values are fine (e.g. 0.5 for half a pound).\nunit -- Optional free text (e.g. \"gallons\", \"lbs\", \"bunch\", \"bag\"). Defaults to null when not specified.\ncategory -- One of the values from the categories array, or \"Uncategorized\".\ncheckedOff -- Boolean. Starts as false. Set to true when the user checks off the item.\ncheckedOffDate -- ISO timestamp when the item was checked off. null when not checked off.\naddedBy -- Lowercase string from config.json user field (e.g. \"aj\" or \"shal\").\naddedDate -- ISO timestamp when the item was first added.\nnotes -- Optional free text for special instructions (\"the organic one\", \"Costco size\"). Defaults to null.\ncategories (top-level array) -- The master list of known categories. Starts with 8 presets. Custom categories are appended when created.\nlastModified -- ISO timestamp. Updated on every write to this file." }, { "title": "data/config.json", "body": "Stores session-persistent user configuration.\n\n{ \"user\": \"aj\", \"snoozes\": {} }\n\nuser -- Set on first interaction, persists across sessions. Lowercase string.\nsnoozes -- Reserved for Phase 2 restock suggestions. Ignore for now; preserve the field when writing." }, { "title": "data/history-YYYY-MM.json", "body": "Monthly archive of purchased items. One file per calendar month, created on demand.\n\n{\n \"month\": \"2026-02\",\n \"archivedItems\": [\n { \"...same fields as active item...\", \"archivedDate\": \"2026-02-25T08:00:00Z\" }\n ]\n}\n\nThe archivedDate field is added to each item when it moves from active to history. All original fields from the active item are preserved. A new file is created automatically when the first item is archived in a month that does not yet have a history file." }, { "title": "Adding Items", "body": "Parse the user's natural language into name, quantity, and unit for each item.\n\nCategory inference: Silently infer the category from the item name. Common mappings: milk/cheese/yogurt/butter go to Dairy, chicken/beef/fish to Meat, bananas/lettuce/onions to Produce, rice/pasta/flour to Pantry, dish soap/paper towels to Household, shampoo/toothpaste to Personal, beer/wine/juice to Beverages, frozen pizza/ice cream to Frozen. If the mapping is not obvious, assign \"Uncategorized\". Never prompt the user for a category. If the user wants to change it, they can say \"move X to Y category\".\n\nMulti-item input: The user may add several items at once: \"add eggs, bread, and 2 gallons milk\" should produce 3 separate items. Parse commas and \"and\" as item separators. When the parsing is ambiguous (compound item names like \"hot dog buns\" near separators), ask the user rather than guessing wrong.\n\nDuplicate handling: Before creating a new item, check if an item with the same normalizedName already exists in the active list.\n\nIf it exists and is not checked off, update the existing item's quantity (add to it if the user gives a new quantity, or leave unchanged if not). Do not create a duplicate.\nIf it exists and is checked off, uncheck it (set checkedOff: false, checkedOffDate: null) and update the quantity if specified.\n\nNew categories: If the user explicitly specifies a category that is not in the categories array, add it to the array and assign the item to it.\n\nSet addedBy from config.json user value. Set addedDate to the current ISO timestamp. Set checkedOff to false and checkedOffDate to null. Update lastModified after writing." }, { "title": "Checking Off Items", "body": "Match items by normalizedName -- case-insensitive, partial match is acceptable (e.g. \"milk\" matches \"whole milk\" if it is the only milk item).\n\nOne match: Set checkedOff to true and checkedOffDate to the current ISO timestamp. Confirm to the user.\nMultiple matches: List the matching items and ask the user which one to check off.\nNo match: Show the current list so the user can identify the correct item.\n\nChecked-off items remain in active.json and display with strikethrough styling until the archive process moves them to history (after 24 hours)." }, { "title": "Removing Items", "body": "Permanently delete an item from the active list. No archive record, no history entry. This exists for \"I added this by mistake\" corrections.\n\nMatch by normalizedName using the same matching rules as checking off. Confirm removal to the user." }, { "title": "Editing Items", "body": "Match the target item by normalizedName, then update the specified fields. Supported editable fields: name, quantity, unit, category, notes.\n\nIf the name changes, recompute normalizedName. If the category changes to one not in the categories array, add it. Update lastModified after writing." }, { "title": "Changing User", "body": "When the user says \"switch to Shal\", \"I'm AJ\", or similar, update the user field in config.json. All subsequent item additions will use the new user value for addedBy." }, { "title": "Archive Process", "body": "This process runs automatically at the start of every shopping list command, before handling the user's request.\n\nRead data/active.json.\nFind all items where checkedOff is true AND checkedOffDate is more than 24 hours ago.\nIf no items qualify, skip the rest of this process.\nDetermine the current month string (e.g. \"2026-02\"). Read data/history-2026-02.json. If it does not exist, create it with { \"month\": \"2026-02\", \"archivedItems\": [] }.\nAppend each qualifying item to the history file's archivedItems array, adding an archivedDate field set to the current ISO timestamp.\nWrite the history file.\nRemove the archived items from the items array in data/active.json.\nWrite the active file.\n\nWrite order matters: Always write the history file before the active file. If the process is interrupted between the two writes, the worst case is a harmless duplicate in history. Reversing the order risks data loss -- items removed from active but never written to history.\n\nThe shopping clear command triggers this same process immediately for all checked items, bypassing the 24-hour wait." }, { "title": "Displaying the List", "body": "When showing the shopping list, sort categories in this fixed order:\n\nPreset categories in their defined order: Produce, Dairy, Meat, Pantry, Frozen, Beverages, Household, Personal\nCustom categories alphabetically after all presets\n\"Uncategorized\" always appears last\n\nSkip any category that has zero items (considering only unchecked items for this purpose). Within each category, sort items alphabetically by normalizedName. Do not rely on the stored array order in JSON.\n\nChecked-off items appear with strikethrough styling within their category, visually distinct from unchecked items. They remain visible until archived." }, { "title": "History Queries", "body": "When the user asks about past purchases (\"what did we buy last month\", \"purchase history\", \"what did we get in January\"), read the relevant data/history-YYYY-MM.json file(s). Present results grouped by date (most recent first) with item names and quantities. If no history file exists for the requested period, tell the user no purchase history was found for that month.\n\nNote: history reflects the archive date, not the purchase date. An item checked off on Feb 28 but archived on March 1 appears in March's history." } ], "body": "Shopping List\n\nManage the household shopping list. Add items with quantities, check them off, organize by category. Data lives in skills/shopping-list/data/.\n\nFor full command reference and output formats, read skills/shopping-list/references/commands.md.\n\nBefore Every Command\n\nRun these checks before every shopping list operation, in order:\n\nIf skills/shopping-list/data/ directory does not exist, create it.\nIf data/active.json does not exist, create it with:\n{\n \"items\": [],\n \"categories\": [\"Produce\", \"Dairy\", \"Meat\", \"Pantry\", \"Frozen\", \"Beverages\", \"Household\", \"Personal\"],\n \"lastModified\": \"\"\n}\n\nIf data/active.json exists but fails to parse as valid JSON, rename it to data/active.json.corrupt and create a fresh default file. Tell the user: \"Shopping list data was corrupted. Saved backup as active.json.corrupt and started a fresh list.\"\nIf data/config.json does not exist, create it with: { \"user\": null, \"snoozes\": {} }\nIf config.json has \"user\": null, ask the user: \"What's your name? I'll use it to track who added each item.\" Store their answer (lowercased) in config.json before proceeding with the original command.\nRun the archive process (see Archive section below).\n\nAll file paths in this document are relative to skills/shopping-list/ unless stated otherwise.\n\nData Files\ndata/active.json\n\nThe live shopping list. Contains all items that have not yet been archived.\n\n{\n \"items\": [\n {\n \"id\": \"F47AC10B-58CC-4372-A567-0E02B2C3D479\",\n \"name\": \"Whole Milk\",\n \"normalizedName\": \"whole milk\",\n \"quantity\": 2,\n \"unit\": \"gallons\",\n \"category\": \"Dairy\",\n \"checkedOff\": false,\n \"checkedOffDate\": null,\n \"addedBy\": \"aj\",\n \"addedDate\": \"2026-02-24T10:00:00Z\",\n \"notes\": null\n }\n ],\n \"categories\": [\"Produce\", \"Dairy\", \"Meat\", \"Pantry\", \"Frozen\", \"Beverages\", \"Household\", \"Personal\"],\n \"lastModified\": \"2026-02-24T10:00:00Z\"\n}\n\n\nField rules:\n\nid -- Generate via uuidgen in bash. If that command is unavailable, construct an ID from the current ISO timestamp concatenated with 4 random hex characters (e.g. 2026-02-24T10:00:00Z-a3f1).\nname -- The item name as the user provided it, with leading/trailing whitespace trimmed. Preserve original casing for display purposes.\nnormalizedName -- Always computed as name.toLowerCase().trim(). Recompute on every add or edit. This field is used for all matching and deduplication logic.\nquantity -- Optional. Defaults to null when the user does not specify a quantity. When present, must be a number greater than 0. Fractional values are fine (e.g. 0.5 for half a pound).\nunit -- Optional free text (e.g. \"gallons\", \"lbs\", \"bunch\", \"bag\"). Defaults to null when not specified.\ncategory -- One of the values from the categories array, or \"Uncategorized\".\ncheckedOff -- Boolean. Starts as false. Set to true when the user checks off the item.\ncheckedOffDate -- ISO timestamp when the item was checked off. null when not checked off.\naddedBy -- Lowercase string from config.json user field (e.g. \"aj\" or \"shal\").\naddedDate -- ISO timestamp when the item was first added.\nnotes -- Optional free text for special instructions (\"the organic one\", \"Costco size\"). Defaults to null.\ncategories (top-level array) -- The master list of known categories. Starts with 8 presets. Custom categories are appended when created.\nlastModified -- ISO timestamp. Updated on every write to this file.\ndata/config.json\n\nStores session-persistent user configuration.\n\n{ \"user\": \"aj\", \"snoozes\": {} }\n\nuser -- Set on first interaction, persists across sessions. Lowercase string.\nsnoozes -- Reserved for Phase 2 restock suggestions. Ignore for now; preserve the field when writing.\ndata/history-YYYY-MM.json\n\nMonthly archive of purchased items. One file per calendar month, created on demand.\n\n{\n \"month\": \"2026-02\",\n \"archivedItems\": [\n { \"...same fields as active item...\", \"archivedDate\": \"2026-02-25T08:00:00Z\" }\n ]\n}\n\n\nThe archivedDate field is added to each item when it moves from active to history. All original fields from the active item are preserved. A new file is created automatically when the first item is archived in a month that does not yet have a history file.\n\nCore Operations\nAdding Items\n\nParse the user's natural language into name, quantity, and unit for each item.\n\nCategory inference: Silently infer the category from the item name. Common mappings: milk/cheese/yogurt/butter go to Dairy, chicken/beef/fish to Meat, bananas/lettuce/onions to Produce, rice/pasta/flour to Pantry, dish soap/paper towels to Household, shampoo/toothpaste to Personal, beer/wine/juice to Beverages, frozen pizza/ice cream to Frozen. If the mapping is not obvious, assign \"Uncategorized\". Never prompt the user for a category. If the user wants to change it, they can say \"move X to Y category\".\n\nMulti-item input: The user may add several items at once: \"add eggs, bread, and 2 gallons milk\" should produce 3 separate items. Parse commas and \"and\" as item separators. When the parsing is ambiguous (compound item names like \"hot dog buns\" near separators), ask the user rather than guessing wrong.\n\nDuplicate handling: Before creating a new item, check if an item with the same normalizedName already exists in the active list.\n\nIf it exists and is not checked off, update the existing item's quantity (add to it if the user gives a new quantity, or leave unchanged if not). Do not create a duplicate.\nIf it exists and is checked off, uncheck it (set checkedOff: false, checkedOffDate: null) and update the quantity if specified.\n\nNew categories: If the user explicitly specifies a category that is not in the categories array, add it to the array and assign the item to it.\n\nSet addedBy from config.json user value. Set addedDate to the current ISO timestamp. Set checkedOff to false and checkedOffDate to null. Update lastModified after writing.\n\nChecking Off Items\n\nMatch items by normalizedName -- case-insensitive, partial match is acceptable (e.g. \"milk\" matches \"whole milk\" if it is the only milk item).\n\nOne match: Set checkedOff to true and checkedOffDate to the current ISO timestamp. Confirm to the user.\nMultiple matches: List the matching items and ask the user which one to check off.\nNo match: Show the current list so the user can identify the correct item.\n\nChecked-off items remain in active.json and display with strikethrough styling until the archive process moves them to history (after 24 hours).\n\nRemoving Items\n\nPermanently delete an item from the active list. No archive record, no history entry. This exists for \"I added this by mistake\" corrections.\n\nMatch by normalizedName using the same matching rules as checking off. Confirm removal to the user.\n\nEditing Items\n\nMatch the target item by normalizedName, then update the specified fields. Supported editable fields: name, quantity, unit, category, notes.\n\nIf the name changes, recompute normalizedName. If the category changes to one not in the categories array, add it. Update lastModified after writing.\n\nChanging User\n\nWhen the user says \"switch to Shal\", \"I'm AJ\", or similar, update the user field in config.json. All subsequent item additions will use the new user value for addedBy.\n\nArchive Process\n\nThis process runs automatically at the start of every shopping list command, before handling the user's request.\n\nRead data/active.json.\nFind all items where checkedOff is true AND checkedOffDate is more than 24 hours ago.\nIf no items qualify, skip the rest of this process.\nDetermine the current month string (e.g. \"2026-02\"). Read data/history-2026-02.json. If it does not exist, create it with { \"month\": \"2026-02\", \"archivedItems\": [] }.\nAppend each qualifying item to the history file's archivedItems array, adding an archivedDate field set to the current ISO timestamp.\nWrite the history file.\nRemove the archived items from the items array in data/active.json.\nWrite the active file.\n\nWrite order matters: Always write the history file before the active file. If the process is interrupted between the two writes, the worst case is a harmless duplicate in history. Reversing the order risks data loss -- items removed from active but never written to history.\n\nThe shopping clear command triggers this same process immediately for all checked items, bypassing the 24-hour wait.\n\nDisplaying the List\n\nWhen showing the shopping list, sort categories in this fixed order:\n\nPreset categories in their defined order: Produce, Dairy, Meat, Pantry, Frozen, Beverages, Household, Personal\nCustom categories alphabetically after all presets\n\"Uncategorized\" always appears last\n\nSkip any category that has zero items (considering only unchecked items for this purpose). Within each category, sort items alphabetically by normalizedName. Do not rely on the stored array order in JSON.\n\nChecked-off items appear with strikethrough styling within their category, visually distinct from unchecked items. They remain visible until archived.\n\nHistory Queries\n\nWhen the user asks about past purchases (\"what did we buy last month\", \"purchase history\", \"what did we get in January\"), read the relevant data/history-YYYY-MM.json file(s). Present results grouped by date (most recent first) with item names and quantities. If no history file exists for the requested period, tell the user no purchase history was found for that month.\n\nNote: history reflects the archive date, not the purchase date. An item checked off on Feb 28 but archived on March 1 appears in March's history." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ajeenkya/shopping-list", "publisherUrl": "https://clawhub.ai/ajeenkya/shopping-list", "owner": "ajeenkya", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/shopping-list", "downloadUrl": "https://openagent3.xyz/downloads/shopping-list", "agentUrl": "https://openagent3.xyz/skills/shopping-list/agent", "manifestUrl": "https://openagent3.xyz/skills/shopping-list/agent.json", "briefUrl": "https://openagent3.xyz/skills/shopping-list/agent.md" } }