ai-agent

addressing

Name: addressing
Author: commerceguys

A PHP addressing library, powered by CLDR and Google's address data.

970 stars152 forksPHPUpdated 10/9/2026100% free · open source

What it does

Provides PHP classes to validate, normalize, and format international postal addresses using CLDR and Google address data.

When to use it

•You need to display customer shipping addresses in the correct local format on invoices or emails.
•You must validate user‑entered address fields (country, state, postal code) before sending orders to a fulfillment partner.
•Your SaaS product supports multiple countries and you want a single library to handle country‑specific subdivision lists and formatting.

Ready-to-paste prompt

php format_address.php   // runs the script above and prints a correctly‑localized US address

Heads up: The library relies on the PHP intl extension; without it you’ll get runtime errors when formatting addresses. Ensure `ext-intl` is installed and enabled (e.g., `sudo apt-get install php-intl && service php7.4-fpm restart`).

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/addressing && curl -fsSL https://workflowstacks.com/api/skills/addressing/claude-skill -o ~/.claude/skills/addressing/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How addressing works

Codeflow

Free to inspect

Addressing is a medium PHP project (~7k lines across 41 code files, plus 19 test files). Expect some technical setup — comfortable with a terminal, or ask a developer. Last commit a month ago, MIT license, has a test suite.

Size

Medium codebase

~7k lines · 41 code files · 59 min skim

Setup

Some technical setup

Comfortable with a terminal? 20–40 min. Otherwise ask a dev.

Runs on

PHP

No API keys detected

PHP 100%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
composer.json
Dependencies and the commands it exposes
3
src/AbstractEnum.php
Inside src/ — the main logic begins here

What's in each folder

src/Core code — the actual logic39 files

resources/subdivision/Folder546 files

resources/country/Folder148 files

scripts/Helper scripts2 files

tests/Tests — proof it works19 files

.github/CI / automation (GitHub Actions)1 files

READMEHas testsThin docsCI checksMIT licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/addressing && curl -fsSL https://workflowstacks.com/api/skills/addressing/claude-skill -o ~/.claude/skills/addressing/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

commerceguys

Language

PHP