When should you use it?
- You teach or tutor from textbooks
- You want active practice, not summaries
- You have a library of lesson components
Not for: Copyrighted texts you are not allowed to adapt; Assessments with grades that count
What do you need, and what do you get?
You need
- Source PDF
- Component library
- Example lessons
You get
- Structured lesson
- Interactive activities
- Reviewer notes
How does it work, step by step?
- Load the materialKeep short texts in context; index long ones for lookup.
- Plan the lessonGive a few good examples and have the agent propose a structure.
- Pick componentsLet it call tools for quizzes, matching or diagrams with the content filled in.
- Review against the sourceA separate reviewer checks each activity is accurate to the text.
- Share and reviseSend to learners and fix what confuses them.
The prompt
Our own prompt, inspired by Hassan (@nutlope) and written to work in Custom agent, Claude and ChatGPT. Values in lime are placeholders.
Fill in the blanks (optional; the copied prompt uses your values)
Create an interactive lesson from this material: {source}. Available components: {components}. Propose a structure of 4 to 6 sections, choose a component for each with its content, and cite the page or passage it comes from. Then review each item against the source and list corrections before final output.
Inspired by Hassan (@nutlope): Post on building an agent that turns PDFs into interactive courses. The prompt above is written by playbooks.bot in our own words; nothing from the original is quoted.
What can go wrong?
- Generated quiz answers can be wrong; the reviewer must compare to the source.
- Respect the license of the material you convert.
Our take
Hassan (@nutlope) outlines an agent that turns a PDF or textbook into a full interactive course: it parses material, decides a lesson structure from examples, and calls ready-made widgets like Q&A cards. Two design choices make this more than a summary generator. First, the agent assembles lessons from a fixed set of components, so output is consistent. Second, a separate reviewing agent compares each activity with the original text before anything is shared, which matters because generated quiz answers can be wrong. If you build something similar, keep short texts in context and index long ones, give a few strong example lessons so the structure is sensible, and limit the agent to a small, fixed library of widgets, for example question cards, matching drills and diagrams. Send the result to a few learners and fix what confuses them. Check the license of any textbook before converting it, and keep these lessons for practice rather than graded assessments.
Where the time goes back: A chapter becomes practice material in one run, and your time goes into review rather than building activities.
FAQ
Is the app available?
Why a separate reviewer?
Source and credit
Inspired by Hassan (@nutlope). We describe the idea in our own words, link to the original, and wrote the prompt ourselves; nothing is quoted.
- Inspired by
- Post on building an agent that turns PDFs into interactive courses
- Creator
- Hassan (@nutlope)
- Published on
- X
- Original date
- Oct 23, 2025
- License
- Not openly licensed (the poster keeps all rights), so we quote nothing and link to the original
- Originally for
- Custom agent
- AI dry run
- Oct 23, 2026: passed. Dry-run tested by our AI test agent on sample input. PASS: Gates held on desk check; no live sends or purchases.
AI dry run on sample data; not run with live connected accounts. The playbooks.bot test agent filled the prompt with synthetic inputs, produced the output and checked it against the page's stated outputs and guardrails. - Verified
- Oct 24, 2026: source link resolves to the original, the credited creator published it, our excerpt or prompt matches it, and the license allows our use.
Are you the creator? Claim or correct this page.