Check Map

Check a normalized map for duplicate points, overlapping registers, missing packed-bit rules, invalid data widths, and unsafe read definitions.

use this skill ↓back to all 20 skills

GROUP 02Review register mapsGitHub source ↗

WHAT YOU GET

A clear result you can inspect

It writes `validation.json`. The report checks for duplicate points, overlapping register ranges, invalid widths, read access, function codes, missing byte order, and missing bit numbering for Boolean values packed in registers. It does not change the map.

HOW IT RUNS

01 · GUIDESKILL.mdprocess + safety

02 · EXECUTEscripts/run.pybundled local Python

Checks the full map without device traffic. The validator reads the normalized JSON map and writes a separate report. A packed Boolean value in an input or holding register stays blocked until the map states its bit-numbering rule. The report groups errors, warnings, and unresolved items by cause. Final file generation stays blocked while one remains.

SYNTHETIC validation.json

See what blocks the next step

The skill reports the problem and the affected point. It does not change the map.

ERRORpoint.overlapping-range

Holding registers 120–121 overlap another point.

HOLDpoint.bit-order-unresolved

A Boolean value packed in a register does not state whether bit 0 starts at the least- or most-significant bit.

ERRORfunction-code.write-forbidden

The map contains a write function code. Read-only file generation stops.

WHERE IT FITS

Used in these workflows

Remap address notationConvert a complete map between protocol offsets and 40001-style register numbers, then check the result.view workflow →Build a declarative custom exportCreate a documented text or CSV export from a reviewed map without running code from the example file.view workflow →Build a multi-target tool packCreate Node-RED, Modpoll (BETA), and ModScan (BETA) files from one validated map and read plan.view workflow →

EXAMPLE REQUEST

Ask for the result in your own words.

Use this example as a starting point. Replace the file names and details with your own.

CODEX$check-map

CLAUDE CODE/modbus-skills:check-map

CURSOR + OTHER CLIENTSUse the client’s native skill invocation.

$check-map

Please check `normalized-map.json` for overlapping registers, duplicate points, invalid data widths, and anything that would make the read plan unsafe.

GitHub source ↗