slides-to-notes

Convert MARP slides into Quarto lecture notes with BibTeX citations.

Updated May 10, 2026
One-click install
npx skills add https://github.com/c-kraus/thws-skills --skill slides-to-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slides-to-notes
Source: https://github.com/c-kraus/thws-skills/tree/main/slides-to-notes
Command: npx skills add https://github.com/c-kraus/thws-skills --skill slides-to-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

slides-to-notes converts MARP slide content into a coherent, textbook-style Quarto lecture document, so you can produce a readable companion reader instead of rewriting from scratch.

Core Features & Use Cases

  • Prose expansion: Expands slide bullet points into full, explanatory textbook-style paragraphs.
  • Citation normalization: Converts inline (Author, Year) citations into proper BibTeX citekeys for Quarto rendering.
  • Source resolution: Validates citations against an existing .bib file and auto-fetches missing metadata via CrossRef and arXiv (with stub entries when verification is not possible).
  • Handout-compatible output: Generates a Quarto QMD in handout-typst format and updates/creates references.bib next to the slides.

Quick Start

Use the slides-to-notes skill to write lecture notes by providing the path to your MARP .md slides file and letting it generate the corresponding .qmd and references.bib.

Frequently Asked Questions about slides-to-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert MARP slides into Quarto lecture notes?

You can convert MARP slides into Quarto lecture notes by providing the path to your MARP markdown file, which generates a prose-expanded QMD document in handout-typst format. The skill expands bullet points into explanatory textbook-style paragraphs for a readable companion reader.

How do I resolve inline citations in Quarto from a BibTeX bibliography?

Resolve inline citations in Quarto by checking them against an existing .bib file, fetching missing metadata via CrossRef and arXiv, and emitting Pandoc citation syntax citekeys. The skill updates or creates a references.bib file next to your slides.

Can I auto-fetch missing BibTeX entries using CrossRef and arXiv metadata?

Yes, the skill auto-fetches missing BibTeX entries by querying CrossRef and arXiv for metadata when citations are not found in your existing .bib file. It generates stub entries for references that cannot be verified through these academic databases.

Does the slides-to-notes skill work with YAML metadata and tables in MARP?

Yes, slides-to-notes processes MARP slides containing YAML slide metadata, tables, discussion prompts, and inline citations. It converts these elements into a structured Quarto QMD document with prose-expanded sections and handout-typst formatting.

What is the best way to generate a companion textbook from existing presentation slides?

Generating a companion textbook from presentation slides is best done by converting MARP decks into Quarto QMD lecture notes, expanding bullet points into full explanatory textbook-style paragraphs. This approach produces a readable reader without rewriting content from scratch.

What happens to citations that cannot be verified through CrossRef or arXiv?

Citations that cannot be verified through CrossRef or arXiv are added as stub entries in the references.bib file. These placeholder records allow Quarto rendering to proceed while indicating that the reference metadata requires manual review and completion.