tt-caption-writer
Write a TikTok caption under 2,200 chars (hashtags included), pick a tasteful 3 to 5 hashtag set with mixed reach, and set the platformSettings.tiktok flags (viewer setting, comments, duet, stitch, commercial and branded content). Front-loads a reason to comment, runs the humanizer pass, and publishes the rendered video via Publora on approval. Use to caption a finished video. Not for the in-video hook (use tt-hook-scripter) or scrubbing a script (use tt-humanizer).
sergebulaev · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add sergebulaev/tiktok-skills --skill tt-caption-writer技能说明
name: tt-caption-writer description: "Write a TikTok caption under 2,200 chars (hashtags included), pick a tasteful 3 to 5 hashtag set with mixed reach, and set the platformSettings.tiktok flags (viewer setting, comments, duet, stitch, commercial and branded content). Front-loads a reason to comment, runs the humanizer pass, and publishes the rendered video via Publora on approval. Use to caption a finished video. Not for the in-video hook (use tt-hook-scripter) or scrubbing a script (use tt-humanizer)."
TikTok Caption Writer
Write the caption that sits under the video: a tight caption inside the 2,200
char API limit, a mixed-reach hashtag set, and the platformSettings.tiktok
flags that control reach and interaction. On TikTok the caption supports the
video, it does not carry it. The hook is in the first 1-3 seconds of the clip
(see tt-hook-scripter); the caption's job is to add context and earn a comment.
When to use
- User has a video (or a script) and needs the caption, hashtags, and settings
- User is about to upload and wants the posting flags right
- User wants Claude Code or Codex to schedule a rendered .mp4 via Publora
What this skill produces
- Caption (<= 2,200 chars on the API; aim much shorter), first line front- loaded with a reason to read or comment
- Hashtag set (3 to 5, mixed reach), placed at the end
- platformSettings.tiktok flags with a plain-English summary
- On approval, the publish call (draft -> upload -> schedule) when a video file is supplied
The TikTok settings (platformSettings.tiktok)
Build these with lib.tiktok_settings(...). Defaults match Publora's.
| Setting | Values / default | What it does |
|---|---|---|
viewerSetting | PUBLIC_TO_EVERYONE (default), MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY | who can view. Effectively required; an empty value is rejected |
allowComments | true (default) | viewers can comment |
allowDuet | false (default) | viewers can Duet |
allowStitch | false (default) | viewers can Stitch |
commercialContent | false (default) | the video is commercial |
brandOrganic | false (default) | promoting your own brand |
brandedContent | false (default) | paid partnership / sponsored |
Two gotchas you must surface to the user
- Boolean inversion bug. Publora currently maps
allowComments,allowDuet,allowStitchto TikTok'sdisable_*flags, so the booleans can land inverted (sendingallowDuet: truemay disable duets). The status cannot be confirmed from the API alone. Test with aSELF_ONLYdraft before trusting these values. Tell the user this whenever they change a flag. - Commercial disclosure. If
commercialContentis true, at least one ofbrandOrganic(your own brand) orbrandedContent(paid partnership) must also be true, or Publora rejects it.lib.tiktok_settingsenforces this.
Posting reality
- Unaudited apps post PRIVATE only. Until the publishing app passes TikTok's
review, posts are forced to
SELF_ONLYregardless ofviewerSetting. Warn the user if a "public" post lands private. - For reach, use
PUBLIC_TO_EVERYONE. For an end-to-end test, useSELF_ONLY.
Steps
Voice profile first (all drafts). If ../../references/voice-profile.md has filled: yes, load it and match the user's voice fingerprint, hard rules, and CTA/link style throughout. If it is not filled, mention once that tt-humanizer --mode profile can learn their voice from a few posts, then proceed with the generic voice rules.
Never invent the specifics. The rules below ask for a concrete number, a date and a named entity, because that is what separates a real post from a generated one. Take them from what the user actually said in this conversation. Do not invent a figure, a date, a client name or a result, and do not soften a vague claim into a plausible-looking number. If the user has nothing concrete for a beat, ask them once, and if they still have nothing, drop the claim rather than decorate it. A published invented number is a retraction; a missing one is only a weaker post.
- Gather inputs, goal first. Ask (or infer) what the caption should earn, then shape for it: comments -> end on one specific question tied to the video; saves -> promise reference value ("the 3 settings are in the caption"); shares -> a claim people will want to show someone; profile taps -> an open loop the pinned video pays off. Then gather the video topic/script, the niche, whether it is commercial, and whether a rendered .mp4 path exists.
- Draft the caption. Front-load the first visible line with a reason to read or a specific question to comment on. Keep it tight. Em dashes under the cap (about one per 100 words; a short caption rarely needs one), no AI vocab cluster. Optionally restate the hook's open loop as a comment prompt.
- Pick hashtags. 3 to 5, mixed reach: one broad, one to two niche-defining, one to two specific to the video. Put them at the end. Never stuff.
- Set the flags. Default to
PUBLIC_TO_EVERYONE, comments on, duet/stitch off, no commercial flags. Adjust per the user, and surface the two gotchas. Build withlib.tiktok_settings(...). - Char check. Confirm caption + hashtags <= 2,200. If over, tighten.
- Humanizer pass. Scrub 2026 AI vocab by density, cap em dashes (about
one per 100 words, never swap one for a period), break stacked triads,
generic openers, reveal bridges and sincerity openers ("not gonna lie").
Leave the rhythm alone; never chop a line for punch. Canonical rules:
tt-humanizerV3. - Approval card. Show: caption, char count, hashtag set, settings summary,
and the resolved
viewerSetting(flag if it may post private). - On approval. Call `lib.publish("video", caption, target_url=, video_path=, platform_settings=, scheduled_ti