govalidate-lite

Local CSV and Excel checks for coding agents. npx installs the data-validation-rules skill. Files stay on your machine. See https://govalidate.ai/skill/.

Requirements

| | Needed for | If missing | |--|-----------|-----------| | Node 20 or newer | running the installer | nothing installs | | Python 3.8 or newer, as python3 on PATH | the bin/dq_*.py helpers | the skill still installs and its checklist still works; the helpers fail |

The installer checks for python3 and says so in its report when it is absent. A missing Python does not stop the install: the checklist and doctrine are the part your agent reads, and they need nothing but the file.

Install

npx govalidate-lite

That is the whole path. There is no install subcommand. With no options the tool:

1. Detects which agent skill directories exist under the current working directory
2. If none exist, creates .claude/skills
3. Writes the skill, its doctrine reference, and five executable helpers
4. Prints one line naming what was installed, where, and what to do next

A second run reports that the installation is already current and does not rewrite files.

Options

npx govalidate-lite --check                 # report; write nothing
npx govalidate-lite --json                  # machine-readable result
npx govalidate-lite --target=/path/to/repo  # install into another directory
npx govalidate-lite --roots=claude,codex    # explicit root subset

--roots accepts: claude, codex, cursor, github, agents.

What lands on disk

Under each selected root, as data-validation-rules/:

| Path | Role | |------|------| | SKILL.md | Agent skill (always-on checklist + load scorecard) | | references/doctrine-full.md | Full judgement (repair, reconcile, privacy, evidence) | | bin/dq_*.py | Optional stdlib-only helpers (mode 0755) |

Helpers (from the skill directory, and they need python3):

python3 bin/dq_scorecard.py data.csv --json
python3 bin/dq_rows.py data.csv
python3 bin/dq_blanks.py data.csv
python3 bin/dq_grain.py data.csv
python3 bin/dq_rates.py data.csv

Licence

Apache-2.0. See LICENSE.