Same commands, options, outputs, reading rules and method steps; the method points to the sections instead of repeating them. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tools
The reading harness: the methods given to the agent to make sense of the data of an AIMsight station. Each tool answers a question the analyst asks and returns values, dated ranges, a figure or thumbnails; it shows, it does not judge.
scripts/: the tools, one script each;GUIDE.md: which tool for which question, and how to read what it returns. The agent reads it first.DATA.md: the files of a station and the meaning of their columns, maintained by hand; the agent reads it with the guide.scripts/data.py: the common reader of the data (also that of the aimsight-app app, which passes these measurements to the detectors); the detectors keep their own (detectors/scripts/data.py), to stay autonomous: a reading fix in one is carried to the other.- The tools:
inventory,summary,ranges,days,overview,metrics,quality,stations,plot,thumbnails,gif(details in the guide).
Using it
The calling repository points to it through a link tools -> ~/aimsight-tools (ignored by git), next to its data/ and labeling/ links, and runs the tools from its root:
python3 tools/scripts/inventory.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z
.venv/bin/python tools/scripts/plot.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z --out out/diagnostic
Without --out, the figures go to out/diagnostic/ of the current folder. Standard library; matplotlib (through the caller's .venv) for the figures only.
Who changes it
Only the upgrader (agents repository) writes there, run by Optimizer's optimize skill after an analysis: it brings the analyst's useful scripts into the tools, it optimizes or adds, it removes nothing.
Copied from aimsight-app (agent-tools/ and the lire-les-donnees skill, commit dd6f1bf) on 2026-11-16. The architecture of the repositories: ~/aimsight-app/docs/architecture.drawio.