make-lecture-kit — turn any topic into an easy, visual, interactive study kit

Give it a topic, a list of topics, your notes or study material, or PDFs / slide decks — and your AI assistant produces two things into an output/ folder:

• companion.pdf — a professionally typeset study companion in plain, easy English: an everyday analogy before every idea, real-life examples, and every worked example walked through step by step (LaTeX + figures).
• lecture.html — a complete, very interactive lecture: the whole topic as a story-driven page where you play with every idea and watch the intuition appear.

No slides needed. With just a topic name, the assistant designs the syllabus, the analogies and the worked examples itself. With material, it covers all of it and fills in the steps, intuition and examples the material skips. The output is generic and unbranded — use it for any subject, any course, any learner.

No API keys. You install nothing. Your own agent session writes the source, makes the figures, and compiles the PDF for you. It works first-class on all three major assistants — Claude, OpenAI Codex, and Google Jules (plus Cursor, Gemini CLI, and the like) because it ships both open skill formats: a plain SKILL.md (Claude and Codex auto-discover it) and an AGENTS.md at the repo root (Jules, Codex, Cursor, Gemini CLI, and the wider agents.md ecosystem read it natively). Nothing is platform-specific — standard LaTeX plus standard-library Python — and the companion PDF compiles wherever TeX is available (most agent sandboxes have it built in).

---

Install (pick your assistant)

Everything lives in one repo: https://github.com/saurabh1604/make-lecture-kit. Cloning is best — it makes staying current a single command (see the next section). Prefer not to use git? Download the ZIP from that page and unzip it wherever the steps below say to clone.

Claude Code

git clone https://github.com/saurabh1604/make-lecture-kit ~/.claude/skills/make-lecture-kit

Claude Code auto-discovers any skill in ~/.claude/skills/. (For one project only, clone into /.claude/skills/ instead.) Then ask: “Use make-lecture-kit on the topic eigenvectors.”

OpenAI Codex

git clone https://github.com/saurabh1604/make-lecture-kit ~/.agents/skills/make-lecture-kit

Codex auto-discovers SKILL.md skills in ~/.agents/skills/ (and in .agents/skills/ inside a repo). List them with /skills, invoke explicitly with $make-lecture-kit, or just say: “Use the make-lecture-kit skill on the topic backpropagation.” (No-git option: in Codex run $skill-installer and point it at the repo.)

Google Jules

Jules runs on a GitHub repo and reads AGENTS.md at the repo root automatically. Two ways to use it:

• Fastest: in Jules, connect the saurabh1604/make-lecture-kit repo, then