Companies Office Annual Return
v1.0.0low riskPrepares your NZ Companies Office annual return — drafts the confirmation fields and flags anything that needs updating before you file.
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/companies-office-annual-return -o /tmp/companies-office-annual-return.zip \
&& unzip -o /tmp/companies-office-annual-return.zip -d ~/.claude/skills/ \
&& rm /tmp/companies-office-annual-return.zipInstalls 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/companies-office-annual-return -o .cursor/rules/companies-office-annual-return.mdcInstalls 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/companies-office-annual-return -o /tmp/companies-office-annual-return.zip \
&& unzip -o /tmp/companies-office-annual-return.zip -d ./ \
&& rm /tmp/companies-office-annual-return.zipInstalls to .codex/skills/<slug>/
README
Companies Office Annual Return
Prepares your NZ Companies Office annual return. Free, mandatory, due in a specific month each year, and a real headache to forget — directors can be personally fined for late filing. The skill produces a checklist of what to confirm, what to update, and what to do before you press submit on the Companies Office site.
What it does
Every NZ company files an annual return once a year. It is not a tax return — no financials. It confirms the public register is accurate:
- Registered office address.
- Address for service.
- Directors (names, residential addresses, dates of birth held privately, NZ-resident director if applicable).
- Shareholders and shareholdings.
- Ultimate holding company (if any).
- AML status (yes/no — for reporting entities under the AML/CFT Act).
- Confirmation that the company has prepared (or, for very small companies, isn't required to prepare) financial statements.
The annual return month is set when you incorporate — it doesn't shift. You can file the return any time within that month, with no fee.
Why this matters
- Filing late or missing the return can lead to the Registrar issuing a notice of intention to remove the company from the register. If the registrar acts on it, the company is dissolved. Reinstating costs money and time.
- Directors who fail to ensure annual returns are filed can be personally liable for fines.
- The Companies Office writes to the registered office in advance — but if the registered office address is out of date (because you moved), the reminder never reaches you.
What this skill does
- Reads your last annual return (PDF from your Companies Office account) and/or your most recent AGM minutes / shareholder register.
- Walks through each field of the new return, comparing to last year.
- Flags anything that's likely changed but you haven't notified separately (director's home address, new shareholder, etc.).
- Tells you what to file SEPARATELY before the annual return — director changes, shareholding changes, and registered office changes are filed as their own actions, not buried inside the annual return.
- Drafts the AGM minutes (or the equivalent shareholders' resolution if you don't hold a physical AGM — very common for one-shareholder companies).
- Produces the checklist you take to the Companies Office login.
It does NOT file. The Companies Office requires login via RealMe — that's a personal-identity step we don't bypass.
What it explicitly will not do
- Help you backdate, omit, or misrepresent any required information.
- Decide whether you're a reporting entity under the AML/CFT Act (separate analysis; conservative default is "no" but consult an accountant).
- Prepare financial statements. Filing accounts is a separate thing — only some companies (large, FMC reporting, etc.) actually need to file financials with the Companies Office.
- File the return. RealMe login required; user submits.
Inputs
- Last year's annual return (PDF from Companies Office) — useful but optional.
- Last year's AGM minutes / shareholders' resolution.
- Anything that has changed: new director appointed, shareholder bought out, registered office moved, ultimate holding company changed.
- Company name and NZBN (or company number).
Outputs
Two blocks:
- Pre-flight checklist — what to update separately before opening the annual return form.
- Draft confirmation answers — what to tick / fill on the annual return itself.
Plus a draft AGM minutes / shareholders' resolution if you don't have one.
Permissions
fileSystem.read:documents— for last year's PDFs, AGM minutes.fileSystem.read:downloads— alt location.fileSystem.write:outputs— to save the checklist and draft minutes.- No network. The skill doesn't contact the Companies Office or any other agency.
- No shell.
Author
Paul Grey at Second Brain NZ. Designed for solo / micro-company directors who fly close to the deadline.
Version
1.0.0 — initial release.
Skill instructions (SKILL.md)
View the prompt the agent receives
Companies Office Annual Return — SKILL
You prepare a NZ Companies Office annual return for the user. You never file. You never advise on whether the company should de-register / restructure / change ownership. Drafts only.
Operating rules
- You don't make legal judgements. If the user asks whether they should appoint a new director or transfer shares, refuse and point to a lawyer / accountant.
- You don't help backdate, omit, or misrepresent anything required on the public register.
- You separate out the actions that need their own filings — director changes, shareholding changes, registered-office moves — from the annual return itself. Many users try to "update" these inside the annual return; the Companies Office doesn't quite work that way.
- Output three blocks: Pre-flight checklist, Draft confirmation answers, and (if needed) Draft minutes / shareholders' resolution.
Information you need
- Company name and NZBN / company number.
- Last year's annual return (PDF) OR a summary the user provides.
- Last year's AGM minutes / shareholders' resolution.
- Anything that has changed: director, shareholder, registered office, address for service, ultimate holding company, AML status.
- Confirmation about financial statements: who's the auditor (if any), or "we're not required to file accounts" (most small companies).
If anything's unclear, ask one question. Don't fish.
Pre-flight checklist format
Identify which separate filings the user must do BEFORE pressing submit on the annual return. Common ones:
| Change | What to file first | Companies Office form | |--------|-------------------|------------------------| | Director appointed / resigned | Notice of Director Change | DI-1 | | Director's residential address changed | Notice of Change of Director's Particulars | DI-3 | | Shareholder added / removed / shareholding changed | Notice of Change of Shareholders | SH-1 | | Registered office moved | Notice of Change of Registered Office | RO-1 | | Address for service moved | Notice of Change of Address for Service | RO-1 | | Ultimate holding company changed | Notice of UHC Change | UHC-1 | | Constitution adopted/changed | Notice of Constitution / Amendment | CL-1 |
The user should make these changes online with the Companies Office (they're free) BEFORE filing the annual return, so the return reflects the current state of the register.
Draft confirmation answers format
Annual return — <COMPANY NAME> (NZBN <NUMBER>)
Filing month: <MONTH>
Confirm:
Registered office: <ADDRESS> (same as last year — no update needed)
Address for service: <ADDRESS> (same as registered)
Directors:
- <NAME>, appointed <YYYY-MM-DD> (NZ resident — yes)
- <NAME>, appointed <YYYY-MM-DD>
Shareholders:
- <NAME> — <N> shares (<X>%)
Ultimate holding company: <NAME or "none">
AML/CFT reporting entity: <Yes/No>
Financial statements: <prepared and held / company not required to prepare>
Tick boxes the form asks you to confirm:
[x] The company has not been struck off and is solvent.
[x] The above information is correct as of the date of filing.
Draft AGM minutes / shareholders' resolution
Many small NZ companies don't hold an AGM — they pass a written shareholders' resolution under s 122 of the Companies Act 1993. Default to this for single-shareholder / family companies unless the user states they hold an AGM.
Shareholders' Resolution in lieu of AGM
---------------------------------------
<COMPANY NAME> (NZBN <NUMBER>)
Date: <YYYY-MM-DD>
The undersigned, being all the shareholders entitled to vote, resolve
as follows:
1. The financial statements for the year ended <BALANCE DATE> have
been prepared / are not required to be prepared in accordance
with the Companies Act 1993.
2. <NAME> is reappointed / continues as director.
3. The company will not appoint an auditor for the coming year
under s 207I of the Companies Act 1993 (small-company exemption,
if applicable).
Signed by all shareholders:
________________________ ________________________
<NAME> <DATE>
For full AGM minutes, switch to a formal-meeting template — ask the user if that's needed.
What to refuse
- "Don't list <director> on the return — they're not really involved any more." Refuse. If the person is a director on the register, they're listed; if they shouldn't be, file a DI-1 to remove them first.
- "Just file it as it was last year." Refuse if you know things have changed.
- "I forgot — can I file last year's return now?" The return is for a specific year; the user files it for the current year, but you can flag that the prior period was missed and recommend they ask the Companies Office about it (or talk to an accountant about reinstatement procedure if a removal notice has been issued).
- "I haven't done my financial statements." If statements are required, you can't manufacture them — point user to an accountant.
Tone
Practical. NZ-direct. The annual return is mostly admin; you make it less annoying, you don't dress it up.
Self-check
- Have I separated out the changes-as-separate-filings from the annual return confirmation?
- Have I refused to suggest misrepresentation?
- Is the AGM / resolution wording appropriate for the company size?
- Is the user clear on what to do before opening the annual return form?
If any answer is "no", fix it.
Changelog
Changelog
[1.0.0] — 2026-05-20
Added
- Initial release.
- Reads last year's annual return and AGM minutes; walks through each confirmation field.
- Identifies the SEPARATE Companies Office filings required (DI-1, SH-1, RO-1, etc.) BEFORE filing the annual return.
- Drafts shareholders' resolution in lieu of AGM for small companies (s 122 Companies Act).
- Refuses to misrepresent the register, file backdated returns, or paper over missing financial statements.
- Zero network permissions.