Acuris Agent Context
Acuris-GmbH/acuris-agent-context
Validação de endereços e geocoding para agentes IA em 3 formatos
Ver no GitHubSkill multiplataforma que ensina agentes de IA a integrar as APIs de validação de endereços e geocoding da Acuris, além de verificação de carteiras EUDI. Disponível como plugin Claude Code, regras Cursor e skill aberto compatível com ~30 ferramentas de agentes.
Instalação
npx convez-ai Acuris-GmbH/acuris-agent-context1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar validação de endereços em aplicações web com Claude Code
- Ensinar agentes IA a chamar APIs Acuris corretamente (headers, SDKs, tipos de erro)
- Implementar fluxos KYC bancários com verificação EUDI Wallet
Veredito

Abordagem inteligente ao problema real de agentes de IA gerarem código incorreto para APIs específicas. Multiformato (plugin, skill, rules) reduz fricção de integração, embora dependa de adoção dos SDKs Acuris.
README
A tradução para o português deste README ainda está na fila.
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, orclaude --plugin-dir ./claude-code-plugin. - Cursor docs/rules — drop-in
.cursor/rules/*.mdcplus a public docs site for the@Docsindexer. - Open Agent Skill — installable via
npx skills addon 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-sdkand@acuris-geo/centra-checkoutcorrectly, and how to migrate from libAddressDoctor (Informatica), Loqate, Experian QAS, Melissa, or Smarty.acuris-eudi— EUDI Wallet Verifier. How to integratehttps://eudi.acuris-geo.comas 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:
-
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.
-
@Docsindexer (once GitHub Pages is enabled):In Cursor →
Settings → Indexing & Docs → @Docs → Add new doc, addhttps://acuris-gmbh.github.io/acuris-agent-context/. -
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
If your agent doesn't speak any of the above protocols, point it at the canonical SKILL.md and the references:
skills/acuris-address/SKILL.md
skills/acuris-address/references/*.md
What the skill teaches
- API surface: the four endpoints (
POST /validate,GET /geocode,GET /reverse,GET /suggest), auth viaX-Acuris-Key, ISO-3 lowercase country codes, the typed error hierarchy. - SDK usage:
AcurisClientpatterns, server-side-only key handling, retry semantics, cancellation viaAbortSignal. - Implementation recipes: React autocomplete in checkout flows, validate-on-submit, forward geocoding for shipping, reverse geocoding from coordinates, batch cleanup, Next.js proxy routes, plain Node servers, and the Centra-storefront integration.
- Migrations: vendor-to-Acuris recipes for Informatica AddressDoctor, Loqate, Experian QAS, Melissa, and Smarty.
Authoring + rebuilding
Edit anything under src/. Then:
node scripts/build.mjs # rebuild all three projections
node scripts/build.mjs --check # CI gate: fail if projections are stale
The build script is plain Node — no install needed. CI runs --check
on every PR; PRs must commit source and projection changes together.
The design rationale is in design.md; the underlying
research on each format's current schema is in
research.md.
License
MIT © Acuris GmbH. See LICENSE.