Skip to content
Back to search

tiktok-skills

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/sergebulaev/tiktok-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/sergebulaev/tiktok-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sergebulaev--tiktok-skills/badge.svg)](/listings/sergebulaev--tiktok-skills)

HTML

<a href="/listings/sergebulaev--tiktok-skills"><img src="/api/listings/sergebulaev--tiktok-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Pick whichever way you use Claude Code or Codex:

Codex CLI

codex plugin marketplace add sergebulaev/tiktok-skills
codex plugin add tiktok-skills@tiktok-skills

To test a local clone before publishing changes:

git clone https://github.com/sergebulaev/tiktok-skills.git
cd tiktok-skills
codex plugin marketplace add .
codex plugin add tiktok-skills@tiktok-skills

claude.ai (web)

1. Open https://claude.ai/code 2. Go to **Skills** in the sidebar 3. Click **Add from GitHub** 4. Paste: `sergebulaev/tiktok-skills` 5. Done. The skills activate automatically when you ask about TikTok.

Claude Desktop (Mac / Windows)

1. Open Claude Desktop 2. Open **Settings** (gear icon) 3. Go to **Skills** 4. Click **Add from GitHub** 5. Paste: `sergebulaev/tiktok-skills` 6. Done. Start a new conversation and ask Claude to script a hook.

Claude Code (CLI / VS Code / JetBrains)

/plugin marketplace add sergebulaev/tiktok-skills
/plugin install tiktok-skills@tiktok-skills

Or clone the repo and open it as your working directory:

git clone https://github.com/sergebulaev/tiktok-skills.git
cd tiktok-skills

OpenClaw

1. Open your OpenClaw working directory 2. Clone the skills into it:

   git clone https://github.com/sergebulaev/tiktok-skills.git

3. In OpenClaw settings, add this to your system prompt:

   You have TikTok marketing skills in ./tiktok-skills/.
   For any TikTok task, read the relevant skills/*/SKILL.md first.
   Use lib/url_parser.py for URL parsing and lib/publora_client.py for publishing.

4. Done. Ask OpenClaw to write a TikTok post.

Hermes Agent

Hermes Agent (Nous Research) follows the agentskills.io open standard and loads `skills/*/SKILL.md` directly. Clone the bundle into your Hermes skills folder:

git clone https://github.com/sergebulaev/tiktok-skills.git ~/.hermes/skills/tiktok-skills

Coming from OpenClaw? `hermes claw migrate` imports these skills automatically. Then call `/<skill-name>` from any of your Hermes chat surfaces.

Any agent (skills CLI)

One command that works across Claude Code, Codex, Cursor, and any other agent that reads SKILL.md files:

npx skills add sergebulaev/tiktok-skills

> **Found this useful? [Star the repo](https://github.com/sergebulaev/tiktok-skills).** Curated Claude Code and Codex directories rank and gate by star count, so a star is what makes these skills findable for the next person. It is the only thing we ask. No signup, no email.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 39 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "tiktok-skills",
  3. "owner": {
  4. "name": "Serge Bulaev",
  5. "url": "https://github.com/sergebulaev"
  6. },
  7. "metadata": {
  8. "description": "Claude Code and Codex skills for TikTok growth: first 1-3 second hook scripting, caption writing with TikTok settings and hashtags, trend and sound mapping, an AI-script humanizer with bundled pre-film audit, and weekly content planning around completion rate. The rendered video publishes through the Publora API."
  9. },
  10. "plugins": [
  11. {
  12. "name": "tiktok-skills",
  13. "source": "./",
  14. "description": "Bundle of 8 TikTok marketing skills for Claude Code and Codex with 3-second hook formulas, spoken-script hook writing, caption and platform-settings writing, trend and sound mapping, a unified humanizer (rewrite plus `--mode audit` pre-film check), and a weekly content planner. The user supplies the video; the rendered clip ships via Publora's draft, upload, schedule flow.",
  15. "version": "1.0.34",
  16. "author": {
  17. "name": "Serge Bulaev",
  18. "url": "https://github.com/sergebulaev"
  19. },
  20. "homepage": "https://github.com/sergebulaev/tiktok-skills",
  21. "license": "MIT",
  22. "keywords": [
  23. "tiktok",
  24. "short-form-video",
  25. "marketing",
  26. "social-media",
  27. "content-creation",
  28. "claude-skills",
  29. "codex-skills",
  30. "anthropic",
  31. "ai-agents",
  32. "personal-branding",
  33. "hooks",
  34. "viral-content"
  35. ],
  36. "category": "productivity"
  37. }
  38. ]
  39. }
README.md · README · 376 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/hero.png" alt="TikTok marketing skills for Claude Code and Codex, open source MIT licensed" width="900" />
  3. </p>
  4. # TikTok Marketing Skills for Claude Code and Codex
  5. <p align="center">
  6. <img src="https://img.shields.io/github/v/release/sergebulaev/tiktok-skills?color=111827&label=release" alt="Latest release">
  7. <img src="https://img.shields.io/badge/Claude_Code-Compatible-D97757?logo=anthropic&logoColor=white" alt="Claude Code Compatible">
  8. <img src="https://img.shields.io/badge/Codex-Compatible-111827" alt="Codex Compatible">
  9. <img src="https://img.shields.io/badge/Claude-Skills-8A63D2" alt="Claude Skills">
  10. <img src="https://img.shields.io/badge/License-MIT-22C55E.svg" alt="MIT License">
  11. <img src="https://img.shields.io/github/stars/sergebulaev/tiktok-skills?style=social" alt="GitHub stars">
  12. <img src="https://img.shields.io/badge/PRs-welcome-F59E0B.svg" alt="PRs Welcome">
  13. </p>
  14. > **Part of the [linkedin-skills](https://github.com/sergebulaev/linkedin-skills) family (400+ stars).** Same voice engine and approve-before-publish flow, now for TikTok. Also available for [Instagram](https://github.com/sergebulaev/instagram-skills) · [X](https://github.com/sergebulaev/x-skills) · [YouTube](https://github.com/sergebulaev/youtube-skills) · [Threads](https://github.com/sergebulaev/threads-skills) · [Facebook](https://github.com/sergebulaev/facebook-skills).
  15. **8 skills that turn Claude Code and Codex into your TikTok content team.** They script the first-3-second hook, write captions, ride trends, plan a week of content, and read your niche from real data. You supply the video; the skills write the words, strip the AI tells, and wait for your approval.
  16. Once installed, just ask Claude Code or Codex things like:
  17. - "Script a hook for a TikTok about [topic]"
  18. - "Plan a week of TikTok content for my [niche]"
  19. - "What's trending in my niche right now? (reads real data via Apify)"
  20. - "Rewrite this caption so it sounds human on camera"
  21. The right skill activates automatically. Then you review and approve.
  22. ## TikTok is video-only
  23. TikTok does not accept text-only posts. These skills do not generate video. They produce everything around it: the spoken hook script, the on-screen text, the caption, the hashtags, and the posting settings. You record and render the clip; the skills handle the words and the publish.
  24. ## Install
  25. Pick whichever way you use Claude Code or Codex:
  26. ### Codex CLI
  27. ```bash
  28. codex plugin marketplace add sergebulaev/tiktok-skills
  29. codex plugin add tiktok-skills@tiktok-skills
  30. ```
  31. To test a local clone before publishing changes:
  32. ```bash
  33. git clone https://github.com/sergebulaev/tiktok-skills.git
  34. cd tiktok-skills
  35. codex plugin marketplace add .
  36. codex plugin add tiktok-skills@tiktok-skills
  37. ```
  38. ### claude.ai (web)
  39. 1. Open https://claude.ai/code
  40. 2. Go to **Skills** in the sidebar
  41. 3. Click **Add from GitHub**
  42. 4. Paste: `sergebulaev/tiktok-skills`
  43. 5. Done. The skills activate automatically when you ask about TikTok.
  44. ### Claude Desktop (Mac / Windows)
  45. 1. Open Claude Desktop
  46. 2. Open **Settings** (gear icon)
  47. 3. Go to **Skills**
  48. 4. Click **Add from GitHub**
  49. 5. Paste: `sergebulaev/tiktok-skills`
  50. 6. Done. Start a new conversation and ask Claude to script a hook.
  51. ### Claude Code (CLI / VS Code / JetBrains)
  52. ```
  53. /plugin marketplace add sergebulaev/tiktok-skills
  54. /plugin install tiktok-skills@tiktok-skills
  55. ```
  56. Or clone the repo and open it as your working directory:
  57. ```bash
  58. git clone https://github.com/sergebulaev/tiktok-skills.git
  59. cd tiktok-skills
  60. ```
  61. ### OpenClaw
  62. 1. Open your OpenClaw working directory
  63. 2. Clone the skills into it:
  64. ```bash
  65. git clone https://github.com/sergebulaev/tiktok-skills.git
  66. ```
  67. 3. In OpenClaw settings, add this to your system prompt:
  68. ```
  69. You have TikTok marketing skills in ./tiktok-skills/.
  70. For any TikTok task, read the relevant skills/*/SKILL.md first.
  71. Use lib/url_parser.py for URL parsing and lib/publora_client.py for publishing.
  72. ```
  73. 4. Done. Ask OpenClaw to write a TikTok post.
  74. ### Hermes Agent
  75. Hermes Agent (Nous Research) follows the agentskills.io open standard and loads `skills/*/SKILL.md` directly. Clone the bundle into your Hermes skills folder:
  76. ```bash
  77. git clone https://github.com/sergebulaev/tiktok-skills.git ~/.hermes/skills/tiktok-skills
  78. ```
  79. Coming from OpenClaw? `hermes claw migrate` imports these skills automatically. Then call `/<skill-name>` from any of your Hermes chat surfaces.
  80. ### Any agent (skills CLI)
  81. One command that works across Claude Code, Codex, Cursor, and any other agent that reads SKILL.md files:
  82. ```bash
  83. npx skills add sergebulaev/tiktok-skills
  84. ```
  85. > **Found this useful? [Star the repo](https://github.com/sergebulaev/tiktok-skills).** Curated Claude Code and Codex directories rank and gate by star count, so a star is what makes these skills findable for the next person. It is the only thing we ask. No signup, no email.
  86. ## What you can do
  87. Once installed, just ask Claude Code or Codex for help with TikTok. The right skill activates automatically.
  88. **Script a hook:**
  89. > "Script a 3-second hook for a video about the git command that saved my job. Goal: saves."
  90. **Write the caption and settings:**
  91. > "Write the caption, hashtags, and TikTok settings for this video. Comments on, public."
  92. **Ride a trend without being cringe:**
  93. > "Should I jump on this trending sound for my backend dev niche? [link]. How do I make it mine?"
  94. **Make a script sound human on camera:**
  95. > "Strip the AI tells from this script so it sounds like me talking, not a teleprompter: [paste]"
  96. **Plan your week:**
  97. > "Plan a week of TikTok content. I teach backend engineering to junior devs."
  98. Every skill shows you a draft first and waits for your OK. Nothing gets scheduled without your approval.
  99. ## The 8 skills
  100. | Skill | What it does |
  101. |---|---|
  102. | **Hook Scripter** | Scripts the first 1-3 seconds of the video: the spoken line, the on-screen text, and the opening visual, all firing at once. Picks a 2026 hook formula by goal (completion, saves, comments, shares). The single biggest retention lever |
  103. | **Caption Writer** | Writes the caption under 2,200 chars, picks a 3 to 5 hashtag set with mixed reach, and sets the `platformSettings.tiktok` flags (viewer setting, comments, duet, stitch, commercial and branded content). Publishes the rendered video via Publora on approval |
  104. | **Trend Mapper** | Maps a trending sound or format to your niche so the ride is authentic, not cringe. Runs a fit check, reads the trend lifecycle, scripts the twist that makes it yours, and tells you when to skip a trend entirely |
  105. | **Humanizer** | Removes the AI-script tells viewers hear on camera: 2026 AI vocabulary scored by density per beat, reveal bridges, staccato drama-rhythm, stacked triads, performed sincerity, "hey guys" filler and written-not-spoken phrasing; caps em dashes instead of banning them and never inserts a punch line for rhythm. Does not promise to beat detectors (no edit reliably does). Bundles a `--mode audit` pre-film check (hook strength, completion design, caption fit) |
  106. | **Content Planner** | Builds a weekly plan with per-day hooks, sounds, lengths, and goals, a hook-batching schedule so you film several openers in one session, a sound shortlist with the trend window, and a completion-rate goal check |
  107. | **Repurposer** | Rebuilds content from another platform (LinkedIn post, blog, newsletter, X thread) into a native TikTok script and caption: opens on the payoff, rewrites every line to be sayable in one breath, adds a trend or sound angle where it fits, and strips off-platform artifacts before publishing on approval |
  108. | **Profile Optimizer** | Audits and rewrites the profile end-to-end: photo, searchable name, username, the 80-char bio, the link (with a pre-1k workaround), up to 3 pinned videos as niche proof, and a one-line positioning statement. Turns a profile visit that follows a video into a follow |
  109. | **Audience Insights** | Reads your TikTok niche and audience from real Apify data: top hashtag videos by plays, the winning hooks and sounds, competitor profiles, and the commenters on a video (TikTok hides likers). No login |
  110. ## How publishing works on TikTok
  111. TikTok requires a video on every post, so a caption alone cannot go out. The official TikTok Content Posting API also needs an OAuth flow and an app review. This bundle hands the whole chain to [Publora](https://publora.com/?utm_source=github&utm_medium=readme&utm_campaign=tiktok-skills): once you have a rendered .mp4, the flow is
  112. ```
  113. 1. create a draft (the caption, no scheduled time)
  114. 2. get a pre-signed upload URL
  115. 3. upload the video
  116. 4. set the scheduled time
  117. ```
  118. `lib.publish("video", caption, target_url, video_path=..., scheduled_time=...)` runs all four steps in one call. The Caption Writer skill uses this on approval.
  119. ## Optional: schedule videos with Publora
  120. By default, the skills draft the script, caption, and settings for you to upload in the TikTok app. If you want Claude Code or Codex to schedule a rendered video directly, connect Publora. It takes about 2 minutes once you have the .mp4.
  121. ### What is Publora?
  122. [Publora](https://publora.com/?utm_source=github&utm_medium=readme&utm_campaign=tiktok-skills) is a publishing API that turns the multi-step TikTok video upload into one `create-post`-plus-upload call (and can cross-post the same content to other platforms).
  123. Publora also ships [official MCP skills](https://github.com/publora/skills) (`npx skills add publora/skills`): one skill per platform, covering the publish side only. This bundle is the layer above them, adding the reading, the writing craft and the approval flow.
  124. ### Setup (2 minutes)
  125. **Step 1.** Sign up at https://app.publora.com/signup?utm_source=github&utm_medium=readme&utm_campaign=tiktok-skills (free)
  126. **Step 2.** Connect TikTok: click **Channels** in the left sidebar, then **Add Channel**, pick **TikTok**, authorize.
  127. **Step 3.** Find your Platform ID: go to **Channels**, click your TikTok account. The ID looks like `tiktok-7123456789`. Copy the whole thing including `tiktok-`.
  128. **Step 4.** Get your API key: click **Settings** (gear icon, bottom-left), then **API**, then **Create Key**. Copy the `sk_...` string.
  129. **Step 5.** Create a file called `.env` in the tiktok-skills folder:
  130. ```
  131. PUBLORA_API_KEY=sk_paste_your_key_here
  132. TIKTOK_PLATFORM_ID=tiktok-paste_your_id_here
  133. ```
  134. If you cloned the repo, copy the template instead:
  135. ```bash
  136. cp .env.example .env
  137. ```
  138. Then open `.env` and replace the placeholders with your real values.
  139. **Step 6.** Install two small Python packages:
  140. ```bash
  141. pip install requests python-dotenv
  142. ```
  143. **Step 7.** Test it. Ask Claude Code or Codex:
  144. > "Schedule a private (SELF_ONLY) test video via Publora using this file: ./test.mp4, 24 hours from now."
  145. If Publora returns a `postGroupId`, you're set. Use `SELF_ONLY` so nobody sees the test, and cancel it in the dashboard. If you get HTTP 401, your API key is wrong. If you get an `Invalid platform ID format` error, your `TIKTOK_PLATFORM_ID` is wrong. See [Troubleshooting](#troubleshooting).
  146. > **Two TikTok quirks to know:**
  147. > - **Boolean inversion bug.** Publora may map `allowComments` / `allowDuet` / `allowStitch` to TikTok's `disable_*` flags, so they can land inverted. Test with a `SELF_ONLY` draft before trusting them.
  148. > - **Unaudited apps post PRIVATE only.** Until the publishing app passes TikTok's review, every post is forced to `SELF_ONLY` regardless of your viewer setting.
  149. ## Optional: generate illustrations with Pixfaro
  150. A strong cover sells the video. The Caption Writer can generate a 9:16 cover with your hook text and attach it automatically when publishing. Without a key it drafts the image prompt and asks you to generate it yourself, so nothing breaks.
  151. [Pixfaro](https://pixfaro.com) is a single image API over multiple models (from `flux-schnell` at $0.004 to `gpt-5-image`). It composites your handle, brand color, or logo onto the image as a **pixel-exact overlay**, so a cheap base model still renders crisp text on a cover. Pull those brand fields from your [Voice & Brand Profile](references/voice-profile.md) (section 6) and every asset stays on-brand.
  152. Setup: drop `PIXFARO_TOKEN=pf_live_...` into your `.env`. The thin client at `lib/pixfaro_client.py` and the wrappers `lib.illustrate(prompt, kind="story")` / `lib.refine(image_id, instruction)` return a hosted URL that flows straight into `lib.publish(..., media_urls=[url])`. `refine` edits a prior image by its id (cheaper than regenerating); results carry `cost`, `balance_after`, and a `premium` flag so the skills never quietly spend on a pricey model.
  153. ## Optional: read real TikTok data with Apify
  154. `tt-audience-insights` scans a hashtag or a profile for videos with plays, likes, comments, shares and the sound, and pulls the commenters on a video. Without a read credential it asks you to paste what you can see, so nothing breaks.
  155. **With a shell**, drop a free token into your `.env`:
  156. ```
  157. APIFY_TOKEN=apify_api_...
  158. ```
  159. **On claude.ai**, where a skill has no environment to hold a token, add Apify's MCP server as a custom connector instead:
  160. ```
  161. https://mcp.apify.com?actors=clockworks/tiktok-scraper,clockworks/tiktok-comments-scraper
  162. ```
  163. Sign in with OAuth on first use, no key on disk. **Keep the `?actors=` filter**: the bare `https://mcp.apify.com` also hands the agent `search-actors` and `call-actor`, which run anything in the Apify Store at whatever that actor charges.
  164. TikTok does not expose who liked a video, only the count, so the engagement signal here is commenters plus video performance and never a liker roster. Details and the field mapping: [`references/mcp-read-layer.md`](references/mcp-read-layer.md).
  165. ## Voice rules
  166. Every skill follows these rules automatically:
  167. 1. Em dashes capped: about one per 100 words in the caption, at most one on a card, `..` for a breath in the spoken line. The character stopped being a tell in 2026; the density is.
  168. 2. Write the script the way a person talks: contractions, fragments, short lines. Read it out loud.
  169. 3. Capitalize names. Always. Lowercase a brand reads as careless.
  170. 4. No AI vocabulary clusters. One 2026 marker ("leverage", "significant", "streamline") in a beat is a slip; three in one beat is a script and gets rewritten. And no "hey guys" / "don't forget to subscribe".
  171. 5. Specific numbers beat adjectives. "3 takes" beats "a few takes".
  172. 6. The hook is the first 1-3 seconds of the video, not the caption. Spoken line and on-screen text differ.
  173. 7. Caption <= 2,200 chars (API). 3 to 5 mixed-reach hashtags at the end.
  174. ## Troubleshooting
  175. | Problem | Fix |
  176. |---|---|
  177. | Skills don't activate when I ask about TikTok | Make sure you installed via the Skills panel, `/plugin install`, or `codex plugin add`. Try a new conversation. |
  178. | "PUBLORA_API_KEY not set" | Your `.env` file is missing or in the wrong folder. It should be in the `tiktok-skills/` root. |
  179. | "401 Invalid API key" from Publora | Your API key is wrong or revoked. Go to Publora Settings > API > Create a new key. |
  180. | "Invalid platform ID format" | Your `TIKTOK_PLATFORM_ID` is wrong. Go to Publora Channels and copy the full `tiktok-...` string. |
  181. | My "public" post went out private | Unaudited apps can only post `SELF_ONLY`. The publishing app needs to pass TikTok's review for public posting. |
  182. | Duets are off when I asked for on | The known boolean inversion bug. Test with a `SELF_ONLY` draft, then send the opposite value as a workaround. |
  183. | My video got rejected | Check duration (3s to 10min on the API), format (MP4 / MOV / WebM), and frame rate (min 23 FPS). |
  184. | `pip install` fails | Use a virtual environment: `python -m venv venv && source venv/bin/activate && pip install requests python-dotenv` |
  185. ## Cross-cutting references
  186. - [`references/hook-formulas.md`](references/hook-formulas.md) - the 10 TikTok 3-second hook formulas with goal tags (completion, saves, comments, shares)
  187. - [`references/algorithm-heuristics.md`](references/algorithm-heuristics.md) - 2026 TikTok ranking signals: completion rate, rewatch, shares, sound timing
  188. - [`references/voice-rules.md`](references/voice-rules.md) - the canonical voice rules every skill inherits (spoken script, on-screen text, caption)
  189. ---
  190. <details>
  191. <summary><b>For developers: runtime compatibility, URL parsing, and internals</b></summary>
  192. ## Runtime compatibility
  193. ```
  194. tiktok-skills/
  195. skills/ SKILL.md frontmatter; native to Claude Code and Codex, others read as markdown
  196. .codex-marketplace/ generated nested Codex package (run scripts/sync_codex_marketplace.py)
  197. lib/ pure Python, works in any agent runtime
  198. references/ pure markdown, works anywhere
  199. scripts/ pure Python CLI, works anywhere
  200. ```
  201. | Runtime | Auto-discovers skills? | Setup |
  202. |---|---|---|
  203. | **Claude Code** (CLI, Desktop, Web, IDE) | Yes | Install via plugin or clone. Skills activate on matching prompts. |
  204. | **Codex CLI** | Yes | `codex plugin marketplace add sergebulaev/tiktok-skills` and `codex plugin add tiktok-skills@tiktok-skills`. |
  205. | **Anthropic Managed Agents** (`/v1/agents`) | Yes | Pass skill files in the agent context. |
  206. | **Cursor / Cline / Aider** | Manual | Read `SKILL.md` files as prompt context; import `lib/` as Python. |
  207. | **LangChain / AutoGen** | No | Use `lib/` as a package; feed `references/` as prompt context. |
  208. ## Generic Python agent quickstart
  209. ```python
  210. import sys; sys.path.insert(0, "path/to/tiktok-skills")
  211. from lib import parse_tiktok_url, PubloraClient, tiktok_settings, publish
  212. parsed = parse_tiktok_url("https://www.tiktok.com/@levelsio/video/7300000000000000000")
  213. print(parsed["handle"], parsed["video_id"]) # levelsio 7300000000000000000
  214. # Write side (Publora) - full video flow: draft -> upload -> schedule
  215. client = PubloraClient() # reads PUBLORA_API_KEY from env
  216. client.publish_video(
  217. content="how I edited 30 videos in a weekend (the batching system) #editing #contentcreator",
  218. platforms=["tiktok-7123456789"],
  219. video_path="./render.mp4",
  220. scheduled_time="2026-07-01T17:00:00.000Z",
  221. platform_settings=tiktok_settings(viewer_setting="PUBLIC_TO_EVERYONE"),
  222. )
  223. # Or the high-level wrapper that handles manual / Publora / diy routing
  224. publish("video", draft_text="caption here", target_url="https://www.tiktok.com/upload",
  225. video_path="./render.mp4", platforms=["tiktok-7123456789"])
  226. ```
  227. ## URL handling
  228. `lib/url_parser.py` parses TikTok video, profile, and short-share URLs:
  229. | URL fragment | Parsed |
  230. |---|---|
  231. | `tiktok.com/@HANDLE/video/ID` | `{handle, video_id, url_type: "video"}` |
  232. | `vm.tiktok.com/CODE/` | `{short_code, url_type: "short"}` (open to resolve the id) |
  233. | `tiktok.com/t/CODE/` | `{short_code, url_type: "short"}` |
  234. | `tiktok.com/@HANDLE` | `{handle, url_type: "profile"}` |
  235. ```bash
  236. python lib/url_parser.py "https://www.tiktok.com/@levelsio/video/7300000000000000000"
  237. ```
  238. Short share links (`vm.tiktok.com`, `tiktok.com/t/`) redirect to the canonical URL. The parser does not make network calls, so open the link to recover the numeric video id.
  239. ## Why publishing is a multi-step flow
  240. TikTok requires media on every post, and the upload is a pre-signed S3 PUT, not a field on `create-post`. So the client creates a draft, requests an upload URL, PUTs the file, then sets the scheduled time. `publish_video` chains all four; `lib.publish` falls back to a caption copy-paste block when no video file is supplied.
  241. </details>
  242. ## References
  243. - [Publora API docs](https://docs.publora.com/?utm_source=github&utm_medium=readme&utm_campaign=tiktok-skills) - endpoint reference for the publishing layer
  244. - [TikTok Content Posting API](https://developers.tiktok.com/doc/content-posting-api-reference-direct-post) - the official API behind the 2026 heuristics
  245. ## Who builds this
  246. These skills come out of [Creative Content Crafts](https://cccrafts.ai), an engineering company. We build the machinery underneath a company's public voice: ICP parsing, engagement systems, content guardrails, and posting infrastructure. We do not sell the words themselves.
  247. We call that layer **content engineering**. Writing collapsed to the price of a chat subscription. What stayed valuable is everything below it: pulling every post your market wrote this week, keeping a live list of the people who matter, engaging on it daily with judgment in the loop, and catching the risky drafts before the platform does.
  248. This repo is the thin top layer of that stack, open-sourced. The engine underneath is what we build for clients.
  249. ## License
  250. MIT. Powered by [Publora](https://publora.com/?utm_source=github&utm_medium=readme&utm_campaign=tiktok-skills).
  251. ## Related open-source skill bundles
  252. Part of a family of AI social-media marketing skill bundles for Claude Code and Codex:
  253. - [linkedin-skills](https://github.com/sergebulaev/linkedin-skills) - LinkedIn
  254. - [x-skills](https://github.com/sergebulaev/x-skills) - X (Twitter)
  255. - [instagram-skills](https://github.com/sergebulaev/instagram-skills) - Instagram
  256. - [youtube-skills](https://github.com/sergebulaev/youtube-skills) - YouTube
  257. - [threads-skills](https://github.com/sergebulaev/threads-skills) - Threads
  258. - **tiktok-skills - TikTok (this repo)**
  259. - [facebook-skills](https://github.com/sergebulaev/facebook-skills) - Facebook Pages
  260. Also: [Anthropic Skills repo](https://github.com/anthropics/skills), the `awesome-claude-skills` directory.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.