lpm: Skill for Claude Code

Make a vertical lesson video from a topic and optional notes. It is not a trimmed YouTube lesson: the script, the pacing and the picture are built for a phone held upright with the sound possibly off.

The recorder, the voice and the mix are the lesson skill's (../lesson/scripts). Everything that skill's SKILL.md says about driving the app still holds and is not repeated here: the pristine ~/.lpm-lessons data dir, /Users/Shared/lpm-lessons workspace, the lesson control socket, real pointer and keys (s.keys("return"), never cliclick kp:), agent trust, waitFor/click/type selectors, foreground takes, the OpenAI key in the Keychain, the preflight and lint that check the Mac and the script before every take, the take folders (_takes/), the guarded agent settings and the checks after the mux (qa/report.json; the screen is read on the take's clock). The beat API is in lesson/reference/beats-api.md.

What makes it TikTok-native

• Vertical 1080x1920, 20–45 s. The app runs in a portrait window (820x1040 pt by default; "window" in lesson.json). The window floats on a dark canvas with cyan, pink and violet glows. A virtual camera cuts a 9:16 crop from it that eases between a wide shot (the whole window width) and push-ins that follow the action.
• Payoff first, and held. The video opens cold on the finished result (a later moment of the take) under the hook line and a big headline sticker. The steps come after. Frame 0 is already the payoff with text on it, so it is also the cover. The opening lines' beats are never seen, so the last of them does the setup (pick the project, start an agent).
• Don't cut away at 2 s. TikTok's retention graph for the best video so far (1.9K views) showed most viewers leaving at 0:02, the moment a one-line opening cut from the result to the app's setup. Its likes peaked at 0:01, on the result. Open on two lines over the payoff ("open": 2, about 4–5 s): the hook, then a line that gives a reason to keep watching.
• Hook in under 2.5 s. One short sentence: a problem ("Stop guessing your Claude Code limits."), a surprising fact, or a result. Never "In this video", never "Here's how to set it up in lpm". The headline sticker says what the video delivers ("Claude Code limits, right under your prompt 👀").
• Burned-in word-by-word captions. Most people watch muted. Pages of up to 3 words sit in the lower middle, heavy white with a black stroke, the spoken word in yellow, *word* in cyan. They are timed from the voice clip's own transcript.
• Numbered step stickers. A line's "label" puts "① Open Settings" at the top of the frame until the next one.
• No dead air. Lines follow each other with 140 ms gaps. Typing and agent thinking are jump-cut with s.skip(). The voice is quick and upbeat (DEFAULT_STYLE in scripts/make.js, sped up 1.08x with pitch kept; "tempo" in lesson.json).
• Ends on the result. The last line plays over the payoff shot the video opened on (it loops cleanly), with an lpm.cx end sticker. No outro card, no "follow for part 2", no next-lesson teaser (user rule: every video stands alone).
• Safe zones. Stickers, captions and push-in targets keep clear of TikTok's own UI: the top tabs, the right-hand button column, and the caption and sound area at the bottom. The review sheet draws those zones in.