learnos-pdf-builder

Generate LearnOS Learner and Manager Pack PDFs from Markdown source files.

Updated May 16, 2026
One-click install
npx skills add https://github.com/jaredcroxton/hermes-mirror --skill learnos-pdf-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learnos-pdf-builder
Source: https://github.com/jaredcroxton/hermes-mirror/tree/main/agents/skills/productivity/learnos-pdf-builder
Command: npx skills add https://github.com/jaredcroxton/hermes-mirror --skill learnos-pdf-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns Markdown-based training content into the two audience-specific PDFs LearnOS needs (Learner Pack for upload and Manager Pack for facilitation), removing the manual, error-prone PDF production step.

Core Features & Use Cases

  • Two-pack PDF generation: Produces separate Learner.pdf and Manager.pdf outputs for the same programme content.
  • Programme-agnostic build workflow: Works for any programme as long as you follow the required source-file naming and structure.
  • Strict formatting and safety guardrails: Applies specific ReportLab/flowable rules to avoid common rendering failures and parsing issues during quiz and layout generation.

Quick Start

Place your [programme]-learner-source.md, [programme]-manager-source.md, and config.yaml (optional) into a folder, then run the learnos PDF build script on that folder to generate Learner.pdf and Manager.pdf.

Frequently Asked Questions about learnos-pdf-builder

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

FAQPage Schema
How do I convert Markdown training content into LearnOS PDFs?

To generate LearnOS PDFs, place your Markdown source files into a folder and run the provided Python build script to produce upload-ready Learner Pack and Manager Pack PDFs.

What is the difference between a Learner Pack and a Manager Pack PDF?

A Learner Pack PDF provides upload-ready training content, while a Manager Pack PDF contains companion facilitation content. Both are generated from the same Markdown source files but apply role-appropriate styling.

Do I need to follow specific file naming rules to generate LearnOS PDFs?

Yes, generating LearnOS PDFs requires following strict file naming rules. Your Markdown source files must be named using the [programme]-learner-source.md and [programme]-manager-source.md patterns.

Why does my ReportLab PDF generation fail during quiz layout rendering?

ReportLab PDF generation fails when formatting rules are ignored. The build script applies specific ReportLab flowable constraints and safety guardrails to prevent common rendering failures and parsing issues during quiz generation.

Can I use this PDF generation workflow for any training programme?

Yes, this PDF generation workflow is programme-agnostic. You can use it for any training programme as long as you follow the required Markdown source-file naming conventions and structural guidelines.