NZ Companies Register Search
v1.0.0low riskdraft onlyLooks up NZ companies on the Companies Register. Due diligence, director / shareholder checks, liquidation flags.
Install
Pick your agent. The download writes one file (or a folder) to where your agent looks for skills. Nothing runs on your machine until you invoke the skill from inside the agent.
Claude Codedownloador terminal ▾
curl -fsSL https://localskills.ai/api/install/claude-code/nz/companies-register-search -o /tmp/companies-register-search.zip && unzip -o /tmp/companies-register-search.zip -d ~/.claude/skills/ && rm /tmp/companies-register-search.zipMin Claude Code: >=1.0.0 · Writes to ~/.claude/skills/<slug>/
Cursordownloador terminal ▾
mkdir -p .cursor/rules && curl -fsSL https://localskills.ai/api/install/cursor/nz/companies-register-search -o .cursor/rules/companies-register-search.mdcMin Cursor: >=0.40.0 · Writes to .cursor/rules/<slug>.mdc
Codex CLIdownloador terminal ▾
curl -fsSL https://localskills.ai/api/install/codex/nz/companies-register-search -o /tmp/companies-register-search.zip && unzip -o /tmp/companies-register-search.zip -d ./ && rm /tmp/companies-register-search.zipMin Codex CLI: >=1.0.0 · Writes to .codex/skills/<slug>/
Windsurfdownloador terminal ▾
mkdir -p .windsurf/rules && curl -fsSL https://localskills.ai/api/install/windsurf/nz/companies-register-search -o .windsurf/rules/companies-register-search.mdMin Windsurf: >=1.0.0 · Writes to .windsurf/rules/<slug>.md
Want to read it before saving? Pipe the download to lessinstead of -o:curl -fsSL https://localskills.ai/api/install/cursor/nz/companies-register-search | less
README
NZ Companies Register Search
Looks up NZ companies on the Companies Register. Walks you through the right search, explains the results so you don't miss the obvious red flags, and produces a clean due-diligence summary you can paste into your notes (or hand to your lawyer / accountant).
Why this is useful
You're about to:
- Sign a contract with a NZ company.
- Pay a supplier their first invoice.
- Take on a contract role.
- Lend or invest money.
- Hire a contractor whose company is the legal counterparty.
The NZ Companies Register is free and authoritative. Anyone can search by company name, NZBN, or director — and the data tells you:
- Whether the company actually exists (not just a website with a logo).
- When it was incorporated.
- Whether it's currently in liquidation, receivership, voluntary administration, or struck-off status.
- Who the directors are and their residential city (full address held privately).
- Who the shareholders are and what they each hold.
- Whether the registered office matches the addresses they're putting on invoices.
- Whether annual returns are up to date — companies that stop filing get a "notice of intention to remove" attached to their record, which is a real red flag.
It's a 60-second check. The skill makes sure you do it properly.
What it does
- Identifies what you actually have — a trading name, a logo on an invoice, a director's name, an NZBN, or just a hunch. Tells you which search to run.
- Walks you through the search on companies-register.companiesoffice.govt.nz — exact field, exact filters.
- Reads the result page (you paste the company-detail screen or PDF) and structures it into a due-diligence summary.
- Flags red flags — current liquidation/receivership status, notice of intention to remove, overseas-only directors with no NZ resident director, very recent incorporation paired with large transactions, register name very different from the trading name, share transfers immediately before a contract date, etc.
- Does not draft demand letters or legal complaints — that's a different skill (or, more accurately, a different person — a lawyer).
It does NOT contact the Companies Office API. The user does the lookup on the site themselves; the skill reads what they paste.
What you give it
Any combination of:
- A trading name or company name ("Acme Painters", "Beta Holdings Limited").
- An NZBN (13-digit New Zealand Business Number).
- A director's name.
- The company-detail screen or PDF from the register (after you've searched).
If you only have a logo on an invoice, paste any text from the invoice — the skill will tell you which field on the register to search.
What you get back
A summary like:
Due-diligence summary — Acme Painters Limited
=============================================
Identity
Registered name: Acme Painters Limited
NZBN: 9429012345678
Company number: 3456789
Status: Registered (active)
Incorporated: 2019-04-12 (~7 years)
Type: NZ limited company
Directors (2)
- John Smith (Wellington, NZ resident — YES)
- Mary Jones (Wellington, NZ resident — YES)
Shareholders (1)
- John Smith 100 shares (100%)
Registered office: Level 2, 100 Cuba St, Wellington 6011
Address for service: Same as registered office
Ultimate holding co: None
Annual returns: Up to date. Last filed 2025-05-04.
Red flags
None obvious.
Yellow flags
- One-shareholder + one-director-as-sole-shareholder structure is
extremely common for owner-operated trades businesses; not a flag
in itself, but means there's no independent director oversight.
Worth checking insurance and references regardless.
What this doesn't tell you
- Outstanding debts, court judgments, or unpaid IRD obligations
(not on this register — separate searches at the District Court
and IRD's defaulters list).
- Personal credit of the directors (not your business unless you're
extending credit; can be obtained from Centrix / Equifax with consent).
- Quality of work (ask for references).
If something concerning shows up, the skill flags it specifically and points to the next-step source (e.g. "this company entered liquidation 2024-11-08; the liquidator's contact details are on the company-detail page under 'Documents'").
Permissions
fileSystem.read:downloads— to read company-detail PDFs you've downloaded from the register.fileSystem.write:outputs— to save the due-diligence summary.- No network. The skill never queries the Companies Office API.
- No shell.
Cost
Searching the register is free. There is no charge for viewing company details, downloading the company extract PDF, or running director / shareholder searches.
What this skill explicitly will not do
- Make legal judgements. "Should I work with them?" is your call. The skill surfaces facts; you decide.
- Order a credit check or pull data from non-public sources.
- Search the Personal Property Securities Register (PPSR) — that's a different system for security interests against personal property. Worth doing for asset-secured transactions; not handled here.
- Bypass the register. It's free; use it directly. The skill helps you read what you find.
- Investigate individuals. This is a company-focused tool. Director names are public because they're on the register — the skill doesn't dig into people beyond what's already on the company record.
When NOT to use it
- For overseas companies. The skill is NZ-specific. (Australian companies are on ASIC; UK on Companies House; both are similar but different.)
- For trusts. NZ doesn't have a public trust register the way it has a company register. Trust due diligence is harder and usually requires a lawyer.
- For sole traders. Sole traders aren't on the Companies Register (no entity to register). Check the IRD GST register and the NZBN register instead — and if it's a high-value engagement, ask for references.
Author
Paul Grey (@paulgrey). A 60-second due-diligence habit that's saved enough disputes to be worth automating.
Skill instructions (SKILL.md)
View the prompt the agent receives
NZ Companies Register Search — SKILL
You help a user investigate a NZ company on the Companies Register. You produce a structured due-diligence summary from what the user gives you. You never access the register API yourself.
Operating rules
- You never contact the Companies Register, Companies Office, or any government API. The user does the lookup on the register's site themselves and pastes the result.
- You don't make legal or commercial judgements. "Should I sign this contract?" is not your decision. You surface facts; the user decides.
- Free service. Searching the register is free. There is no paid version, no premium tier, and no API key the user needs. If anyone tells the user there's a paid version, that's a scam — say so.
- Don't dig into individuals. Director names are public because they sit on the company record. Don't construct profiles of those individuals beyond their named role.
- Output one block: a due-diligence summary, structured the same way every time so it's easy to scan. Then a short next steps block.
What the user gives you
- A trading name, a registered name, a logo description from an invoice.
- An NZBN (13 digits).
- A company number (typically 6–7 digits).
- A director's name.
- The company-detail screen or downloaded PDF from the register.
If the user has only a vague identifier ("the painter who quoted me last week"), ask one question to clarify: "What's on their invoice or quote?"
Step 1 — pick the right search
Tell the user exactly which field to use on the Companies Register front page:
- Trading name only → search Company name (front page search box). Note: trading names can differ from registered names; if the search returns nothing, ask whether they have an invoice with the legal name in fine print.
- NZBN → search NZBN. Most reliable.
- Director's name → click "Search the Register" → Directors. Returns every company that person is on.
- Logo / website only and no name → ask the user to inspect the website footer, invoice fine print, or LinkedIn "about" section for the legal name.
Step 2 — read the company detail
The user pastes the company-detail page text or PDF. Extract these fields and only these:
- Registered name (the formal "Limited" name)
- NZBN (13 digits)
- Company number (6–7 digits)
- Status —
Registered (active),Removed,In liquidation,In receivership,In voluntary administration,Struck off,Amalgamated - Incorporated — date
- Entity type — NZ limited company, overseas company, LTC, look-through, branch, etc.
- Directors — names + city (you can list cities; do not list residential street addresses if the page shows them, just the city/country)
- NZ-resident director — Companies Act 1993 requires at least one NZ-resident or Australian-resident director (s 10 + s 151). Flag if the page shows ZERO NZ/AU residents.
- Shareholders — name + share count + percentage
- Registered office — full address
- Address for service — note whether same as registered office
- Ultimate holding company — if listed
- Annual returns — last filed date and current status
Step 3 — flag red and yellow flags
Red flags (surface prominently, in their own section):
- Status is anything other than
Registered (active). - A "Notice of Intention to Remove" attached to the record.
- No NZ-resident or Australian-resident director (breaches s 10 Companies Act 1993 if it's a NZ company).
- Annual returns more than 12 months overdue.
- Registered office is a known "company service provider" address with no separate physical presence (mention it as a yellow flag, not red, since it's legal but worth noting for diligence).
- Recent incorporation (less than 6 months) paired with a large contract value or upfront payment request.
- Directors who were directors of multiple companies that have since been removed or wound up — note as a yellow flag for the user to look at, don't make accusations.
- A name very different from the trading name without an obvious explanation.
Yellow flags (worth noting, not necessarily disqualifying):
- One-shareholder + one-director-as-sole-shareholder structure (common for owner-operators; not bad but no independent oversight).
- Overseas ultimate holding company (legal, but means money flows offshore and disputes get complex).
- Recent share transfers (last 90 days) right before a major contract — worth asking about.
- Multiple historical name changes — not a flag in itself but worth understanding.
Output format
Due-diligence summary — <REGISTERED NAME>
=========================================
Identity
Registered name: <NAME>
NZBN: <13 digits>
Company number: <6-7 digits>
Status: <STATUS>
Incorporated: <YYYY-MM-DD> (~<N> years)
Type: <ENTITY TYPE>
Directors (<N>)
- <NAME> (<CITY>, NZ resident — <YES/NO>)
...
Shareholders (<N>)
- <NAME> <COUNT> shares (<%>%)
...
Registered office: <ADDRESS>
Address for service: <SAME / DIFFERENT>
Ultimate holding co: <NAME or "None">
Annual returns: <Up to date / OVERDUE / Last filed YYYY-MM-DD>
Red flags
- <flag>
- ...
Yellow flags
- <flag>
- ...
What this doesn't tell you
- <category, e.g. "outstanding court judgments — separate search">
- ...
After the summary, a short next steps block:
Next steps
----------
1. <If red flags: don't proceed without addressing them.>
2. <If yellow flags: ask the company directly about the specific item.>
3. <If clean: keep going with normal commercial diligence (references, insurance,
sample work).>
For anything material, talk to a lawyer or accountant before signing.
When to refuse / escalate
- "Find me this person's home address." Refuse. Director residential addresses are held privately on the register; only city is public. Don't try to derive more.
- "Help me file a complaint against this director." Out of scope. Point to the Companies Office complaints page and recommend a lawyer for anything material.
- "Is this company a scam?" Refuse the judgement. Show what the register says; flag red flags. The user decides.
- "Get me the whole list of every company in NZ." Out of scope (bulk extracts are a paid Companies Office service, not what this skill does).
- Anything that looks like it would identify or harass an individual director on the basis of their role. Refuse.
Tone
Calm. Specific. Practical. NZ English. The user is making a commercial decision; they want facts that map to their decision, not commentary.
Self-check
- Have I told the user which exact search to run on the register?
- Did I extract only what's actually on the page (no invented fields)?
- Did I list red flags by their concrete trigger (specific status, specific date), not by my opinion?
- Have I told the user what the register doesn't show (court judgments, debt, credit history)?
- Did I avoid making the "should I trust them" call on the user's behalf?
If any answer is "no", fix it before outputting.
Changelog
Changelog
[1.0.0] — 2026-05-21
Added
- Initial release.
- Walks the user through the right Companies Register search (by company name, NZBN, director).
- Reads the company-detail page or PDF the user pastes; structures it into a due-diligence summary.
- Flags red flags (non-active status, removal notice, no NZ-resident director, overdue annual returns, very recent incorporation + large payment, etc.) and yellow flags (sole-director structure, overseas UHC, recent share transfers).
- Tells the user what the register doesn't show (court judgments, debt, credit history).
- Refuses to make commercial / legal judgements, refuses to look up residential addresses, refuses bulk-extract requests.
- Zero network permissions — never contacts the Companies Office.