How do I install the Grocery API skill?

Run npx skillmds@latest add tomevault-io/grocery-api in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Grocery API safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Grocery API?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Grocery API free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Grocery API?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Grocery API by tomevault-io — Agent Skill

Name: Grocery API
Author: tomevault-io

File contents

Grocery API Skill

Use this skill when the user asks about Sainsbury's groceries, favourites, searching products, adding/updating/removing basket items, or viewing the basket.

The local API must already be running on port 7876:

GROC_API_PORT=7876 npm run api

Commands

Run from the repo root:

node skills/api/wrapper.js fav-search "milk"
node skills/api/wrapper.js search "milk"
node skills/api/wrapper.js favourites
node skills/api/wrapper.js basket
node skills/api/wrapper.js add <product-id> [qty]
node skills/api/wrapper.js remove <item-id>
node skills/api/wrapper.js update <item-id> <qty>

All commands return JSON from the local API.

Add-to-basket workflow

When the user asks to add an item to the basket:

First search favourites:

node skills/api/wrapper.js fav-search "USER ITEM"

If there is a clear favourite result that matches the user's intent, add it directly:
```
node skills/api/wrapper.js add <product-id> [qty]
```
If there are multiple plausible favourite results, ask the user which one to add. Include names, prices, and product IDs.
If there are no good favourite matches, or if the user explicitly asks to look outside favourites, use regular search:
```
node skills/api/wrapper.js search "USER ITEM"
```
For regular search results, always confirm with the user before adding anything to the basket.
After adding, show or summarize the basket:
```
node skills/api/wrapper.js basket
```

Remove/update workflow

When the user asks to remove or update an item:

First inspect the basket to get basket item IDs:
```
node skills/api/wrapper.js basket
```

Use the basket item_id, not the product ID:

node skills/api/wrapper.js remove <item-id>
node skills/api/wrapper.js update <item-id> <qty>

If the item to change is ambiguous, ask the user which basket item they mean.
After removing or updating, show or summarize the basket.

Notes

Prefer favourites over regular search for add requests.
Do not add ambiguous items without asking.
Do not use regular search additions without confirmation.
Use the product_uid as the product ID for add.
Use the basket item_id for remove and update.

Source: abracadabra50/uk-grocery-cli — distributed by TomeVault.

---name: grocery-apidescription: Use the local groc HTTP API to search Sainsbury's groceries, search favourites, add/update/remove basket items, and view basket. Use when this capability is needed.---# Grocery API SkillUse this skill when the user asks about Sainsbury's groceries, favourites, searching products, adding/updating/removing basket items, or viewing the basket.The local API must already be running on port `7876`:```bashGROC_API_PORT=7876 npm run api```## CommandsRun from the repo root:```bashnode skills/api/wrapper.js fav-search "milk"node skills/api/wrapper.js search "milk"node skills/api/wrapper.js favouritesnode skills/api/wrapper.js basketnode skills/api/wrapper.js add <product-id> [qty]node skills/api/wrapper.js remove <item-id>node skills/api/wrapper.js update <item-id> <qty>```All commands return JSON from the local API.## Add-to-basket workflowWhen the user asks to add an item to the basket:1. First search favourites: ```bash node skills/api/wrapper.js fav-search "USER ITEM" ```2. If there is a clear favourite result that matches the user's intent, add it directly: ```bash node skills/api/wrapper.js add <product-id> [qty] ```3. If there are multiple plausible favourite results, ask the user which one to add. Include names, prices, and product IDs.4. If there are no good favourite matches, or if the user explicitly asks to look outside favourites, use regular search: ```bash node skills/api/wrapper.js search "USER ITEM" ```5. For regular search results, always confirm with the user before adding anything to the basket.6. After adding, show or summarize the basket: ```bash node skills/api/wrapper.js basket ```## Remove/update workflowWhen the user asks to remove or update an item:1. First inspect the basket to get basket item IDs: ```bash node skills/api/wrapper.js basket ```2. Use the basket `item_id`, not the product ID: ```bash node skills/api/wrapper.js remove <item-id> node skills/api/wrapper.js update <item-id> <qty> ```3. If the item to change is ambiguous, ask the user which basket item they mean.4. After removing or updating, show or summarize the basket.## Notes- Prefer favourites over regular search for add requests.- Do not add ambiguous items without asking.- Do not use regular search additions without confirmation.- Use the `product_uid` as the product ID for `add`.- Use the basket `item_id` for `remove` and `update`.---> Source: [abracadabra50/uk-grocery-cli](https://github.com/abracadabra50/uk-grocery-cli) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions

Grocery API