legislation-nz
/legislation-nz
Resolves, searches, and checks New Zealand Acts, Bills, secondary legislation, sections, point-in-time versions, and update feeds from official legislation.govt.nz and PCO sources. Use when a task needs NZ legislation text, exact section citations, current in-force status, amendments since a date, current Bills, or source caveats.
- Author
- thecolab-ai ↗
- Repository
- .skills ↗
- Licence
- MIT
- Last repository change
- 12.10.2026
Assessment and security
- Files in this package
- 7
- Scripts
- 3
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 12.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 3 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/cli.py, scripts/smoke_test.py, scripts/test_contract.py
What it does and when to use it
Resolves, searches, and checks New Zealand Acts, Bills, secondary legislation, sections, point-in-time versions, and update feeds from official legislation.govt.nz and PCO sources. Use when a task needs NZ legislation text, exact section citations, current in-force status, amendments since a date, current Bills, or source caveats.
Original author description
Resolves, searches, and checks New Zealand Acts, Bills, secondary legislation, sections, point-in-time versions, and update feeds from official legislation.govt.nz and PCO sources. Use when a task needs NZ legislation text, exact section citations, current in-force status, amendments since a date, current Bills, or source caveats.
How it works
- Goal
- Quick triage
- CLI
- Source Behaviour
- Resources
SKILL.md preview
--- name: legislation-nz description: "Resolves, searches, and checks New Zealand Acts, Bills, secondary legislation, sections, point-in-time versions, and update feeds from official legislation.govt.nz and PCO sources. Use when a task needs NZ legislation text, exact section citations, current in-force status, amendments since a date, current Bills, or source caveats." license: MIT compatibility: "Requires Python 3.10+ and network access for live data" metadata: thecolab.category: "government" thecolab.source_owner: "New Zealand Parliamentary Counsel Office" thecolab.source_type: "official" thecolab.auth: "mixed" thecolab.access_mode: "public-api" thecolab.data_class: "public" thecolab.writes: "false" thecolab.browser: "false" thecolab.risk: "medium" thecolab.cache_ttl: "24h" thecolab.schema_version: "1" thecolab.skill_type: "public-api" thecolab.pack: "nz-public-data" thecolab.source_url: "https://www.legislation.govt.nz" thecolab.allowed_domains: "api.legislation.govt.nz,catalogue.data.govt.nz,www.legislation.govt.nz" thecolab.last_verified: "2026-07-19" thecolab.health: "gated" thecolab.maintainer: "@adam91holt" --- # New Zealand Legislation ## Goal Use official New Zealand Legislation sources to resolve legislation records, quote current or point-in-time sections, list versions, inspect current Bills, and check recent publication/update feeds. ## Quick triage Use this when: - A user cites an Act or regulation by year/number and needs exact text - A finding needs a current "as at" section citation from legislation.govt.nz - A workflow needs to check versions or amendments since a date - A user asks for Bills currently before Parliament - A task needs to distinguish keyless web/XML access from the keyed PCO API Do not use this for: - Legal advice or statutory interpretation beyond quoting/checking source text - Non-NZ legislation - Unofficial commentary, case law, or policy guidance ## CLI ```bash python3 skills/legislation-nz/scripts/cli.py search "Grocery Industry" --type act --json python3 skills/legislation-nz/scripts/cli.py get-act 2003/52 --json python3 skills/legislation-nz/scripts/cli.py get-section 2003/52 9C --json python3 skills/legislation-nz/scripts/cli.py get-section 1993/105 "Schedule 7" --json python3 skills/legislation-nz/scripts/cli.py get-section 1993/105 "Schedule 7 clause 1" --json python3 skills/legislation-nz/scripts/cli.py versions 2003/52 --json python3 skills/legislation-nz/scripts/cli.py updates --since 2026-07-01 --json python3 skills/legislation-nz/scripts/cli.py list-bills --json python3 skills/legislation-nz/scripts/cli.py sources --json ``` Commands: - `search QUERY [--type act|bill|regulation|secondary-legislation] [--field title|content] [--source auto|web|api] [--limit N] [--json]` - `get-act ACT_ID [--version YYYY-MM-DD|latest] [--sections-limit N|--all-sections] [--json]` - `get-section ACT_ID SECTION [--version YYYY-MM-DD|latest] [--json]` - `versions ACT_ID [--version YYYY-MM-DD|latest] [--limit N] [--json]` - `updates --since YYYY-MM-DD [--type act|bill|regulation|secondary-legislation] [--limit N] [--json]` - `list-bills [QUERY] [--all-statuses] [--limit N] [--json]` - `sources` or `datasets` for source metadata and caveats `ACT_ID` can be a `year/number` pair such as `2003/52`, a work/version id such as `act_public_2003_52`, or a canonical legislation.govt.nz URL. `SECTION` accepts a body section label (`9C`), a schedule (`Schedule 7`, `sch 7`, `sched 7`), or a clause within a schedule (`Schedule 7 clause 1`, `sch 7 cl 1`). Schedules live in a separate XML tree from body sections, so they must be asked for by name. Bare numeric labels always resolve to the body section first — `get-section 1993/105 7` returns s7 "Control defined", not Schedule 7. Each result carries a `kind` field of `section`, `schedule`, or `schedule-clause`; schedule clauses also carry a `schedule` field. Check `kind` before quoting a result as a section. ## Source Behaviour - `get-act` and `get-section` use keyless official XML format URLs from legislation.govt.nz. - `search`, `versions`, and `list-bills` use keyless official legislation.govt.nz web pages by default. - `updates` uses the official public web-feed generator and parses the returned Atom feed. - `search --source api` uses the PCO developer API and requires `LEGISLATION_NZ_API_KEY` or `PCO_API_KEY`. - Network calls time out after 10 seconds by default. Upstream blocks, bot challenges, missing API keys, and parse failures are surfaced as explicit non-stacktrace errors. ## Resources - CLI: `scripts/cli.py` - Smoke test: `scripts/smoke_test.py` - Source notes and caveats: `references/api-notes.md`
Files in this package (7)
- SKILL.md 5 KB
- references/api-notes.md 3 KB
- references/source-notes.md 1 KB
- scripts/cli.py 38 KB
- scripts/smoke_test.py 7 KB
- scripts/test_contract.py 1 KB
- tests/fixtures/contract.json 1 KB
Versions
The database has no other skills named legislation-nz.
Database snapshot: 13.11.2026 · package version 09466807589a (SHA-256 digest of the entire package)
Downloads in the last 30 days: 2 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100nz-parliament
Track New Zealand Parliament bills and their legislative progress from the public bills.parliament.nz API. Use when the task involves NZ bills, legislation before Parliament, a bill's status or stage (first reading, select committee, etc.), who introduced a bill, government vs… - 100research-recent-amendments-tracker
Use when a user asks whether a statute is current, whether something has recently changed in a jurisdiction, or whether a previously researched answer has been superseded. Checks official gazettes, legislative portals, and regulator notices across MENA (Lebanon Official Gazette,… - 90statute-amendments-trace
Trace the current state of a UK Act including in-force amendments AND any pending bills that would amend it. Use whenever the user asks "is <Act> current", "what's the latest version of <Act>", "have any bills amended this", "what's pending for <Act>", or "what changes are… - 90uk-law
Find and read UK legislation (Acts of Parliament, statutory instruments and regulations, Scottish, Welsh and Northern Ireland law, retained EU law) from the uk-law repository, and answer questions about what the law says with the exact section and a link to the official text.… - 90citation-check
Use when the user gives a text that cites legislation (a brief, contract, memo, judgment, email or article) and wants the citations checked: do they exist, what do they say, were they in force on the relevant date, have they changed since, does a court's reading still hold,… - 100research-statute-lookup
Use when a user needs the current text of a specific statute, article, or regulation — not a summary or paraphrase, but the actual verbatim text with citation, effective date, and authoritative source link. MENA-primary: covers Lebanon (Official Gazette), KSA (Bureau of…