studio-seventeen
WORKSHOP--:--
~/workshop/skills/modbus/compile-user-map.md

$compile-user-map

SKILL 01 / 20READ-ONLY

Compile User Map

Turn an OEM register map and a list of the values you need into an organized user map, JSON, CSV, and optional field-tool files.

WHAT YOU GET

A clear result you can inspect

Give it an OEM PDF, spreadsheet, or register file and name the values you need, such as temperatures, operating status, alarms, or power. The `output` folder contains `user-map.md`, `user-map.json`, and `user-map.csv`. A partial run still keeps useful map files and tells you what must be corrected.

HOW IT RUNS

Finishes only when the requested map is supported by the source

01 · GUIDESKILL.mdprocess + safety
02 · EXECUTEscripts/run.pybundled local Python

Finishes only when the requested map is supported by the source. For a PDF, the skill finds the likely register tables and records which pages and rows it covered. It does not mark the map complete when coverage is unknown, a selected value cannot be traced to the manual, or a selected point still has a blocking problem. It saves the case so you can correct the source or answer one grouped question without starting over.

SYNTHETIC EXAMPLE

See the files before you run the skill

A partial run keeps useful files and marks the items that still need an answer.

output/4 files
├── user-map.mdReadable register map├── user-map.jsonStandard map for the other skills├── user-map.csvFlat list for review or import└── compile-result.jsonCompletion state and open questions

WHERE IT FITS

Used in these workflows

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$compile-user-map
CLAUDE CODE/modbus-skills:compile-user-map
CURSOR + OTHER CLIENTSUse the client’s native skill invocation.
$compile-user-map

I have an OEM register map in `generator-controller.pdf`. Build a user map for temperatures, operating status, active alarms, and power. Give me the readable map plus JSON and CSV files.
GitHub source ↗