AI Assistants

Use Gribouille with large language models and coding agents through machine-readable documentation and an installable skill.

Large language models write better Gribouille code when they can read the current API instead of guessing it. This site ships two things for that: a machine-readable copy of the whole documentation, and a skill that teaches a coding agent how to author plots.

Machine-readable documentation

Every page on this site has a Markdown companion built for language models, following the llms.txt convention.

• The index lives at llms.txt. It lists every page and links to its Markdown companion.
• Any page’s .html has a sibling .llms.md. For example, the geom-point reference at reference/geoms/geom-point.html is also available at reference/geoms/geom-point.llms.md.

Point an assistant at llms.txt first, then let it fetch the specific .llms.md pages it needs. Because these files are regenerated on every build, they always match the released API.

Skill for coding agents

The skill teaches an agent the grammar-of-graphics model, the #plot() call shape, and a protocol to confirm every argument against the .llms.md reference before writing code. It works with any agent that supports the Agent Skills format.

With npx skills

The agent-neutral skills CLI installs the skill from the repository into the current project.

npx skills add mcanouil/gribouille

Add --global to install it for every project, or -a <agent> to target a specific agent (for example, -a claude-code).

As a Claude Code plugin

The repository doubles as a Claude Code plugin marketplace, so the skill installs through the plugin system.

/plugin marketplace add mcanouil/gribouille
/plugin install gribouille@gribouille

Once installed, ask the assistant to build a plot, for example “a Gribouille scatter of penguin flipper length against body mass, coloured by species”, and it will use the skill to write and validate the code.