add-textbook-session

Convert textbook PDFs into structured seminar sessions with overview pages.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/shuheikomatsuki/lab-seminar-skills --skill add-textbook-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-textbook-session
Source: https://github.com/shuheikomatsuki/lab-seminar-skills/tree/main/add-textbook-session
Command: npx skills add https://github.com/shuheikomatsuki/lab-seminar-skills --skill add-textbook-session

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill automates the creation and augmentation of textbook-based seminar sessions in the lab-seminar site by transforming textbooks (PDFs) into structured sessions, overview pages, and navigational entries.

Core Features & Use Cases

  • Mode 1 creates a new session from a textbook PDF by generating an overview page, a Mermaid diagram, and a navigation entry, then prepares subpages for deeper exploration.
  • Mode 2 appends a deep-dive article for a specific sub-subsection to an existing session, authored by a designated presenter.
  • It validates the PDF path (with optional seminar_config.yml support for defaults) and outputs Markdown files, diagrams, assets, and prompts for manual image generation.

Quick Start

Run the add-textbook-session skill with a PDF path and a desired slug to create a new session overview and the initial subpages

Frequently Asked Questions about add-textbook-session

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

FAQPage Schema
How do I convert a textbook PDF into structured Markdown for a seminar?

You can convert a textbook PDF into structured Markdown by creating a new session that generates an overview page, a Mermaid diagram, and navigation entries for your seminar site. It outputs organized Markdown files and image prompts.

Can I add a deep-dive article to an existing textbook session in Markdown?

Yes, you can add a deep-dive article to an existing textbook session by using the append mode to generate a Markdown subpage for a specific sub-subsection authored by a designated presenter, allowing incremental expansion of your seminar materials.

Does this seminar session generator work with MkDocs navigation?

Working with MkDocs navigation is supported as the session generator outputs both Markdown content and navigation updates. It automatically prepares the necessary navigational entries to integrate new sessions and subpages into your MkDocs seminar site.

Do I need a configuration file to automate textbook session creation?

A configuration file is not strictly required but is optionally supported through seminar_config.yml for defaults. Validating the PDF path can utilize these defaults to streamline the automation process when creating new seminar sessions.

What is the best way to structure lab seminar materials from a textbook?

The best way to structure lab seminar materials from a textbook is by creating an overview page with a Mermaid diagram, followed by prepared subpages for deeper exploration. This approach organizes content hierarchically for effective seminar presentations.

Are there limitations when generating Mermaid diagrams from textbook PDFs?

Limitations when generating Mermaid diagrams from textbook PDFs include the output being limited to diagram code and image generation prompts for manual illustration. The Skill does not automatically render or embed the final images into the Markdown.