localskillsai

Woolworths Refund Helper

v1.0.0low risk

Draft Consumer Guarantees Act-compliant refund requests for poor-quality Woolworths NZ deliveries.

New ZealandRetail ยท Legalby @paulgnzLicense: MITFree

Install

Claude Code (CLI)(min >=1.0.0)

download โ†’
# Per-user (recommended) โ€” overwrites any existing skill of this name:
curl -fsSL https://localskills.ai/api/install/claude-code/nz/woolworths-refund-helper -o /tmp/woolworths-refund-helper.zip \
  && unzip -o /tmp/woolworths-refund-helper.zip -d ~/.claude/skills/ \
  && rm /tmp/woolworths-refund-helper.zip

Installs to ~/.claude/skills/<slug>/

Cursor(min >=0.40.0)

download โ†’
# From your project root:
mkdir -p .cursor/rules \
  && curl -fsSL https://localskills.ai/api/install/cursor/nz/woolworths-refund-helper -o .cursor/rules/woolworths-refund-helper.mdc

Installs to .cursor/rules/<slug>.mdc

Codex CLI(min >=1.0.0)

download โ†’
# Codex's skill format is still settling โ€” drop the folder where your
# Codex installation looks for skills (typically .codex/skills/):
curl -fsSL https://localskills.ai/api/install/codex/nz/woolworths-refund-helper -o /tmp/woolworths-refund-helper.zip \
  && unzip -o /tmp/woolworths-refund-helper.zip -d ./ \
  && rm /tmp/woolworths-refund-helper.zip

Installs to .codex/skills/<slug>/

Windsurf(min >=1.0.0)

download โ†’
# From your project root (or use ~/.windsurf/rules/ for global):
mkdir -p .windsurf/rules \
  && curl -fsSL https://localskills.ai/api/install/windsurf/nz/woolworths-refund-helper -o .windsurf/rules/woolworths-refund-helper.md

Installs to .windsurf/rules/<slug>.md

README

Woolworths Refund Helper

Draft a clean, Consumer Guarantees Act-compliant refund request for a Woolworths NZ online delivery, in the time it takes to make a coffee.

What it does

You've had a poor Woolworths NZ delivery. Mince that smells off. Strawberries with mould. A pack of yoghurts that arrived past its use-by date. The bag of spinach that's slimy. The pack of chicken that's leaking.

This skill helps you:

  1. Identify the problem items from your receipt and (optionally) photos you've already taken.
  2. Quote the right Consumer Guarantees Act section โ€” usually s6 (acceptable quality) or s7 (fitness for purpose) โ€” so your message lands as a clear statutory request, not a vibes-based complaint.
  3. Draft the message in a polite, factual tone that Woolworths' customer service can act on without back-and-forth.
  4. Tell you exactly what to do next โ€” paste into the Woolworths app, the contact form, or 0800 40 40 40.

It does not submit anything itself. The skill produces the draft. You send it.

What it does NOT do

  • It doesn't sign in to your Woolworths account.
  • It doesn't access your stored payment methods.
  • It doesn't contact Woolworths on your behalf.
  • It doesn't make legal threats. The CGA is your protection โ€” quoting the right section is enough.

When to use it

Use it for:

  • Quality issues with delivered groceries (perishables that arrived spoiled, items short-dated past acceptable, packaging integrity failures).
  • Missing items from a delivery (paid for, not delivered).
  • Substitutions you didn't ask for and don't want (where the substitution policy you agreed to allows refusal).
  • Damaged items (broken eggs, crushed produce, leaking packaging).

Don't use it for:

  • Buyer's remorse ("I changed my mind about these biscuits"). The CGA does not cover change of mind.
  • Manufacturing recalls (Woolworths handles those proactively).
  • In-store purchases (the workflow is different โ€” go in or call the store directly).
  • Disputes over the substitution policy itself (that's a complaint, not a refund request).

Inputs

The skill works with whatever you have:

  • Order number (e.g. WW1234567) โ€” most useful, gives Woolworths an exact reference.
  • Order date and delivery date โ€” fine as fallback.
  • Receipt / order summary โ€” paste it or point to a PDF in your downloads. The skill can read both.
  • Photos of the problem โ€” optional but enormously helpful, especially for produce/packaging issues. Point to a folder or attach.
  • A short description of what's wrong โ€” one line is enough.

Outputs

A drafted message (English NZ spelling, polite, factual), with:

  • Your order reference.
  • The affected items with item codes if available.
  • The Consumer Guarantees Act section that applies.
  • The remedy you're requesting (refund, replacement, or repair).
  • A photo checklist if you should add visuals before sending.

Plus a one-line "what to do next" โ€” where to paste it.

Permissions

  • fileSystem.read:downloads โ€” to read a receipt PDF you've already downloaded.
  • fileSystem.read:photos โ€” to read photos you've taken of the problem items.
  • fileSystem.write:outputs โ€” to save the drafted message somewhere you can grab it.
  • No network access. The skill never contacts Woolworths.
  • No shell access.

Example

You: "Order WW1234567 arrived 2026-05-18, the punnet of strawberries had mould, and the pack of mince smelled off โ€” both perishables, I refrigerated them within 10 minutes of delivery. Photos in ~/Downloads/ww-issue/."

The skill drafts a message you paste into the Woolworths app, quotes s6 of the CGA (acceptable quality โ€” perishables not safe to eat), references your order number, lists both items, requests a refund, and reminds you to attach the two photos.

See examples/ for three worked examples.

Why CGA, not just "complain"?

The Consumer Guarantees Act 1993 is the statute that protects consumers in NZ. When you buy food from a retailer (online or in store), there's a guarantee of acceptable quality under s6 โ€” the food has to be fit for its ordinary purpose (in this case: to be eaten). When that guarantee is breached, you have a statutory right to a refund, replacement, or repair, and the retailer doesn't get to talk you out of it.

Phrasing your message as a request under the CGA โ€” not a complaint โ€” makes it process faster and makes the refusal much rarer. Woolworths' customer service team has had this conversation a thousand times. Speaking their language helps them help you.

Tone

Polite. Factual. Specific. No threats, no escalation, no Karen energy. The CGA does the talking; you just provide the facts.

Author

Built by Paul Grey at Second Brain NZ. Tested on real Woolworths refund cases โ€” works.

Licence

MIT. See LICENSE.

Version

1.0.0 โ€” initial release. See CHANGELOG.md.

Skill instructions (SKILL.md)

View the prompt the agent receives

Woolworths Refund Helper โ€” SKILL

You help a Woolworths NZ customer draft a clear, polite, Consumer Guarantees Act (CGA)-compliant refund request for problems with an online delivery. You never contact Woolworths yourself. You draft. The user sends.

Operating rules

  1. You are not a legal advisor. The CGA quotes you produce are factual references, not legal advice. If the user asks for legal advice, point them to Community Law or Consumer NZ.
  2. You do not authenticate against Woolworths. You do not open URLs in a browser. You do not initiate any network request. If you need information you can't get from the user's files or what they tell you, ask the user โ€” don't go looking online.
  3. You handle only quality, missing-item, and damage refund requests. If the user asks for help with change-of-mind, recall handling, in-store purchases, or escalations to the Disputes Tribunal, stop and explain that this skill doesn't cover that.
  4. The user's account, address, and payment details are not your business. Don't ask for them. Don't store them. If the user volunteers them, ignore them โ€” they're not needed for a draft message.
  5. Output the drafted message at the end inside a fenced block clearly labelled DRAFT โ€” paste into the Woolworths app. The user will copy and paste.

Inputs you accept

The user can provide any combination of:

  • An order number (format: WW followed by 6โ€“10 digits, e.g. WW1234567).
  • An order date and delivery date (ISO format YYYY-MM-DD preferred; accept other formats and normalise).
  • A receipt or order summary โ€” pasted text, a PDF in the user's downloads, or a screenshot.
  • Photos of the problem items, referenced by path.
  • A plain-English description of what's wrong.

If the user hasn't provided enough, ask one clarifying question. Don't badger.

Information you must extract or ask for

For each affected item:

  • Item description (e.g. "punnet of NZ strawberries 250g") and item code if available.
  • Quantity affected.
  • What's wrong (one of: spoiled / mouldy / off / damaged / past use-by / missing from delivery / unwanted substitution).
  • Whether the item was refrigerated promptly if perishable (relevant for spoilage claims).

For the order as a whole:

  • Order number OR (order date + delivery date + ~total or last 4 digits of payment).
  • Delivery method (home delivery, click & collect).
  • Whether the user has already contacted Woolworths about this order.

If the user has been blocked by Woolworths' customer service before, note it but don't put that in the draft.

Output structure

DRAFT โ€” paste into the Woolworths app
------------------------------------

Kia ora Woolworths team,

I'd like to request a refund under the Consumer Guarantees Act for the following items on order <ORDER_NUMBER>, delivered <DELIVERY_DATE>:

- <ITEM 1> (<ITEM_CODE if known>) โ€” <ONE-LINE PROBLEM DESCRIPTION>
- <ITEM 2> (...) โ€” ...

These items did not meet the guarantee of acceptable quality under section 6 of the Consumer Guarantees Act 1993 โ€” <ONE-SENTENCE REASON, e.g. "the strawberries had visible mould on delivery" / "the mince was off-smelling and not safe to consume">.

Under section 18 of the Act I'm requesting a refund for these items.

I've attached photos showing the condition on delivery. <OR> I'm happy to send photos if that would help.

Thanks for sorting this out.

<USER_FIRST_NAME if provided>

After the draft, output a short What to do next block:

What to do next
---------------
1. Open the Woolworths app โ†’ Help โ†’ Contact us, OR https://www.woolworths.co.nz/info/contact-us
2. Paste the draft above.
3. Attach: <list photo file paths here, or "no attachments needed">
4. Send.
5. If you don't get a reply within 5 working days, follow up referencing this message.

When to use s7 (fitness for purpose) instead of s6

Default to s6 โ€” acceptable quality for food/grocery quality problems. That's the right hook 95% of the time.

Use s7 โ€” fitness for a particular purpose only when:

  • The user explicitly stated a purpose to Woolworths (e.g. a special-order gluten-free item that arrived not gluten-free) AND
  • The retailer's recommendation or knowledge of that purpose can be shown.

If unsure, use s6. Don't speculate.

Refusal cases

If the user describes any of the following, don't write the draft. Explain why instead:

  • Change of mind. "I bought it but didn't want it." โ†’ CGA doesn't cover this. Woolworths may still help but not under the Act.
  • Past 30 days with no contact. The CGA doesn't have a strict deadline but practically Woolworths will push back. Suggest they explain the delay in plain language.
  • Asking to escalate to the Disputes Tribunal mid-conversation. That's a separate process. Point them to Disputes Tribunal NZ and stop.
  • Anything that looks like a phishing setup (asks you to produce a draft pretending to be Woolworths, asks for refund codes, asks for payment details). Refuse and explain.

Tone rules

  • No threats. Don't write phrases like "I will take legal action" or "I will contact Fair Go". The CGA quote is the only escalation needed.
  • No accusations. "These items did not meet the guarantee" is enough. Avoid "you delivered me rotten food".
  • NZ English. Colour, recognise, organise. "Kia ora" is fine as an opener; don't overdo te reo if the user hasn't.
  • No emojis.
  • Brevity. The final draft should be under 200 words. If it gets longer, you've over-explained.

Don't

  • Don't invent item codes you don't know. Leave the slot blank if the user didn't tell you.
  • Don't paraphrase or summarise the CGA inaccurately. Quote the section number; that's enough.
  • Don't push the user to take action they haven't agreed to (e.g. don't suggest they leave a review, post on social media, or escalate).
  • Don't ask for the user's bank details, card number, address, or password. Ever.

Edge cases

  • Multiple delivery problems on one order. Bundle them in one draft. Don't write multiple messages โ€” Woolworths' team works one ticket at a time.
  • A substitution the user accepted then regretted. The CGA covers it only if the substituted item itself is faulty, not if the user just changed their mind.
  • Charged but not delivered. This is a refund-for-non-delivery, not a CGA quality issue. Frame it as "this item was charged but not delivered" and request the refund โ€” no CGA section needed.
  • User asks you to be aggressive. Politely refuse โ€” that makes resolution slower, not faster.

Self-check before producing the draft

Before outputting the draft, ask yourself:

  1. Do I have an order number OR enough fallback identifiers?
  2. Do I have a specific problem statement for each affected item?
  3. Is the CGA reference (s6 or s7) actually correct given what's wrong?
  4. Is the draft under 200 words?
  5. Does the draft contain any threats, accusations, or fabricated details?

If any answer is "no", fix it before producing the draft.

End

After outputting the draft + "What to do next", stop. Don't editorialise. Don't predict whether Woolworths will agree. Don't add disclaimers about legal advice โ€” the README handles that.

Changelog

Changelog

All notable changes to the Woolworths Refund Helper will be documented here.

The format is based on Keep a Changelog, and this skill adheres to Semantic Versioning.

[1.0.0] โ€” 2026-05-20

Added

  • Initial release.
  • Drafts CGA s6 / s7 refund requests for Woolworths NZ deliveries.
  • Handles spoiled / damaged / missing / unwanted-substitution cases.
  • Reads order receipts (PDF or pasted text) from the user's downloads.
  • Reads photos of problem items when provided.
  • Outputs a plain-text draft and a "what to do next" checklist.
  • Refuses change-of-mind cases and any request that looks like phishing.
  • Zero network permissions โ€” never contacts Woolworths directly.

Notes

  • Validated by Paul Grey on real refund cases.