What is the benefit of using MDX for OCaml tutorials?

MDX allows you to write executable code blocks within your documentation. When you build your project, MDX runs these blocks and verifies that the output matches what is written, ensuring your tutorials never become outdated.

Does this skill handle Dune configuration?

Yes, the skill provides the specific Dune stanzas required to enable MDX processing and documentation generation for your project's .mld files.

What file format does this skill use for documentation?

It primarily uses the .mld (OCaml documentation) format, which is the standard for generating HTML documentation via odoc.

How do I verify the syntax of my generated tutorials?

You can use 'dune build @check' to verify syntax and 'dune build @doc' to generate the final HTML documentation locally.

OCaml Tutorial Creator

Name: OCaml Tutorial Creator
Author: avsm

byavsm

•

Learning & Documentation

Generates interactive OCaml library tutorials using the .mld documentation format and MDX for executable, verified code examples.

The OCaml Tutorial Creator skill streamlines the process of building high-quality documentation for OCaml projects. By leveraging the .mld format and MDX integration, it allows developers to create tutorials where code examples are not just static text, but executable snippets verified at build time. This skill provides structural guidance for pedagogical content, automates the necessary Dune configuration, and ensures that documentation remains accurate and synchronized with the underlying library code.

Key Features

01Generates structured .mld documentation files with standard OCaml formatting

0213 GitHub stars

03Provides pedagogical patterns for progressing from basic setup to advanced usage

04Integrates MDX for executable code blocks that verify output during builds

05Supports complex cross-referencing for OCaml types, modules, and functions

06Automates Dune configuration for documentation and MDX dependencies

Use Cases

01Building interactive 'Getting Started' guides for new OCaml libraries

02Creating structured educational content for OCaml development workshops

03Ensuring technical documentation remains accurate by testing code snippets against the latest source

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add avsm/ocaml-claude-marketplace ocaml-tutorials

For use in Claude.ai and ChatGPT

Download Skill