AGENT SKILL

tiktok-video-analyzer

暂无简介

License 许可
MIT
最近更新
2026-06-07
Stars
★ 0
Forks
1

03 SKILL.md 正文

Video Analyzer Skill

Analyze any video by dropping a URL. Works with TikTok, YouTube, Instagram, Twitter/X, and 1000+ other sites. Transcribes the audio locally and answers any question about the content.


When to Use This Skill

Activate when the user:


⚠️ CRITICAL RULES — READ BEFORE ANYTHING ELSE

Rule 1 — FIRST MESSAGE IS ALWAYS THIS, NO EXCEPTIONS:

Use the message tool to send this BEFORE running any exec command:

📡 Video received, analyzing...

This must be a message tool call, not your final reply text. Using the message tool sends it immediately to the user while you continue processing. If you put it in your reply text instead, the user won't see it until everything is done — which defeats the purpose entirely.

Do NOT reference conversation history, prior testing, or anything from the current session. Every URL is treated fresh.

Rule 2 — NEVER GO SILENT The user MUST receive a message every 30-60 seconds while processing. Silence = broken.

  • After download step: send "📥 Downloaded! Transcribing now..."
  • If anything takes more than 30 seconds: send "⏳ Still working..."

Rule 3 — NO PERSONAL COMMENTARY. EVER. Do NOT add ANY of the following:

  • "This appears to be the video we already tested"
  • "I recognize this URL" / "you've sent this before"
  • "Heads up — this is the same link"
  • Any footnote, parenthetical, or aside about the URL or prior usage

Just run the skill and give the answer. End with the save prompt. Nothing else. If the transcript is cached: say "📚 Found in your library!" then answer. That's it.

Rule 4 — First-run warning If the transcripts folder is empty (first ever run), warn upfront:

⚠️ First time running — downloading the AI model (~150MB). Takes 2-4 minutes once, never again.


Prerequisites Check

Before the first run, check if dependencies are installed:

which ffmpeg && python3 -c "import faster_whisper; print('ok')" && python3 -c "import yt_dlp; print('ok')"

If anything is missing, guide the user:

Mac/local:

brew install ffmpeg
pip3 install faster-whisper yt-dlp --break-system-packages

Linux/VPS:

apt install -y ffmpeg
pip install faster-whisper yt-dlp --break-system-packages

Flow

Step 1 — Acknowledge IMMEDIATELY (before anything else)

Send: 📡 Video received, analyzing...

Step 1b — First run warning

If this looks like the first time (no cached transcripts exist), warn the user:

⚠️ First time running — the AI transcription model needs to download (~150MB). This takes 2-4 minutes once and never again. Grab a coffee ☕

Step 2 — Download (step 1 of 2)

python3 ~/.openclaw/skills/tiktok-analyzer/transcribe.py --download-only "URL_HERE"

Returns JSON with status: "downloaded" and video_id. If from_cache: true + skip_transcribe: true → go straight to Step 3, skip Step 2b.

Step 2b — Send progress message (via message tool), then transcribe

Use the message tool to send: 📥 Downloaded! Transcribing now...

Then immediately run:

python3 ~/.openclaw/skills/tiktok-analyzer/transcribe.py --transcribe-only "VIDEO_ID"

Replace VIDEO_ID with the video_id from the previous step.

Returns JSON:

{
  "transcript": "full text here...",
  "language": "en",
  "video_id": "abc123",
  "from_cache": false
}

If from_cache: true (from Step 2) → say "📚 Found this in your library — instant answer!" and skip the wait messages.

If there's an "error" key → relay it cleanly (never show a Python stacktrace to the user).

Step 3 — Answer the question

Use the transcript to answer whatever they asked. If no specific question, provide:

  • What it's about (1-2 sentences)
  • Key points / what's being taught (bullet list)
  • Tone / style (educational, entertainment, story, etc.)

Step 4 — Offer to save (MANDATORY if from_cache: false)

After giving the answer, ALWAYS ask this — do not skip it:

💾 Want to save this transcript so you can ask follow-up questions later without re-downloading? (yes/no)

Only skip this if from_cache: true (already saved).

If yes:

python3 ~/.openclaw/skills/tiktok-analyzer/save_transcript.py "VIDEO_ID" 'JSON_DATA'

Confirm: ✅ Saved to your video library!


Searching Saved Transcripts

When the user asks about something they've analyzed before:

  1. List files in ~/.openclaw/skills/tiktok-analyzer/transcripts/
  2. Read the relevant .json file(s)
  3. Answer from the saved transcript

Error Handling

Error Response
Private/removed video "This video is private or has been removed. Try a different URL."
No ffmpeg "You need ffmpeg. Run: brew install ffmpeg (Mac) or apt install ffmpeg (Linux)"
No faster-whisper "Run: pip install faster-whisper yt-dlp then try again."
Timeout / very long video "That one's taking a while — try a shorter clip or check your connection."

Demo Tips

  • For demos: Use a video you've already analyzed (cache hit = instant response, looks great)
  • First run: Always warn upfront about the 150MB model download
  • Works on any platform yt-dlp supports — TikTok, YouTube, Instagram, Twitter, Reddit, Vimeo, and 1000+ more

04 同仓库更多 Skills

javimosch
javimosch/open-claw-skills

crowd-prompting

A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.

★ 0
javimosch
javimosch/open-claw-skills

ceaser

Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).

★ 0
javimosch
javimosch/open-claw-skills

ceaser-send

Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.

★ 0
javimosch
javimosch/open-claw-skills

dilemm-ai

Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

arxiv-paper-reviews

Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.

★ 0