riot

Prepare, validate, version, and publish Riot releases from this repository, including OCaml toolchains, Riot CLI binaries, and workspace packages. Use when asked to cut a new Riot release, bump Riot/package or toolchain versions, update CHANGELOG.md, publish packages with `riot publish`, build or publish toolchains with `scripts/toolchain/ocaml.sh`, release binaries with `scripts/release/riot.sh`, create Linux sysroots, or smoke-test Riot binaries in Docker.

Use when changing, reviewing, debugging, testing, deploying, or documenting Riot repo services under `sites/`, including Cloudflare Workers, Wrangler configs, Astro/Starlight sites, pkgs.ml registry/CDN/docs/play flows, Cloudflare D1/R2/Queues/Durable Objects/Workflows bindings, service Bun lockfiles, and service-local TypeScript tests.

Build, configure, run, test, benchmark, format, and troubleshoot projects that use the Riot toolchain. Use when Codex needs to work with `riot.toml`, `.riot/config.toml`, `ocaml-toolchain.toml`, `riot init`, `riot add`, `riot build`, `riot run`, `riot test`, `riot bench`, `riot fmt`, or `riot fix` in a Riot workspace or detached Riot package.

Use when helping users build, test, benchmark, run, and maintain OCaml projects with riot. This skill routes to the best Riot workflow, prefers machine-readable `--json` output, and applies package/dependency conventions.

Use when changing, reviewing, debugging, testing, benchmarking, documenting, or releasing code inside the Riot monorepo. This skill covers repository-specific OCaml/Riot ML conventions, workspace Riot commands, AGENTS.md routing, snapshots, validation, and contributor workflow. Use riot-ml for ordinary projects that consume the riot CLI.