Create interactive OCaml tutorials with executable MDX blocks in .mld documents.
npx skills add https://github.com/aresbit/MateBot --skill ocaml-tutorials
Please help me install this Agent Skill. Skill: ocaml-tutorials Source: https://github.com/aresbit/MateBot/tree/main/skills/ocaml/ocaml-tutorials Command: npx skills add https://github.com/aresbit/MateBot --skill ocaml-tutorials
OCaml library developers and educators often need structured, interactive tutorials to teach usage and patterns. This skill provides a clear, MDX-backed workflow to author executable .mld tutorials, blending narrative with verifiable OCaml blocks.
Create a doc/ directory containing tutorial.mld and index.mld, configure dune-project to enable MDX (mdx 0.4), and run dune build @doc to render the tutorial.
High-intent search queries and answers about installing and using this skill.
MDX-enabled .mld documents blend narrative text with verifiable OCaml code blocks. They allow developers to structure educational documentation that is automatically checked for accuracy during the build process, ensuring reproducible results for library learners.
To build .mld tutorials, create a doc/ directory containing tutorial.mld and index.mld files. Configure dune-project to enable MDX support, then execute dune build @doc to render the documentation and verify executable blocks.
Yes, Dune is required to verify executable blocks in OCaml documentation. The workflow relies on Dune build pipelines to process the .mld files and validate OCaml code snippets during the @doc build target execution.
Yes, you can use MDX to teach advanced OCaml library usage patterns by structuring .mld tutorials that progress from basic setup to complex examples. Cross-references and executable blocks ensure learners see reproducible results, guiding them through advanced library implementations.
Using .mld files for OCaml documentation requires MDX support and specific OCaml tooling. Tutorials must adhere to the structured doc/ directory layout, meaning any deviation from the required dune configuration will prevent executable blocks from being verified.
avsmAutomate creation of interactive OCaml tutorials from .mld sources with MDX.
avsmPublish OCaml libraries to npm for browser targets using js_of_ocaml and wasm_of_ocaml.
avsmFix odoc reference syntax and disambiguation errors in OCaml documentation.
aresbitFetch RFC texts from the IETF datatracker and store them under spec/.
