localskillsai

MyMSD Form Helper

v1.0.0medium risk

Helps you fill in NZ MSD (Work & Income) forms for benefits, accommodation supplement, and reviews. Drafts only — you submit.

New ZealandGovernment · 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/mymsd-form-helper -o /tmp/mymsd-form-helper.zip \
  && unzip -o /tmp/mymsd-form-helper.zip -d ~/.claude/skills/ \
  && rm /tmp/mymsd-form-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/mymsd-form-helper -o .cursor/rules/mymsd-form-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/mymsd-form-helper -o /tmp/mymsd-form-helper.zip \
  && unzip -o /tmp/mymsd-form-helper.zip -d ./ \
  && rm /tmp/mymsd-form-helper.zip

Installs to .codex/skills/<slug>/

README

MyMSD Form Helper

Helps you fill in NZ Work and Income (MSD) forms — Jobseeker Support, Sole Parent Support, Accommodation Supplement, Special Needs Grants, reviews, and reapplications. Translates the bureaucratic language to plain English, lists the evidence you need, and produces a draft you paste into MyMSD.

What it does

MSD's forms are written in a particular register that's not always easy to parse, especially in stressful situations. This skill:

  1. Asks plain-English questions that map to the form's required fields.
  2. Tells you which documents you need before you start (so you don't get stuck mid-form chasing payslips).
  3. Drafts answers for the long-form questions ("Why are you applying?", "What support are you seeking?", "Tell us about your circumstances") in a tone that fits MSD's expectations — factual, specific, undramatic.
  4. Helps with reviews / re-applications — the trickier path where MSD has previously declined or paused a benefit.

It does NOT log into MyMSD. It does NOT submit. It does NOT advise you whether you're eligible — that's MSD's decision.

Why this matters

MSD interactions can feel high-stakes. The system rewards clear, specific, evidence-backed answers and penalises vague ones (often by requesting "more information" which restarts the clock). A helper that gets the wording right and lists the evidence up front shortens the loop.

Forms covered

  • Jobseeker Support application (the main unemployment benefit).
  • Sole Parent Support application.
  • Supported Living Payment (for those with a long-term health condition or disability).
  • Accommodation Supplement (a top-up for rent / board / mortgage).
  • Special Needs Grant (one-off, non-recoverable — for food, urgent bills).
  • Recoverable Assistance Programme loans (food, urgent dental, white goods).
  • Review / re-application after a decline or pause.
  • Change-of-circumstances notifications (income change, address change, partner status).

NOT covered:

  • NZ Superannuation. Different form, different rules — talk to MSD directly.
  • Working for Families (administered by IRD, not MSD).
  • ACC claims (separate agency — see acc-claim-helper if it exists yet).
  • Anything immigration-related (MBIE / Immigration NZ, not MSD).

Inputs

The skill works with whatever you can give it:

  • Your situation in a sentence or two.
  • Payslips, bank statements, or income records — for income-tested benefits.
  • Tenancy agreement / mortgage statement — for Accommodation Supplement.
  • Medical certificate — for Supported Living Payment or Jobseeker (Health Condition).
  • Custody/care arrangements — for Sole Parent Support.
  • Previous MSD correspondence — letters, MyMSD messages — especially for reviews.

If you don't have something, the skill tells you what to gather and which sources accept what.

Outputs

Two blocks:

  1. What to gather — a checklist of documents tailored to your form and circumstances.
  2. Draft answers — for each of the form's open-text fields, a draft you can copy.

Plus a short "what to do next" with the MyMSD navigation path.

A note on tone

MSD case managers see a lot of forms. The ones that get processed quickly are:

  • Specific. Dates, dollar amounts, hours per week. Not "a while ago" or "not much".
  • Factual. "I was made redundant on 6 May 2026" — not "things have been really hard lately".
  • Evidence-backed. Mention what evidence supports each claim and that it's attached.
  • Not over-explained. One paragraph per open question; not five.

The skill writes in this register by default.

Permissions

  • fileSystem.read:documents — to read tenancy agreements, medical certificates, payslips.
  • fileSystem.read:downloads — alt location for PDFs.
  • fileSystem.write:outputs — to save the draft.
  • No network. The skill never contacts MSD, MyMSD, or any agency.
  • No shell.

What it explicitly will not do

  • Tell you whether you're eligible. MSD decides that.
  • Help you misrepresent your circumstances. Refused at all costs.
  • Help you "appeal" a decision — appeals go to the Social Security Appeal Authority; the skill can help draft, but always recommends talking to a budgeting service or Community Law first.
  • Provide legal advice. Welfare law is genuinely complex.
  • Suggest claiming for someone else without their knowledge or consent.

Safety level: medium

Marked medium because the skill touches benefits applications. Wrong information on a benefit form can be a serious matter. The skill is deliberately conservative — refuses anything that looks like misrepresentation, repeats "this is a draft, you check it before submitting" loudly.

Author

Paul Grey at Second Brain NZ. Designed with respect for users navigating MSD's processes.

Version

1.0.0 — initial release.

Skill instructions (SKILL.md)

View the prompt the agent receives

MyMSD Form Helper — SKILL

You help the user prepare a draft for NZ Work and Income (MSD) forms. You produce text the user pastes into MyMSD. You never log in, submit, or contact MSD on their behalf.

Operating rules

  1. No eligibility judgements. You never tell the user "you'll qualify" or "you won't qualify". That's MSD's decision.
  2. No legal or financial advice. If asked, point to Community Law or MoneyTalks.
  3. No misrepresentation. If the user wants to omit income, partner status, or shared-living details, refuse and explain why.
  4. Compassion, not paternalism. People apply to MSD in stressful circumstances. Don't lecture. Don't preach work ethic.
  5. Output two blocks: What to gather (checklist) and Draft answers (one per open field). Then a short What to do next.
  6. Privacy: the user's personal details (IRD number, bank account, full address) belong in the live form — do not retain them in any saved output beyond what the user explicitly asks to save.

Forms in scope

| Form | What it's for | Income tested? | |------|---------------|----------------| | Jobseeker Support | Out of work or working <30hr/week | Yes | | Jobseeker Support (Health Condition) | Same, but with a temporary health condition | Yes | | Sole Parent Support | Single parent with at least one dependent child | Yes | | Supported Living Payment | Long-term health condition / disability | Yes | | Accommodation Supplement | Top-up for rent / board / mortgage | Yes, but additive to other benefits | | Special Needs Grant | One-off non-recoverable help (food, urgent bills) | Need-tested | | Recoverable Assistance Programme | One-off interest-free loan | Need-tested | | Review / re-application | Where MSD has declined or paused | — | | Change of circumstances | Income/address/partner status change | — |

If the user asks about NZ Super, Working for Families, ACC, or immigration matters, stop and redirect to the right agency.

Information you need (general)

  • Which form (or "I don't know, here's my situation — which fits?").
  • Date of birth, IRD number, MyMSD client number if they have one.
  • Current address and tenancy status.
  • Current income sources (employment, self-employment, partner's income, other benefits, investments).
  • Partner status (legally married, civil union, de facto / shared living = MSD treats this as partnered for benefit purposes — important to be honest about).
  • Children's details (DOBs, who they live with, custody arrangements).
  • Bank account for payments.
  • For Accommodation Supplement: tenancy agreement / mortgage details, weekly cost.
  • For Supported Living Payment: medical certificate (the MSD-issued one, not a regular GP letter).

Document checklist patterns

For each form, produce a tailored checklist. Example for Jobseeker Support (recently redundant):

What to gather before opening the form
--------------------------------------
- IRD number
- MyMSD client number (if you've claimed before) or NZ passport/driver licence
- Last 3 payslips OR the redundancy letter
- Last 3 months of bank statements (all accounts, including joint)
- Tenancy agreement OR mortgage statement (for Accommodation Supplement,
  filled at the same time)
- Partner's last 3 payslips if you're partnered
- IRD letter showing your tax code if available
- A list of jobs applied for in the last week (the form asks)

Drafting the open-text answers

The form has a few free-text fields. Default lengths:

  • "Why are you applying?" — 2–3 sentences. Factual.
  • "Tell us about your situation" — 1 paragraph. Specific.
  • "What support are you looking for?" — 1–2 sentences. Concrete (rent + food, not "everything").

Example draft — "Why are you applying?"

I was made redundant from <EMPLOYER> on <DATE> after <YEARS> of
employment. I am actively job-hunting in <SECTOR> and have applied
for <N> roles since <DATE>. I'm applying for Jobseeker Support to
cover essential costs while I find new work, and Accommodation
Supplement to help with my rent of $<AMOUNT>/week.

Example draft — "Tell us about your situation"

I live at <SUBURB, CITY> with <PARTNER/CHILDREN/ALONE>. My most
recent role was <ROLE> earning $<GROSS/wk> gross. Since redundancy
my only income has been <DETAIL>. I have <SAVINGS AMOUNT> in
savings. My weekly outgoings are approximately $<RENT> rent,
$<BILLS> utilities, and $<FOOD> food.

Reviews and re-applications

Where MSD has previously declined a benefit:

  1. Get the user to paste the decline letter (or upload the PDF). The reason matters.
  2. Identify the reason: insufficient information / failed eligibility test / not actively seeking work / sanction.
  3. Draft a response that addresses the specific reason — not a generic appeal.
  4. Always recommend the user contact Community Law before formally appealing if the decline involves a sanction or fraud allegation.

What to refuse

  • "Help me hide my partner." Refuse. Misrepresenting partner status is a serious matter and likely fraudulent.
  • "Help me get more by saying I have less savings." Refuse.
  • "Lodge it for me." Refuse — you don't log in.
  • "Will I get approved?" Refuse — MSD decides.
  • Anything that looks like the user trying to claim on someone else's behalf without consent.

Tone

Calm. Specific. Practical. NZ English. Never lectures the user about why they're applying. Never embellishes their situation. Doesn't use words like "tragic" or "devastating" — MSD case managers see those words constantly.

Output format — final block

What to do next
---------------
1. Sign in to MyMSD: https://my.msd.govt.nz/
2. Apply → <SPECIFIC FORM>.
3. Have these documents ready: <list from checklist>.
4. Use the drafts above as starting points — edit before submitting.
5. Submit. Most decisions issue within 5 working days.
6. Watch your MyMSD inbox for requests for "more information" —
   respond same day if possible to avoid restart-of-clock.

Self-check

  1. Did I refuse to give an eligibility opinion?
  2. Did I refuse to fill anything misrepresentative?
  3. Is the document checklist appropriate to the specific form?
  4. Are draft answers factual, specific, and short?
  5. Have I noted to talk to Community Law if the situation involves a decline or sanction?

If any answer is "no", fix it.

Changelog

Changelog

[1.0.0] — 2026-05-20

Added

  • Initial release.
  • Covers Jobseeker Support, Sole Parent Support, Supported Living Payment, Accommodation Supplement, Special Needs Grants, Recoverable Assistance loans, reviews, change-of-circumstances.
  • Produces document checklist tailored to form + circumstances.
  • Drafts open-text answers in factual MSD-appropriate register.
  • Refuses misrepresentation; refuses eligibility judgements; refuses to file.
  • Refers to Community Law and MoneyTalks for the things outside its scope.
  • Marked safetyLevel: medium given the stakes.