lecture-scratchpad

Generate Obsidian scratchpad worksheets with rendered slide images from lecture PDFs.

Updated May 10, 2026
One-click install
npx skills add https://github.com/cookkie03/skills --skill lecture-scratchpad-cookkie03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lecture-scratchpad
Source: https://github.com/cookkie03/skills/tree/main/lecture-scratchpad
Command: npx skills add https://github.com/cookkie03/skills --skill lecture-scratchpad-cookkie03

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires poppler, and includes scripts (resource) components.

What problem does it solve? Preparing for live lectures requires manually converting slide decks into note-taking worksheets, which is tedious and error-prone. This Skill automates the creation of structured, slide-by-slide scratchpad notes in Obsidian so students can focus on capturing spoken content in real time. ## Core Features & Use Cases - Automated Slide Rendering: Converts each PDF slide into a PNG image at configurable DPI using poppler utilities. - Structured Worksheet Generation: Produces an Obsidian markdown note with YAML frontmatter, embedded slide images, and blank sections for takeaways and questions per slide. - Metadata Inference: Automatically detects course name, lecture/week label, and note title from file paths, with CLI overrides. - Use Case: Before a university lecture, run the script on the week's slide deck PDF to instantly get a clean worksheet note in your vault, ready for in-class annotation. ## Quick Start Ask the assistant to generate a lecture scratchpad note from your slides PDF, specifying the PDF path and the target note location in your Obsidian vault.

Frequently Asked Questions about lecture-scratchpad

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

FAQPage Schema
How do I convert lecture slides PDF into Obsidian notes?

Run the generate_scratchpad.py script with --pdf pointing to your slide deck and --output set to the target markdown note path in your Obsidian vault. It renders each slide as a PNG and builds a structured note with embedded images and blank note sections.

How to render PDF slides to PNG images from the command line?

The script uses the pdftoppm binary from poppler utilities to render each PDF page as a PNG at a configurable DPI (default 150). Images are saved to an images directory next to the PDF unless overridden with --images-dir.

Does the scratchpad generator require poppler installed?

Yes, it depends on poppler utilities, specifically pdftoppm for rendering slides and pdftotext for extracting slide titles. The script searches PATH and common install locations like /opt/homebrew/bin, and raises an error if pdftoppm is missing.

Can I customize the course name and lecture title in the generated note?

Yes, use the --course, --lecture, and --title CLI flags to override automatic inference. Without them, the script infers the course from the vault path structure and detects Week or Lecture labels from filenames.

Why does the script fail when the output note already exists?

By default the script refuses to overwrite an existing output file and raises a FileExistsError. Pass the --force flag to explicitly overwrite the existing scratchpad note.