Hand matra to an agent

on this page
grade9.3density0.50compressionnone

Give an agent matra's own instructions, printed by the version it will run, rather than pointing it at these pages.

grade4.9density0.46compressionnone

If the agent has a shell and nothing installed, give it this line:

uvx 'matra>=0.3' --skill
grade9.5density0.44compressionnone

If matra is already installed, matra --skill prints the same text. It says what matra is for, when to reach for it, every command with its JSON shape, how to read each number and what it does not license the agent to conclude, the limits, and the errors.

grade1.4density0.49compressionnone

Keep the version floor in the uvx line. The skill describes the command line of the version that prints it, and 0.2's spells its commands and its JSON differently from the 0.3 these pages describe. 0.1.0's has no --skill at all.

Give it the deeper references

matra --skill -r          # the references, one per line: name, then summary
matra --skill -r json     # one reference
grade10.4density0.51compressionnone

The text is compiled into the binary and the wheel, so it matches the version that is running, and the test suite executes every command in it against the command line. The CLI reference has the flag's exit codes and its --json shapes.

Load it as a plugin

grade9.1density0.64compressionnone

The same files install as a Claude Code plugin. Run claude --plugin-dir <checkout> over a clone of the repository, and plugin discovery picks up skills/matra/.

Point a reader of this site at llms.txt

grade9.4density0.65compressionnone

An agent reading the documentation instead of running matra starts at llms.txt, served at the site's root: every page with its one-line summary.

This page, measured by matra 0.3.0 with english-ewt-ud-2.5-191206: 7 paragraphs, in the margin. the data