Index of every page on this site: llms.txt
All skills
sergebulaev avatar

/tt-caption-writer

@ba2f700
Run it yourself

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

Use this Skill: https://skilld.dev/gh/sergebulaev/tiktok-skills/tt-caption-writer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencessettings-matrix.md

≈860 tokens on demand. Your agent reads this file only when SKILL.md points to it.

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

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

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:

settings = tiktok_settings(viewer_setting="SELF_ONLY")

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill is a tool for drafting and publishing TikTok captions. It carries a low risk of indirect prompt injection as it processes user-provided video scripts and external voice profiles before calling a publishing API. No malicious code or exfiltration patterns were detected.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at ba2f700. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago

README badge

README badge for sergebulaev/tiktok-skills/tt-caption-writer