shownotes-publisher

Publish talk pages to a Jekyll site from outline.yaml and resources.json.

17|1|Updated Feb 22, 2026

Search Tags:#structured data #markdown #Jekyll #talk pages #conference speakers

Ready to run

npx skills add https://github.com/jbaruch/speaker-toolkit --skill shownotes-publisher

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: shownotes-publisher
Source: https://github.com/jbaruch/speaker-toolkit/tree/main/skills/shownotes-publisher
Command: npx skills add https://github.com/jbaruch/speaker-toolkit --skill shownotes-publisher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jsonschema, json, yaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the process of publishing talk pages to a Jekyll-based shownotes site, ensuring structured data and a clean user experience.

Core Features & Use Cases

Talk Page Creation: Automatically composes and publishes markdown files for talk pages.
Structured Data: Generates structured data for search engine optimization and content organization.
Use Case: Ideal for conference speakers who want to share their talks with structured information that is ready for web publication.

Quick Start

Use the shownotes-publisher skill to publish a talk page with the slides URL and an optional video URL.

Frequently Asked Questions about shownotes-publisher

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

FAQPage Schema

How do I publish conference talk pages to a Jekyll site with structured data?▼

To publish conference talk pages to a Jekyll site, this Skill composes markdown files with structured data extracted from outline.yaml and resources.json. It handles frontmatter creation, thumbnail generation, and file validation before publication.

What is the best way to generate markdown frontmatter for Jekyll talk pages?▼

Generating markdown frontmatter for Jekyll talk pages requires parsing structured data from outline.yaml and resources.json. This process extracts metadata for search engine optimization and content organization before composing the final file.

Do I need Python to generate Jekyll markdown files from YAML and JSON sources?▼

Yes, you need Python and specific libraries to parse outline.yaml and resources.json for generating Jekyll markdown files. The Skill relies on Python scripts to extract data, compose frontmatter, and create thumbnails before publication.

How does structured data extraction from outline.yaml work for talk page creation?▼

Structured data extraction from outline.yaml works by parsing the file to retrieve talk metadata and resources. The Skill then maps this extracted information into Jekyll frontmatter and markdown content, ensuring the published page contains validated structured data.

Can I validate Jekyll frontmatter and thumbnails before publishing talk pages?▼

Yes, you can validate Jekyll frontmatter and thumbnails before publishing talk pages. The Skill performs file validation on the composed markdown and generated thumbnails, ensuring structured data integrity before the final publication step.

What are the limitations of using scripts to publish markdown files to a Jekyll site?▼

The limitations of using scripts to publish markdown files to a Jekyll site include a strict dependency on Python and specific libraries for parsing. The workflow also requires inputs to follow the exact outline.yaml and resources.json formats to avoid validation failures.