christchurch-bin-schedule
Query Christchurch City Council kerbside collection schedules (rubbish, recycling, organics).
Skill by thecolab-ai
Chalk Labs
Need help deploying christchurch-bin-schedule?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/thecolab-ai-christchurch-bin-schedule
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: productivity
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md and code. Checked Nov 1, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Python package
Network hosts it talks to 3
ccc.govt.nz· found in codecodeload.github.com· found in install commandopendata.ccc.govt.nz· found in code
Files it touches
~/.claude/skills/christchurch-bin-schedule
What's inside
- Skill name
christchurch-bin-schedule- Description
- Query Christchurch City Council kerbside collection schedules (rubbish, recycling, organics). Use when the task involves Christchurch bin days, kerbside collection for a Christchurch address, or CCC three-bin schedules. Supports address search (name → RatingUnitID) or direct RatingUnitID lookup. No account required.
- License
- MIT
- Compatibility
- Requires Python 3.10+ and network access for live data
- Metadata
- thecolab.auth: none · thecolab.pack: nz-public-data · thecolab.risk: low · thecolab.health: healthy · thecolab.writes: false · thecolab.browser: false · thecolab.category: public-data · thecolab.cache_ttl: 24h · thecolab.data_class: public · thecolab.maintainer: @adam91holt · thecolab.skill_type: public-api · thecolab.source_url: https://opendata.ccc.govt.nz/CCCSearch/rest/address/suggest · thecolab.access_mode: public-api · thecolab.source_type: official · thecolab.source_owner: Christchurch City Council · thecolab.last_verified: 2026-07-19 · thecolab.schema_version: 1 · thecolab.allowed_domains: ccc.govt.nz,opendata.ccc.govt.nz
- Instructions
- 76 lines in SKILL.md · view on GitHub
Before installing
- Ships executable scripts
Files (7)
- SKILL.md
- api-notes.md · references/
- source-notes.md · references/
- cli.py · scripts/
- smoke_test.py · scripts/
- test_contract.py · scripts/
- contract.json · tests/fixtures/
SKILL.md (first lines)
# Christchurch Bin Schedule ## Goal Query live Christchurch City Council household kerbside collection schedules through a deterministic CLI with human-readable and JSON output. Christchurch uses a **three-bin system** under the national standardisation: - **Red bin** — Rubbish (fortnightly) - **Yellow bin** — Recycling (fortnightly) - **Green bin** — Organics (weekly, where available) All three bin types are typically collected on the **same day of the week**, though they rotate on different fortnightly schedules. ## Use this when - A user asks when Christchurch bins go out - A user wants the next rubbish, recycling, or organics collection date for a Christchurch address - A workflow needs machine-readable CCC collection schedule data ## Do not use this for - Councils outside Christchurch City / Banks Peninsula (try Auckland, Wellington, or other council skills) - Inner-city bag collections (not supported by this endpoint) - Banks Peninsula community collection points (not individual property-level) - Commercial or private collection schedules - Finding a RatingUnitID without an address — the user must provide either an address or a known RatingUnitID ## Preferred workflow 1. Accept an address string or a known RatingUnitID from the user 2. If an address is given, resolve it to a RatingUnitID via the CCC address suggest API 3. Fetch the collection schedule from the CCC getProperty endpoint 4. Filter to current/future `out_of_date=False` collections 5. Present the regular schedule (day of week) and upcoming collection dates 6. Use `--json` for agent chaining, comparisons, alerts, or structured reports ## CLI Run with: ```bash python3 skills/christchurch-bin-schedule/scripts/cli.py "53 Hereford Street" python3 skills/christchurch-bin-schedule/scripts/cli.py --rating-unit-id 86089 python3 skills/christchurch-bin-schedule/scripts/cli.py "53 Hereford Street" --json ``` ### Arguments - `address` — street address to search, e.g. `"53 Hereford Street"` - `--rating-unit-id` — CCC RatingUnitID (numeric), skips address lookup - `--json` — emit JSON ### Finding your RatingUnitID 1. Visit `https://ccc.govt.nz/services/rubbish-and-recycling/collections/` 2. Search for your address 3. The RatingUnitID can be found by inspecting the network request to `/getProperty?ID=` 4. Alternatively, use this skill with your address and it will resolve the ID automatically ## Resources - CLI entrypoint: `scripts/cli.py` - API and stability notes: `references/api-notes.md` ## Notes - No API key, username, password, or cookie is required - Christchurch uses the national-standard three-bin system (red/yellow/green) - The `getProperty` endpoint is protected by Incapsula bot detection — it works reliably from residential NZ IPs but may block datacenter/VPN IPs with 403 - The address suggest endpoint (opendata.ccc.govt.nz) has no bot protection and works universally - Dates are current Council snapshots, not historical records - Public holidays may shift collection dates — the CLI reflects the current Council data - Treat dates as live current snapshots, not guaranteed future schedules - Organic collections are marked as `Week A` / `Week B` — the `next_planned_date` reflects the actual collection date
From thecolab-ai/.skills, MIT.
Signals
- Stars
- 34
- Forks
- 7
- Open issues
- 10
- Last commit (this folder)
- Jul 19, 2026 (4 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/thecolab-ai/.skills
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get christchurch-bin-schedule running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
christchurch-bin-schedule skill. Agent Mart. https://agentmart.dev/skills/thecolab-ai-christchurch-bin-schedule (last updated 2026-10-24)