Agent skill

Tiktok Transcribe

by chubbyguan in chubbyguan/chubbyskills

TikTok 视频 → 下载 → 转录 → 存为 Markdown. An agent skill from chubbyguan/chubbyskills.

MITAuto-check: notesMedia & Creative

Install Tiktok Transcribe

skills CLI
$ npx skills add chubbyguan/chubbyskills --skill tiktok-transcribe -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install chubbyguan/chubbyskills tiktok-transcribe --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/chubbyguan/chubbyskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tiktok-transcribe .claude/skills/tiktok-transcribe && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tiktok-transcribe
GitHub stars
1.2k
Token cost
~536 tokens
SKILL.md length
58 words
Files
3 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

TikTok 视频 → 下载 → 转录 → 存为 Markdown. An agent skill from chubbyguan/chubbyskills.

  • Works in 3 steps: yt-dlp 下载音频 → SenseVoice-Small 转录 → 生成 Markdown
  • Tasks that involve Transcription
  • SKILL.md covers 环境要求, 使用方法, 流程 and 已知限制, plus 2 more sections
  • Runs Python scripts from its folder; calls python, pip and yt-dlp; reaches vm.tiktok.com and tiktok.com

What it does

Tiktok Transcribe is an agent skill from chubbyguan/chubbyskills. TikTok 视频 → 下载 → 转录 → 存为 Markdown。 支持 vm.tiktok.com / vt.tiktok.com 短链和完整链接,无需登录。

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/transcribe.py`).

It sits in Media & Creative, covering Transcription and Markdown. It works with TikTok. The repository describes itself as: 把中文全渠道内容(抖音 / B站 / 小红书 / 公众号 / X / 播客)采集进个人知识库的 14 个 AI Skill:图文存图、视频转文字稿、字幕优先免 GPU、RSS/YouTube 订阅调度与每日情报简报,附带知识库 MCP server。| Ingest Chinese content into your personal knowledge… The licence is MIT.

When your agent uses it

  • Tasks that involve Transcription
  • Tasks that involve Markdown

Example prompts

  • “/tiktok-transcribe”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. yt-dlp 下载音频
  2. SenseVoice-Small 转录
  3. 生成 Markdown

What it can do on your machine

Read from SKILL.md and the folder at commit 1b759b1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip
    • yt-dlp

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • vm.tiktok.com
    • tiktok.com
    • vt.tiktok.com

    Also links to:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tiktok Transcribe loads about 536 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 58 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~536

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:29
    # Ubuntu: sudo apt install ffmpeg && pip install yt-dlp

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from chubbyguan/chubbyskills at commit 1b759b1, republished under its MIT licence (© chubbyguan). 58 words, ~536 tokens.

Download SKILL.mdSave it as .claude/skills/tiktok-transcribe/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
tiktok-transcribe
description
TikTok 视频 → 下载 → 转录 → 存为 Markdown。 支持 vm.tiktok.com / vt.tiktok.com 短链和完整链接,无需登录。
metadata.category
media
metadata.triggers
["用户发送 TikTok 视频链接", "把这个 TikTok 转成文字", "帮我转录这个 TikTok"]
metadata.version
1.0.0
metadata.tags
[media, video, transcription, tiktok]

TikTok 视频转录 Skill

将 TikTok 视频下载音频,用 SenseVoice-Small 转录为文字,存为带 frontmatter 的 Markdown 文件。内容中英混杂时自动检测语言。

环境要求

bash
# Python 3.9+
python -m venv .venv
source .venv/bin/activate

# 依赖
pip install funasr modelscope torch torchaudio

# 系统依赖
# macOS: brew install ffmpeg yt-dlp
# Ubuntu: sudo apt install ffmpeg && pip install yt-dlp

使用方法

bash
# 完整链接
python scripts/transcribe.py "https://www.tiktok.com/@user/video/1234567890"

# 短链(自动跟随跳转)
python scripts/transcribe.py "https://vm.tiktok.com/xxxxx"
python scripts/transcribe.py "https://vt.tiktok.com/xxxxx"

# 指定输出目录
python scripts/transcribe.py "https://vm.tiktok.com/xxxxx" -o ./output

流程

Step 1: yt-dlp 下载音频

TikTok 有地区限制,脚本默认加 --geo-bypass。短链由 yt-dlp 自动跟随跳转,无需手动处理。

bash
yt-dlp --extract-audio --audio-format mp3 --audio-quality 128K \
  --geo-bypass \
  "https://vm.tiktok.com/xxxxx"
Step 2: SenseVoice-Small 转录
python
from funasr import AutoModel

model = AutoModel(
    model="iic/SenseVoiceSmall",
    trust_remote_code=True,
    vad_model="fsmn-vad",
    vad_kwargs={"max_single_segment_time": 30000},
    device="cpu",
)

result = model.generate(
    input=audio_path,
    language="auto",   # TikTok 中英混杂,自动检测
    use_itn=True,
    batch_size_s=60,
)
Step 3: 生成 Markdown

脚本自动创建带 frontmatter 的 Markdown 文件,包含来源链接、作者、语言和转录文本。

已知限制

  • 地区限制:部分地区或网络环境下 TikTok 内容可能无法访问,--geo-bypass 可缓解但不保证解决
  • 反爬:频繁请求可能触发限流;脚本内置重试,仍建议控制频率
  • 语言混合:language=auto 对中英混杂内容可用,但长英文段落质量不如专用英文模型
  • 登录态:私密账号内容需要登录,当前脚本不携带登录态
  • 模型大小:SenseVoice-Small 首次下载约 893MB

致谢

⚖️ 合规声明

仅供个人学习与研究使用。请遵守目标平台的服务条款(ToS)与 robots 规则,控制请求频率,不要用于批量抓取、商用爬取或侵犯他人权益的场景。下载内容的版权归原作者所有。

© chubbyguan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in tiktok-transcribe of chubbyguan/chubbyskills.

  • SKILL.md
  • requirements.txt
  • scripts/transcribe.py

Open the folder on GitHubat commit 1b759b1

Compare with similar skills

Tiktok Transcribe next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tiktok Transcribe compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tiktok Transcribe this skillchubbyguan/chubbyskills1.2k—~536Automated safety check: NotesMIT
Youtube FetcherJimmySadek/youtube-fetcher-to-markdown485—~3.1kAutomated safety check: PassMIT
Watching Videosoxbshw/watch-skill470—~599Automated safety check: NotesMIT
Subtitle BurningOtoDock/oto-dock190—~1.1kAutomated safety check: PassCustom licence
Audio Transcriberaiskillstore/marketplace4334 repos~3.7kAutomated safety check: PassNone
Analyze Socialccplugins/awesome-claude-code-plugins970—~1.1kAutomated safety check: WarnApache-2.0

Similar skills

  • Youtube Fetcher

    JimmySadek/youtube-fetcher-to-markdown

    Retrieve transcripts from YouTube, Instagram, TikTok, X, Vimeo and other video sites, summarize or analyze what was said (and shown on screen), or save an Obsidian-ready Markdown knowledge-base note…

    485 GitHub stars~3.1k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Watching Videos

    oxbshw/watch-skill

    The user shared a video URL, a YouTube/TikTok/stream link, a local video file, a screen recording, a meeting recording, or a playlist/folder of videos — "watch this", "summarize this video", "what's…

    470 GitHub stars~599 tokensUpdated 26 days ago
    Media & CreativeAuto-check: notes
  • Subtitle Burning

    OtoDock/oto-dock

    Transcribe audio and burn styled subtitles into videos. An agent skill from OtoDock/oto-dock.

    190 GitHub stars~1.1k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Audio Transcriber

    aiskillstore/marketplace

    Transform audio recordings into professional Markdown documentation with intelligent summaries using LLM integration

    433 GitHub starsUsed in 4 repos~3.7k tokens
    Media & CreativeAuto-check passed
  • Analyze Social

    ccplugins/awesome-claude-code-plugins

    A skill your agent uses when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts…

    970 GitHub stars~1.1k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: warnings
  • Watch

    TheCraigHewitt/skills

    When the user wants to read, transcribe, summarize, or research a video — YouTube link, podcast clip, Loom, TikTok, X/Twitter video, local file, or any URL yt-dlp supports.

    159 GitHub stars~1.6k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: notes

More from chubbyguan/chubbyskills

All 14 skills in this repo
  • Bilibili Transcribe

    chubbyguan/chubbyskills

    哔哩哔哩视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~578 tokensUpdated 3 days ago
    Auto-check: notes
  • Douyin Transcribe

    chubbyguan/chubbyskills

    抖音视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~551 tokensUpdated 3 days ago
    Auto-check: notes
  • Industry Intelligence Radar

    chubbyguan/chubbyskills

    行业情报雷达:多源扫描(X/即刻/V2EX/HN) → 关键词过滤 → 趋势检测 → 每日情报简报。触发词:行业情报、竞品监控、热点扫描、情报雷达

    1.2k GitHub stars~806 tokensUpdated 3 days ago
    Auto-check passed
  • Knowledge Base Management

    chubbyguan/chubbyskills

    管理本地 Markdown/Obsidian 知识库:素材入库、健康检查、增量索引、关键词与 semantic-lite 检索、逐字原文资料包、归档和 MCP 连接。用于搜索知识库、整理资料及为 Agent 准备可定位的引用。

    1.2k GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed
  • Learning Notes Automation

    chubbyguan/chubbyskills

    学习笔记自动化:视频/播客转录 → 知识点提取 → 闪卡生成 → 知识图谱更新。触发词:学习笔记、闪卡、Anki、知识提取、视频学习

    1.2k GitHub stars~898 tokensUpdated 3 days ago
    Auto-check passed
  • Podcast Transcribe

    chubbyguan/chubbyskills

    播客/小宇宙 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check: notes

Works with

Questions about Tiktok Transcribe

What does Tiktok Transcribe do?

TikTok 视频 → 下载 → 转录 → 存为 Markdown. An agent skill from chubbyguan/chubbyskills. Tiktok Transcribe is an agent skill from chubbyguan/chubbyskills.

When should I use Tiktok Transcribe?

Tiktok Transcribe fits situations like: tasks that involve Transcription; tasks that involve Markdown.

How do I install Tiktok Transcribe in Claude Code?

Run `npx skills add chubbyguan/chubbyskills --skill tiktok-transcribe -a claude-code`. Or copy the skill folder (tiktok-transcribe in chubbyguan/chubbyskills) into .claude/skills/tiktok-transcribe in your project. Claude Code loads it when a task matches its description.

How do I install Tiktok Transcribe in Codex?

Run `npx skills add chubbyguan/chubbyskills --skill tiktok-transcribe -a codex`. Or copy the skill folder (tiktok-transcribe in chubbyguan/chubbyskills) into .agents/skills/tiktok-transcribe in your project. Codex loads it when a task matches its description.

Can I use Tiktok Transcribe in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add chubbyguan/chubbyskills --skill tiktok-transcribe -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tiktok-transcribe, .gemini/skills/tiktok-transcribe, .github/skills/tiktok-transcribe and .opencode/skills/tiktok-transcribe in your project.

What does Tiktok Transcribe need to run?

Going by SKILL.md and its folder, Tiktok Transcribe needs Python for the scripts in its folder and the command-line tools its instructions call (python, pip and yt-dlp). Our summary lists: Python 3.

Does Tiktok Transcribe access the network?

SKILL.md names 4 domains. In commands or code: vm.tiktok.com, tiktok.com and vt.tiktok.com; the agent is likely to contact these when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Tiktok Transcribe safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tiktok Transcribe use?

Tiktok Transcribe is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tiktok Transcribe use?

About 536 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tiktok Transcribe?

Skills that share tags, products or a category with Tiktok Transcribe: Youtube Fetcher (JimmySadek/youtube-fetcher-to-markdown, 485 stars), Watching Videos (oxbshw/watch-skill, 470 stars), Subtitle Burning (OtoDock/oto-dock, 190 stars) and Audio Transcriber (aiskillstore/marketplace, 433 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tiktok Transcribe?

chubbyguan (a GitHub user) maintains it in chubbyguan/chubbyskills, which has 1,217 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

Source: chubbyguan/chubbyskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.