Skip to content
Back to search

hook-lab

Claude Code skill:拆解短视频的 hook、脚本结构和爆款逻辑,输出适配小红书 / 视频号的改写方向

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hongfamonvai--hook-lab/badge.svg)](/listings/hongfamonvai--hook-lab)

HTML

<a href="/listings/hongfamonvai--hook-lab"><img src="/api/listings/hongfamonvai--hook-lab/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.

cp -r hook-lab ~/.claude/skills/hook-lab
pip3 install yt-dlp

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.

SKILL.md · Manifest · 122 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: hook-lab
  3. description: "Use when the user gives a TikTok/Instagram Reels/YouTube Shorts URL (or runs /analyze <url>) and wants to know why the video works — extracts metadata and transcript, then breaks down hook, script structure, style tags, viral factors, and rewrite angles for Chinese platforms."
  4. ---
  5. # /analyze — 短视频内容拆解
  6. ## Input
  7. `$ARGUMENTS` = 一个视频 URL(TikTok / Instagram Reels / YouTube Shorts)。
  8. 如果用户没有提供 URL,问他要。
  9. ## Step 1: Extract
  10. 运行提取脚本:
  11. ```bash
  12. python3 ~/.claude/skills/hook-lab/scripts/analyze-video.py "$ARGUMENTS"
  13. ```
  14. 脚本返回 JSON,包含:
  15. - `platform`: tiktok / instagram / youtube
  16. - `metadata`: 标题、描述、作者、播放量、点赞、评论、时长等
  17. - `transcript`: 视频字幕/转写文本(可能为 null)
  18. ### 提取失败的回退策略
  19. 如果 `metadata._error` 存在,按以下顺序尝试回退:
  20. **回退 1 — WebFetch**:
  21. 用 WebFetch 工具访问视频 URL,prompt 设为:
  22. > "Extract all video metadata: title, description, author name, author handle, view count, like count, comment count, share count, duration, and any transcript/caption text visible on the page."
  23. **回退 2 — 用户提供信息**:
  24. 如果 WebFetch 也拿不到数据,请用户提供:
  25. - 视频的文案/字幕文本(可以从视频里手动复制)
  26. - 基本数据(播放量、点赞数等,截图也行)
  27. 拿到任何数据后继续分析,在输出开头注明数据来源和完整度。
  28. ## Step 2: Analyze
  29. 基于提取到的数据,进行以下分析。用中文输出。
  30. ### 2.1 基础数据面板
  31. 用表格展示关键指标:平台、作者、时长、播放量、点赞、评论、转发。
  32. 计算互动率 = (like + comment) / view。
  33. ### 2.2 Hook 分析(前 3 秒)
  34. 从 transcript 的前 1-3 句提取 hook 文案,分析:
  35. - **Hook 类型**: curiosity gap / shocking stat / bold claim / question / visual hook / pattern interrupt
  36. - **Hook 强度判断**: 为什么能让人停下来
  37. - **可优化空间**: 如果 hook 不够强,给出改写建议
  38. 如果没有 transcript,从 description 和 title 推断 hook 策略。
  39. ### 2.3 脚本结构拆解
  40. 将 transcript 按叙事结构分段:
  41. | 段落 | 时间估算 | 内容 | 作用 |
  42. |------|----------|------|------|
  43. 典型结构:Hook → Problem/Context → Solution/Reveal → Proof/Example → CTA
  44. 分析脚本节奏:信息密度是否合理、转折点在哪、哪里容易流失观众。
  45. ### 2.4 风格与格式标签
  46. 给视频打标签(多选):
  47. - **呈现方式**: talking head / voiceover / text-on-screen / skit / montage / screencast / interview
  48. - **内容类型**: educational / entertainment / storytelling / review / tutorial / hot-take / news
  49. - **情绪基调**: 紧迫 / 好奇 / 幽默 / 震惊 / 共鸣 / 权威
  50. ### 2.5 为什么这条视频能爆
  51. 综合分析 2-3 个核心原因。要具体,不要泛泛而谈。
  52. 比如不要说「因为内容好」,要说「开头用了具体数字制造反差($0 → $10K),3 秒内给出明确价值承诺」。
  53. ### 2.6 可借鉴的改写方向
  54. 给出 3 个具体的改写角度,每个包含:
  55. - **角度**: 一句话概述
  56. - **Hook 示例**: 写出改写后的 hook 文案
  57. - **适合平台**: TikTok / Instagram / 小红书 / 视频号
  58. 改写方向要考虑中文创作者的场景。
  59. ## Step 3: Output
  60. 按上面 2.1-2.6 的顺序输出完整分析。格式用 markdown 表格和分段标题,清晰可读。
  61. 最后附一行:
  62. > 数据来源:yt-dlp 提取 | 分析模型:Claude
  63. ## Step 4: 记录到结果库
  64. 分析完成后,往 `~/.claude/skills/hook-lab/results/analyzed-videos.md` 追加一条记录(直接 Append,不要覆盖已有内容),格式:
  65. ```markdown
  66. ## [YYYY-MM-DD] 作者 — 标题/主题 (平台)
  67. - URL: <原始链接>
  68. - 数据: 播放 X / 赞 X / 评论 X / 转发 X
  69. - Hook 类型: ...
  70. - 为什么能爆: 一句话核心结论
  71. - 可借鉴方向: 一句话核心结论
  72. ---
  73. ```
  74. 这个文件是跨视频对比的素材库——后续如果用户要"把分析过的几条放一起找规律",直接读这个文件,不用重新跑提取。
  75. ## Notes
  76. - 如果没有 transcript,在输出开头注明「未能提取字幕,以下分析基于元数据和描述文本」,分析照做但标注信息置信度较低
  77. - 不要编造数据,metadata 里没有的指标标注「N/A」
  78. - 互动率计算如果缺少 view_count 就跳过
  79. - 全程用中文输出,技术术语保留英文(hook、CTA、talking head 等)
README.md · README · 42 lines

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

  1. # hook-lab
  2. 分析 TikTok / Instagram Reels / YouTube Shorts 视频,拆解 hook、脚本结构、爆款原因,并给出适配中文平台的改写方向。
  3. ## 使用方式
  4. 在 Claude Code 里运行:
  5. ```
  6. /analyze https://www.tiktok.com/@someone/video/1234567890
  7. /analyze https://www.instagram.com/reel/abcDEF123/
  8. /analyze https://www.youtube.com/shorts/abcdefg
  9. ```
  10. ## 输出内容
  11. 1. **数据面板** — 播放量、点赞、评论、转发、互动率
  12. 2. **Hook 拆解** — Hook 类型、为什么能让人停下来、改写建议
  13. 3. **脚本结构** — 按叙事逻辑分段,标注各段作用和节奏
  14. 4. **风格标签** — 呈现方式、内容类型、情绪基调
  15. 5. **为什么能爆** — 2-3 个具体原因,不泛泛而谈
  16. 6. **改写方向** — 3 个可落地的角度,含 hook 示例和适配平台
  17. 每次分析结果自动追加到 `results/analyzed-videos.md`,供跨视频对比使用。
  18. ## 安装
  19. ```bash
  20. cp -r hook-lab ~/.claude/skills/hook-lab
  21. pip3 install yt-dlp
  22. ```
  23. ## 提取失败时的回退
  24. 1. yt-dlp 失败 → 尝试带 Chrome cookie 重试
  25. 2. TikTok 仍失败 → 解析页面内嵌 JSON
  26. 3. 以上均失败 → Claude 用 WebFetch 抓取页面
  27. 4. 全部失败 → 提示用户手动粘贴文案和数据
  28. ## License
  29. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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