ideal-postcodes

Use this skill whenever the user wants address autocomplete, address suggestions as the user types, address validation in a form, UK address lookup, or any form field that should be auto-populated from a selected address — even if they don't name the package. Specifically covers `@ideal-postcodes/address-finder`. Includes npm and CDN install, initialisation via `AddressFinder.setup` / `AddressFinder.watch` (React), callbacks, CSS, country filter/bias, and common gotchas (API key allowed-URLs, bundled vs source build, CSS import).

Use when integrating the Ideal Postcodes API directly via HTTP. Covers authentication (header + query forms), the core lookup endpoints (postcodes, autocomplete, places, cleanse), key/licensee/config admin, data models (PafAddress, MrAddress, AddressSuggestion, etc.), error codes, rate limits, and common gotchas around CORS and allowed URLs.

Drive api.ideal-postcodes.co.uk from the terminal — manage API keys (balance, usage, allowed-URL configs, lookup logs), cleanse messy addresses, validate email addresses and phone numbers, and resolve specific addresses from partial queries via the `idpc` CLI. Use when the user wants to inspect or update an Ideal Postcodes account, cleanse addresses in bulk, validate emails or phone numbers, or pin down a specific address from a partial query. Always load this skill before running `idpc` — it defines the non-interactive flag contract and output shape that keep agent runs deterministic.

Use this skill whenever the user wants UK postcode lookup, postcode search, "find addresses by postcode", a postcode-to-address dropdown, or any UK address form where the user enters a postcode and picks an address — even if they don't name the package. Specifically covers `@ideal-postcodes/postcode-lookup`. Includes npm and CDN install, initialisation via `PostcodeLookup.setup`, lifecycle callbacks, CSS customisation, full-text address search, custom UI elements, and common gotchas (the required `context` parameter, API key allowed-URLs, bundled vs source build).

Use this skill whenever the user wants address autocomplete in a React or Next.js application, address suggestions as the user types in a React form, React address validation, UK address lookup in JSX, or any React component that should auto-populate fields from a selected address — even if they don't name the package. Covers `@ideal-postcodes/react`: install, the `<AddressFinder>` component (default and wrap-around-your-own-input modes), callbacks, CSS, country filter/bias, and the React-specific gotchas (`"use client"` for Next.js App Router, CSS import path, callbacks always see latest closure). For the underlying vanilla JS library, see the sibling `address-finder` skill — the option surface is identical except for DOM-coupled options.