Copy in, drafts out

This is the fast method for a set of posts. You write the copy one time, in one copy file. One apply step makes all the drafts. Then you open the app links and review the drafts.

The steps

  1. Write one copy file for the set. The file holds only the text of each post.
  2. Tell Claude to apply the file with slideshow_batch.
  3. Open the app link of each draft and examine the slides.
  4. To change a post, edit the post in the file. Then tell Claude to apply the file again.

The copy file

The copy file is a YAML file. A file with a name that ends in .json holds JSON with the same fields.
yaml
account: "@your_account"
format: tips
posts:
- cover: 3 study habits that work
slides:
- ["1. Plan the week.", "One page a class."]
- ["2. Short sessions.", "25 minutes, then rest."]
- {title: "3. Track it.", app: true}
caption: Which one will you try?
tags: [studytips]
  • account is the handle of the account.
  • Each post has a cover, slides, a caption, and tags.
  • The cover is the first slide. The other slides come after it, in the sequence of the file.
  • A slide has a title and a body, or only a title.
  • A slide can also give a photo with photo, or a hint for the photo with photoHint.
  • A slide can set the text position with place: top, middle, or low. Without place, the text goes on a clear part of the photo.
  • app: true marks the slide that shows your app. Its photo comes from the pack of app screenshots.

Tasks of the apply step

The apply step writes no copy with AI. It does these steps:
  • It gets the look of each text from the slideshow template of the account.
  • It selects photos from the photo pack of the account.
  • No two slides in the set get the same photo. Photos that the account did not use come first.
  • It puts each text box in position. A text box does not cover the text box above it.
  • It puts the text of a slide without place on a part of its photo that is clear of faces, phones, logos, and the main subject, and out of the TikTok buttons and caption. A vision model reads each photo one time for this, and the result is kept.
  • It saves each post as a draft in the review queue.
The apply step does not approve, schedule, or post a draft.

The reply

For each post, the reply gives these items:
  • link: the link that opens the draft in the app editor.
  • preview: one image with all the slides of the draft.
  • result: the result of the apply step, such as created, updated, or same.
  • warnings: problems to examine, such as text below the top of the TikTok caption area.

Change a post

Edit the post in the copy file. Then apply the file again. Only the changed posts get an update.
A lock file next to the copy file keeps the connection between each post and its draft. Keep the lock file with the copy file.
If a person changed a draft in the app, the apply step does not write over it. The result is app-edited.
To keep the app changes in the copy file, tell Claude to pull the draft. The pull step writes the text, caption, hashtags, and changed photos of the draft into the file. It writes a post only when these conditions are true:
  • The post in the copy file did not change after the last apply step.
  • The draft and the post in the file have the same number of slides.
  • The cover of the draft has one text.
  • Each other slide of the draft has one text for each title line and each body line of the post.
If a condition is not true, the result is kept. The pull step does not change the copy file or the lock file. Then edit the post in the app, or give the post a new key.

One post at a time

For one slideshow, Claude can call slideshow_create with the full content. Then Claude calls slideshow_preview to show the slides. For a small correction, Claude calls slideshow_update.