How do I install the Tiktok Obsidian skill?

Run npx skillmds@latest add martin-pv/tiktok-obsidian in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tiktok Obsidian safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tiktok Obsidian?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tiktok Obsidian free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tiktok Obsidian?

martin-pv (@martin-pv) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tiktok Obsidian by martin-pv — Agent Skill

Name: Tiktok Obsidian
Rating: 4.2 (5 reviews)
Author: martin-pv

Tiktok Obsidian

Turn a TikTok URL into a markdown note in an Obsidian vault using the TikToker whisper-scripts (local Whisper + yt-dlp). Use when the user pastes a TikTok link in Claude Code and wants transcription saved to Obsidian, or to batch-ingest TikToks without using the Obsidian UI.

martin-pv Updated Sep 22, 2026

File contents

TikTok → Obsidian (Claude Code)

The Obsidian TikToker plugin only runs inside Obsidian. This skill uses the same scripts the plugin ships with (whisper-scripts/) so Claude Code can produce notes on disk that Obsidian will show as soon as the vault refreshes.

What you cannot do from Claude Code

Call Obsidian plugin APIs, modals, or “Save via TikToker” inside the app.
Get the exact same rich metadata/embed as the plugin unless you duplicate its oEmbed + template logic.

What this skill does

Run local transcription (audio via yt-dlp, text via faster-whisper in the plugin venv).
Write a .md file into the vault with YAML frontmatter + ## Transcription.

Configuration (edit if your paths differ)

Variable	Default
Vault root	`/Users/martinp/clawd/SecondBrain`
Notes folder	`Tiktoks` (matches common TikToker `outputFolder`)
Script	`$VAULT/.obsidian/plugins/tiktoker/whisper-scripts/tiktok2text.sh`
Browser for cookies	`safari` (use `-b chrome` if TikTok login is only in Chrome)

Procedure (run in terminal)

Transcribe (stdout is the transcript; stderr has Saved: …txt):

WHISPER="/Users/martinp/clawd/SecondBrain/.obsidian/plugins/tiktoker/whisper-scripts/tiktok2text.sh"
URL="PASTE_TIKTOK_URL_HERE"
"$WHISPER" -o /tmp "$URL"

(Default is Safari cookies; same as tiktok2text.sh. For Chrome: add -b chrome.)

Use -o /tmp so the .txt lands in /tmp and is easy to find, or omit -o and read the path from stderr (Saved: …).

Video id from the URL: the numeric segment after /video/ (e.g. 7591638352298855694).
Build the note at
$VAULT/Tiktoks/YYYY-MM-DD tiktok <video_id>.md
(or any naming the user prefers) with:

---
url: "CANONICAL_TIKTOK_URL"
date: YYYY-MM-DD
---

## Transcription

PASTE_TRANSCRIPT_FROM_STDOUT_OR_TXT_FILE

Strip tracking junk from url in frontmatter if you want cleaner links (optional): keep up to /video/<id>.

Reliability

Cookies: Default is Safari. If download fails, try -b chrome or ensure the user is logged into TikTok in that browser (Terminal may need Full Disk Access to read Safari cookies).
PATH: If python3 / yt-dlp fail when not in Obsidian, run from a normal Terminal (or use the same PATH fix as in tiktok2text.sh — Homebrew + ~/.pyenv/shims).
Timeouts: Long videos take longer; Whisper model is controlled with -m tiny|base|small|… (default in script is base).

Optional: match TikToker embed

To mirror the plugin’s iframe note body, fetch oEmbed (https://www.tiktok.com/oembed?url=...) and add the returned html in a ## Video section above ## Transcription. The plugin does more (author, hashtags); oEmbed gives title/author/thumbnail/embed HTML only.

---name: tiktok-obsidiandescription: Turn a TikTok URL into a markdown note in an Obsidian vault using the TikToker whisper-scripts (local Whisper + yt-dlp). Use when the user pastes a TikTok link in Claude Code and wants transcription saved to Obsidian, or to batch-ingest TikToks without using the Obsidian UI.---# TikTok → Obsidian (Claude Code)The Obsidian **TikToker plugin** only runs inside Obsidian. This skill uses the **same scripts** the plugin ships with (`whisper-scripts/`) so Claude Code can produce notes on disk that Obsidian will show as soon as the vault refreshes.## What you cannot do from Claude Code- Call Obsidian plugin APIs, modals, or “Save via TikToker” inside the app.- Get the exact same rich metadata/embed as the plugin unless you duplicate its oEmbed + template logic.## What this skill does1. Run local transcription (audio via `yt-dlp`, text via `faster-whisper` in the plugin venv).2. Write a `.md` file into the vault with YAML frontmatter + `## Transcription`.## Configuration (edit if your paths differ)| Variable | Default ||----------|---------|| Vault root | `/Users/martinp/clawd/SecondBrain` || Notes folder | `Tiktoks` (matches common TikToker `outputFolder`) || Script | `$VAULT/.obsidian/plugins/tiktoker/whisper-scripts/tiktok2text.sh` || Browser for cookies | `safari` (use `-b chrome` if TikTok login is only in Chrome) |## Procedure (run in terminal)1. **Transcribe** (stdout is the transcript; stderr has `Saved: …txt`):```bashWHISPER="/Users/martinp/clawd/SecondBrain/.obsidian/plugins/tiktoker/whisper-scripts/tiktok2text.sh"URL="PASTE_TIKTOK_URL_HERE""$WHISPER" -o /tmp "$URL"```(Default is Safari cookies; same as `tiktok2text.sh`. For Chrome: add `-b chrome`.)Use `-o /tmp` so the `.txt` lands in `/tmp` and is easy to find, or omit `-o` and read the path from stderr (`Saved: …`).2. **Video id** from the URL: the numeric segment after `/video/` (e.g. `7591638352298855694`).3. **Build the note** at `$VAULT/Tiktoks/YYYY-MM-DD tiktok <video_id>.md` (or any naming the user prefers) with:```markdown---url: "CANONICAL_TIKTOK_URL"date: YYYY-MM-DD---## TranscriptionPASTE_TRANSCRIPT_FROM_STDOUT_OR_TXT_FILE```4. Strip tracking junk from `url` in frontmatter if you want cleaner links (optional): keep up to `/video/<id>`.## Reliability- **Cookies:** Default is Safari. If download fails, try `-b chrome` or ensure the user is logged into TikTok in that browser (Terminal may need Full Disk Access to read Safari cookies).- **PATH:** If `python3` / `yt-dlp` fail when not in Obsidian, run from a normal Terminal (or use the same PATH fix as in `tiktok2text.sh` — Homebrew + `~/.pyenv/shims`).- **Timeouts:** Long videos take longer; Whisper model is controlled with `-m tiny|base|small|…` (default in script is `base`).## Optional: match TikToker embedTo mirror the plugin’s iframe note body, fetch oEmbed (`https://www.tiktok.com/oembed?url=...`) and add the returned `html` in a `## Video` section above `## Transcription`. The plugin does more (author, hashtags); oEmbed gives title/author/thumbnail/embed HTML only.

Frequently asked questions