# Remap Addresses

> Preview and apply a known map-wide conversion between Modbus offsets and Modicon reference notation. Use when the user asks to convert 40001-style references, protocol offsets, or another known address convention across a map.

- Skill: `studioxvii/remap-addresses` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add studioxvii/remap-addresses`
- Raw SKILL.md: https://api.skillmd.com/api/skills/studioxvii/remap-addresses/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: studioxvii (https://skillmd.com/u/studioxvii)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/studioxvii/remap-addresses

---


# Remap Addresses

Preview a known conversion before applying it.

Follow `../../references/interaction-contract.md`.

## Process

1. Require the source and target conventions.
2. Require an explicit register area when notation does not prove it.
3. Run `python3 <skill-dir>/scripts/run.py --input <map.json> --from <convention> --to <convention> --output <preview.json>`.
4. Validate offsets, source/canonical agreement, and collisions across the whole map.
   A conflicting source token must not silently replace a canonical offset.
5. When the requested conventions are explicit and the preview is collision-free,
   apply the conversion without another confirmation. Ask once only for ambiguity or
   a lossy/colliding result.

## Output files

- `preview.json` / converted map - Review every old and new address, then use the applied map when the conversion is collision-free. The input map remains unchanged.

Completion requires a collision-free, hash-bound converted map before linting.

## Stop

- Stop when source or target convention is unknown.
- Stop when register area is not proven by notation.
- Stop on collision or lossy conversion, or when a write is requested.

## Handoff

- The converted map needs validation: suggest `check-map`.
- Source conventions remain mixed or unknown: suggest `normalize-map`.

Keep the raw source token. Protocol offset zero is valid; offsets above 65535 are not.