Codex

The Ideal Postcodes skills package ships a .codex-plugin/ manifest. One install command covers Codex.

Install

npx skills add ideal-postcodes/skills

Skills installed:

• address-finder — multi-country address autocomplete widget
• postcode-lookup — UK postcode → address dropdown
• api — direct HTTP integration
• idpc-cli — non-interactive CLI for account, key, and address operations

Verify

Ask Codex:

How do I add UK postcode lookup to a checkout form using Ideal Postcodes?

Codex should load the postcode-lookup skill and quote the setup() call rather than guessing.

API key

• Quick test: ak_test (capped at 5 lookups/day, public, breaks in production).
• Real key: sign up for a free trial balance.
• Before deploy: restrict the key via Allowed URLs.

Going deeper

• Skills source: github.com/ideal-postcodes/skills
• Full agent hub: Build with AI
• Full reference as one file: llms.txt

Need help?

• File an issue: github.com/ideal-postcodes/feedback
• Email: support@ideal-postcodes.co.uk