studio-seventeen
WORKSHOP--:--
~/workshop/skills/modbus/build-modscan.md

$build-modscan

SKILL 17 / 20READ-ONLYBETA

Build ModScan (BETA)

Create BETA documented setup and CSV files for a read-only ModScan test.

WHAT YOU GET

A clear result you can inspect

The BETA ModScan folder contains `read-plan.csv`, `point-map.csv`, test messages, and setup instructions for ModScan32 or ModScan64. It can also include `pymodbus-read-once.py` for one reviewed read when ModScan is unavailable. Native application verification has not been run.

HOW IT RUNS

Builds files for the ModScan version you use

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

Builds files for the ModScan version you use. The script uses the checked map and matching read plan to create probe or final output. It checks the setup and CSV files. It reports native verification as unavailable unless the files were loaded in the named ModScan application.

FILES AND REQUIREMENTS

Know what the skill creates and what you must install

The plugin includes the skill instructions and generator source. It does not install Python, field tools, or their packages.

OUTPUTFiles this skill creates
Enter in ModScanmodscan/read-plan.csv · modscan/test-message-plan.csv

The bounded read blocks and optional protocol test messages.

Use as a referencemodscan/point-map.csv · modscan/README.md

The register names, meanings, and manual setup instructions.

Keep with the planmodscan/setup-manifest.json · modscan/manifest.json · modscan-result.json

The source hashes, selected target, generated status, and holds.

Optional fallbackmodscan/pymodbus-read-once.py

Runs one reviewed FC01–FC04 request when ModScan is not available.

DEPENDENCIESInstalled separately
Plugin filesincluded

SKILL.md, the Python wrapper, generator source, and optional one-read fallback source.

Python 3.11+install separately

Required to generate the files. Plugin installation does not install Python.

ModScan32 or ModScan64install separately

Required to use the plan in the native Windows application. The CSV files are instructions, not native .tst or .cfg projects.

PyModbusinstall separately

Required only if you use pymodbus-read-once.py instead of ModScan.

Direct repository use: Run python3 -m pip install -e . from the cloned repository. Plugin installation does not run this command.

WHERE IT FITS

Use it for one specialist stage

This skill supports one focused stage. Start it directly only when that stage is the result you need.

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

Create a read-only ModScan64 setup from `reviewed-map.json` and `read-plan.json`. Include the connection settings, poll blocks, point map, and protocol test messages.
GitHub source ↗