{
  "markdown": "# Acuris agent context\n\nComprehensive context for AI coding agents to build with the\n[Acuris](https://acuris-geo.com) Address Validation & Geocoding APIs.\nDistributed in three formats from one source of truth:\n\n- **[Claude Code plugin](./claude-code-plugin/)** — installable via\n  `/plugin install`, or `claude --plugin-dir ./claude-code-plugin`.\n- **[Cursor docs/rules](./cursor-docs/)** — drop-in `.cursor/rules/*.mdc`\n  plus a public docs site for the `@Docs` indexer.\n- **[Open Agent Skill](./agent-skill/)** — installable via\n  `npx skills add` on Claude Code, Cursor, GitHub Copilot, Codex,\n  OpenCode, Gemini CLI, Kiro, Goose, and ~30 other tools listed at\n  [agentskills.io](https://agentskills.io).\n\nAll three teach two skills:\n\n- **`acuris-address`** — Address Validation, Geocoding, Reverse\n  Geocoding, Autocomplete. How to wire `@acuris-geo/av-sdk` and\n  `@acuris-geo/centra-checkout` correctly, and how to migrate from\n  libAddressDoctor (Informatica), Loqate, Experian QAS, Melissa, or\n  Smarty.\n- **`acuris-eudi`** — EUDI Wallet Verifier. How to integrate\n  `https://eudi.acuris-geo.com` as a relying party for OID4VP /\n  SD-JWT VC PID verification with EU 27 trust validation, typically\n  for bank KYC and branch-onboarding flows.\n\nEach skill auto-activates only when the user's task matches its\ndescription, so installing both costs almost no context.\n\n> **Status:** `0.2.0`. The underlying APIs are stable; this context\n> package follows them. Expect occasional content additions as new\n> recipes, migration vendors, and verifier features land.\n\n## Why this exists\n\nWhen you ask any AI coding agent to \"add address validation,\" you tend\nto get one of two failure modes: hand-rolled `fetch` calls that hit\nthe wrong header (`Authorization: Bearer …` instead of `X-Acuris-Key`),\nor correct code calling a fictitious endpoint. This package gives the\nagent the actual SDK shape, the real headers, the right error types,\nand a library of pre-vetted recipes so it generates code that\ncompiles and runs.\n\nThis pattern was popularized for cloud APIs by Amazon Location's\n[agent-context release in February 2026](https://github.com/aws-geospatial/amazon-location-agent-context).\nWe follow their three-format approach (same source-of-truth split with\none transformation step per format) and adapt it to Acuris.\n\n## What's in here\n\n```\nsrc/                       Canonical source — edit here, then rebuild.\n├── skill/                 SKILL.md + references/ — the actual content.\n├── manifests/             Per-format JSON manifest templates.\n└── rules/                 Cursor MDC rule sources.\n\nclaude-code-plugin/        Generated: Claude Code plugin.\nagent-skill/               Generated: open Agent Skill package.\nskills/                    Generated alias so `npx skills add` finds the skill.\ncursor-docs/               Generated: Cursor rules + flat docs site.\n.claude-plugin/            Generated: marketplace.json at repo root.\n\nscripts/build.mjs          One Node script, zero deps, rebuilds all projections.\nresearch.md                Phase-1 research that informed the design.\ndesign.md                  Phase-2 architecture decisions.\n```\n\n## Install\n\n### Claude Code\n\n```text\n/plugin marketplace add Acuris-GmbH/acuris-agent-context\n/plugin install acuris-address@acuris-plugins\n```\n\nOr for local development of this package:\n\n```bash\ngit clone https://github.com/Acuris-GmbH/acuris-agent-context\nclaude --plugin-dir ./acuris-agent-context/claude-code-plugin\n```\n\nOnce installed, the `acuris-address` skill auto-activates when your\ntask mentions address validation, autocomplete, geocoding, or any of\nthe supported migration sources. You can also invoke it explicitly with\n`/acuris-plugins:acuris-address`.\n\n### Cursor\n\nThree options, mix and match:\n\n1. **Drop-in rules** (works in any Cursor project):\n\n   ```bash\n   git clone https://github.com/Acuris-GmbH/acuris-agent-context\n   mkdir -p .cursor/rules\n   cp acuris-agent-context/cursor-docs/rules/*.mdc .cursor/rules/\n   ```\n\n   The four rules auto-attach to checkout / address / API-route files\n   and pull themselves in when relevant.\n\n2. **`@Docs` indexer** (once GitHub Pages is enabled):\n\n   In Cursor → `Settings → Indexing & Docs → @Docs → Add new doc`,\n   add `https://acuris-gmbh.github.io/acuris-agent-context/`.\n\n3. **Open Agent Skill** (native Cursor support):\n\n   ```bash\n   npx skills add Acuris-GmbH/acuris-agent-context -a cursor\n   ```\n\n### Any other agent that supports the Agent Skills standard\n\n```bash\n# Interactive — pick your agent:\nnpx skills add Acuris-GmbH/acuris-agent-context\n\n# Or specific:\nnpx skills add Acuris-GmbH/acuris-agent-context -a github-copilot\nnpx skills add Acuris-GmbH/acuris-agent-context -a opencode\nnpx skills add Acuris-GmbH/acuris-agent-context -a codex\nnpx skills add Acuris-GmbH/acuris-agent-context -a gemini-cli\nnpx skills add Acuris-GmbH/acuris-agent-context -a kiro-cli\n```\n\nThe full list of compatible tools is at <https://agentskills.io>.\n\n### Direct context\n\nIf your agent doesn't speak any of the above protocols, point it at the\ncanonical SKILL.md and the references:\n\n```\nskills/acuris-address/SKILL.md\nskills/acuris-address/references/*.md\n```\n\n## What the skill teaches\n\n- **API surface**: the four endpoints (`POST /validate`, `GET /geocode`,\n  `GET /reverse`, `GET /suggest`), auth via `X-Acuris-Key`, ISO-3\n  lowercase country codes, the typed error hierarchy.\n- **SDK usage**: `AcurisClient` patterns, server-side-only key handling,\n  retry semantics, cancellation via `AbortSignal`.\n- **Implementation recipes**: React autocomplete in checkout flows,\n  validate-on-submit, forward geocoding for shipping, reverse geocoding\n  from coordinates, batch cleanup, Next.js proxy routes, plain Node\n  servers, and the Centra-storefront integration.\n- **Migrations**: vendor-to-Acuris recipes for Informatica\n  AddressDoctor, Loqate, Experian QAS, Melissa, and Smarty.\n\n## Authoring + rebuilding\n\nEdit anything under `src/`. Then:\n\n```bash\nnode scripts/build.mjs           # rebuild all three projections\nnode scripts/build.mjs --check   # CI gate: fail if projections are stale\n```\n\nThe build script is plain Node — no install needed. CI runs `--check`\non every PR; PRs must commit source and projection changes together.\n\nThe design rationale is in [`design.md`](./design.md); the underlying\nresearch on each format's current schema is in\n[`research.md`](./research.md).\n\n## License\n\nMIT © Acuris GmbH. See [LICENSE](./LICENSE).\n",
  "bytes": 6464,
  "sha": "e79f26cc536ee995f601d60b8be04ecab619be34d1f4b177ea96a084f4c4a8f9",
  "repo_slug": "acuris-gmbh/acuris-agent-context",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_acuris_gmbh_acuris_agent_context_acuris_1a65f056/readme"
}