sergebulaev/tiktok-skills / .codex-marketplace/tiktok-skills/skills/tt-caption-writer
tt-caption-writer
VerifiedWrite 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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| references/settings-matrix.md | markdown | 3.4 KB |
references/settings-matrix.md
View on GitHub# platformSettings.tiktok: full matrix, defaults, and known bugs
Every field Publora accepts inside `platformSettings.tiktok`, with the documented
default and the gotchas. Build the object with `lib.tiktok_settings(...)` rather
than hand-writing it; the helper enforces the commercial-disclosure rule.
## Viewer setting
`viewerSetting` is **effectively required**. The validator rejects an empty value
with "TikTok requires selecting who can view your post". The API route defaults
to `PUBLIC_TO_EVERYONE`, but always set it explicitly.
| Value | Who can view |
|---|---|
| `PUBLIC_TO_EVERYONE` | anyone (use this for reach) |
| `MUTUAL_FOLLOW_FRIENDS` | only mutual followers |
| `FOLLOWER_OF_CREATOR` | only your followers |
| `SELF_ONLY` | only you (use this to test a post end to end) |
## Interaction settings
| Field | Default | Intended meaning |
|---|---|---|
| `allowComments` | true | viewers can comment |
| `allowDuet` | false | viewers can Duet your video |
| `allowStitch` | false | viewers can Stitch your video |
> **Known boolean inversion bug.** Publora's publisher currently maps these to
> TikTok's `disable_*` flags, which inverts them: sending `allowDuet: true` can
> map to `disable_duet: true` and **disable** duets. The same applies to
> comments and stitch. The bug lives in a separate publisher service and cannot
> be confirmed from the API source alone.
>
> **How to handle it:** test with a `SELF_ONLY` draft and check the live post
> before you trust a value. If duets are off when you asked for on, send the
> opposite. The `lib.tiktok_settings` helper passes values straight through (it
> does not pre-invert), so you control the workaround explicitly.
## Commercial content settings
| Field | Default | Meaning |
|---|---|---|
| `commercialContent` | false | the video is commercial / promotional |
| `brandOrganic` | false | promoting your own brand or product |
| `brandedContent` | false | paid partnership or sponsored content |
> **Disclosure rule:** if `commercialContent` is true, at least one of
> `brandOrganic` or `brandedContent` must also be true, or Publora returns a
> validation error. `lib.tiktok_settings` raises before the request if you break
> this.
Set the right flag. Failing to disclose a paid partnership violates TikTok's
community guidelines, not just Publora's validation.
## Posting reality
- **Unaudited apps post PRIVATE only.** Until the publishing app passes TikTok's
review, every post is forced to `SELF_ONLY` regardless of `viewerSetting`. If a
"public" post lands private, this is why.
- **Rate limits:** 15 to 20 posts/day, 2 videos/minute. Space posts out.
- **Caption cap:** 2,200 chars on the API (hashtags included). The native app
allows 4,000, but the API enforces 2,200.
## Examples
Public reach video, comments on, duet/stitch off (the common default):
```python
from lib import tiktok_settings
settings = tiktok_settings() # PUBLIC_TO_EVERYONE, comments on, duet/stitch off
```
A paid partnership, public, duets enabled (remember the inversion: test it):
```python
settings = tiktok_settings(
viewer_setting="PUBLIC_TO_EVERYONE",
allow_duet=True, # verify on a SELF_ONLY draft first
commercial_content=True,
branded_content=True, # required because commercial_content is True
)
```
A safe end-to-end test post nobody else sees:
```python
settings = tiktok_settings(viewer_setting="SELF_ONLY")
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |