Skip to content

sergebulaev/tiktok-skills / .codex-marketplace/tiktok-skills/skills/tt-caption-writer

tt-caption-writer

Verified

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).

FileKindSize
SKILL.mdskill md8.2 KB
references/settings-matrix.mdmarkdown3.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")
```
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall