acuris

Acuris agent context

Comprehensive context for AI coding agents to build with the Acuris Address Validation & Geocoding APIs. Distributed in three formats from one source of truth:

• Claude Code plugin — installable via /plugin install, or claude --plugin-dir ./claude-code-plugin.
• Cursor docs/rules — drop-in .cursor/rules/*.mdc plus a public docs site for the @Docs indexer.
• Open Agent Skill — installable via npx skills add on Claude Code, Cursor, GitHub Copilot, Codex, OpenCode, Gemini CLI, Kiro, Goose, and ~30 other tools listed at agentskills.io.

All three teach two skills:

• acuris-address — Address Validation, Geocoding, Reverse Geocoding, Autocomplete. How to wire @acuris-geo/av-sdk and @acuris-geo/centra-checkout correctly, and how to migrate from libAddressDoctor (Informatica), Loqate, Experian QAS, Melissa, or Smarty.
• acuris-eudi — EUDI Wallet Verifier. How to integrate https://eudi.acuris-geo.com as a relying party for OID4VP / SD-JWT VC PID verification with EU 27 trust validation, typically for bank KYC and branch-onboarding flows.

Each skill auto-activates only when the user's task matches its description, so installing both costs almost no context.

Status: 0.2.0. The underlying APIs are stable; this context package follows them. Expect occasional content additions as new recipes, migration vendors, and verifier features land.

Why this exists

When you ask any AI coding agent to "add address validation," you tend to get one of two failure modes: hand-rolled fetch calls that hit the wrong header (Authorization: Bearer … instead of X-Acuris-Key), or correct code calling a fictitious endpoint. This package gives the agent the actual SDK shape, the real headers, the right error types, and a library of pre-vetted recipes so it generates code that compiles and runs.

This pattern was popularized for cloud APIs by Amazon Location's agent-context release in February 2026. We follow their three-format approach (same source-of-truth split with one transformation step per format) and adapt it to Acuris.

What's in here

src/                       Canonical source — edit here, then rebuild.
├── skill/                 SKILL.md + references/ — the actual content.
├── manifests/             Per-format JSON manifest templates.
└── rules/                 Cursor MDC rule sources.

claude-code-plugin/        Generated: Claude Code plugin.
agent-skill/               Generated: open Agent Skill package.
skills/                    Generated alias so `npx skills add` finds the skill.
cursor-docs/               Generated: Cursor rules + flat docs site.
.claude-plugin/            Generated: marketplace.json at repo root.

scripts/build.mjs          One Node script, zero deps, rebuilds all projections.
research.md                Phase-1 research that informed the design.
design.md                  Phase-2 architecture decisions.

Install

Claude Code

/plugin marketplace add Acuris-GmbH/acuris-agent-context
/plugin install acuris-address@acuris-plugins

Or for local development of this package:

git clone https://github.com/Acuris-GmbH/acuris-agent-context
claude --plugin-dir ./acuris-agent-context/claude-code-plugin

Once installed, the acuris-address skill auto-activates when your task mentions address validation, autocomplete, geocoding, or any of the supported migration sources. You can also invoke it explicitly with /acuris-plugins:acuris-address.

Cursor

Three options, mix and match:

1. Drop-in rules (works in any Cursor project):

   git clone https://github.com/Acuris-GmbH/acuris-agent-context
   mkdir -p .cursor/rules
   cp acuris-agent-context/cursor-docs/rules/*.mdc .cursor/rules/
   

   The four rules auto-attach to checkout / address / API-route files and pull themselves in when relevant.

2. @Docs indexer (once GitHub Pages is enabled):

   In Cursor → Settings → Indexing & Docs → @Docs → Add new doc, add https://acuris-gmbh.github.io/acuris-agent-context/.

3. Open Agent Skill (native Cursor support):

   npx skills add Acuris-GmbH/acuris-agent-context -a cursor
   

Any other agent that supports the Agent Skills standard

# Interactive — pick your agent:
npx skills add Acuris-GmbH/acuris-agent-context

# Or specific:
npx skills add Acuris-GmbH/acuris-agent-context -a github-copilot
npx skills add Acuris-GmbH/acuris-agent-context -a opencode
npx skills add Acuris-GmbH/acuris-agent-context -a codex
npx skills add Acuris-GmbH/acuris-agent-context -a gemini-cli
npx skills add Acuris-GmbH/acuris-agent-context -a kiro-cli

The full list of compatible tools is at https://agentskills.io.

Direct context