GitHub - cometscome/handwritten2pdf
This is a GitHub repo for an experimental Codex skill that takes scanned handwritten lecture notes and produces student-facing LaTeX and PDF materials, covering checking against the original, filling in omitted derivations, drawing figures in TikZ, and checking the typeset output. It is version 0.1, has only been tried on Japanese electromagnetism notes, and its output still needs manual checking against the source.
- It is a set of instructions for Codex plus a Japanese LuaLaTeX template, not a standalone converter; you drop in the PDF and the skill guides the work.
- Japanese text polishing with yomiyasu is a required step, which the skill fetches itself at run time rather than bundling it.
- The authors state that handwriting reading, equations, and figures are not guaranteed, and the only trial was a four-page electromagnetism sample without an independent evaluation.
This is a v0.1 experimental Codex skill called handwritten-lecture-notes, from the cometscome/handwritten2pdf repository. It turns scanned or photographed handwritten lecture notes (PDF or images) into LaTeX and PDF teaching material students can actually read. The workflow covers matching each handwritten page to a section, equation, or figure in the output; filling in motivations and intermediate steps the board work skipped; looking up Japanese and English lecture sources to check and expand derivations, with the references listed at the end of the PDF; drawing figures in TikZ and checking their symbols and geometry against the text; and then compiling and visually checking the result. The author is explicit that this is not a standalone converter. It's a set of instructions for Codex, so you need Codex with the skill installed, network access, Python, and LuaLaTeX with latexmk and pdftoppm. The bundled template (assets/lecture-notes-ja.tex) uses LuaLaTeX and LuaTeX-ja, and it ships with only a short calderivative-and-tangent example to replace.
The part worth paying attention to is the mandatory Japanese prose-editing step. Drafts must be run through yomiyasu, a third-party Japanese editing procedure by nanaism under MIT license. Codex fetches yomiyasu's instructions and check scripts at run time into a temporary folder, not into the skill or the repo. If that fetch or the checks can't run, the output has to be labeled a provisional draft and the skipped steps reported. The skill also keeps a separate work log of corrections in the original, transcription errors, notation changes, and added explanations, and it keeps edit annotations out of the student-facing PDF. The author says prose review doesn't verify the math, the figure-to-text consistency, or the correspondence to the original; those are separate checks.
The evidence is thin, and the author says so. The only real trial was one handwritten electromagnetism lecture in Japanese: the opening section, four TikZ figures, four pages, compared against an existing version. There was no controlled comparison with and without the skill, and no measurement of student understanding. The yomiyasu step was added after that trial, so the full pipeline with that step hasn't been tested end to end. Any use beyond Japanese electromagnetism notes is unverified, and the skill is best treated as a drafting aid whose output still needs to be checked against the source by hand.