video-notes-generator

video-notes-generator is a skill for Claude Code, Codex from DDDFXYqiming/Agent_Extensions. It costs 66 tokens per session (2,266 once invoked), scanned A, original, MIT.

A tool that turns a video URL or local video file into structured Markdown notes. It can use subtitles or speech transcription and can extract selected video frames for visual analysis.

In plain words
What is it for?
Use it with Bilibili, YouTube, Douyin, Kuaishou, or local videos to create summaries, transcripts, timestamps, and frame-based observations.
Why use it?
It saves you from manually watching, transcribing, and organizing a video when you need searchable notes or a summary.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/dddfxyqiming/agent_extensions/video-notes-generator
Any agent
npx skills add DDDFXYqiming/Agent_Extensions --skill video-notes-generator
Clone the repo
git clone --depth 1 https://github.com/DDDFXYqiming/Agent_Extensions

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for video-notes-generator

README.md
[![agentmods](https://agentmods.dev/badge/skills/dddfxyqiming/agent_extensions/video-notes-generator.svg)](https://agentmods.dev/skills/dddfxyqiming/agent_extensions/video-notes-generator)
Your own site
<a href="https://agentmods.dev/skills/dddfxyqiming/agent_extensions/video-notes-generator"><img src="https://agentmods.dev/badge/skills/dddfxyqiming/agent_extensions/video-notes-generator.svg" alt="Measured on agentmods" height="20"></a>
Per session 66 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,266 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00066 $0.02266
Opus 5 $0.00033 $0.01133
Sonnet 5 $0.00013 $0.00453
Haiku 4.5 $0.00007 $0.00227

Measured today against content hash 971e3937b6af, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

video-notes-generator scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/install_deps.sh, scripts/video_to_notes.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

General_skills/video-notes-generator/SKILL.md · 127 lines

How it starts

The opening of the file, as written. The whole thing — 127 lines — stays where its author put it; the contents beside it link to each section on GitHub.

video-notes-generator

把视频 URL 或本地视频加工成结构化笔记素材:下载 → 字幕/转写 → 抽帧 → 五类产物;最终笔记由 Agent 基于产物综合生成。脚本零 pip 设计,只依赖 yt-dlpffmpeg 二进制。

触发场景

  • 用户说"视频笔记 / 视频总结 / video notes / summarize video"
  • 分享 Bilibili / YouTube / 抖音 / 快手 URL 并要求笔记或总结
  • 要求转写或总结本地视频文件

Quick Start

# B站视频(无字幕时自动转写)
python3 <skill>/scripts/video_to_notes.py "https://www.bilibili.com/video/BV1xxxxx"

# YouTube + 自定义输出目录
python3 <skill>/scripts/video_to_notes.py "https://www.youtube.com/watch?v=xxxxx" -o ./my_notes

# 本地文件(默认抽帧做多模态分析)
python3 <skill>/scripts/video_to_notes.py "/path/to/video.mp4" --frame-interval 30 --max-frames 3

# 紧急纯文本模式(仅当下载/抽帧失败或用户明确不要图)
python3 <skill>/scripts/video_to_notes.py "<url>" --no-frames

流水线

  1. 依赖预检 → 2. 平台检测(bilibili/youtube/douyin/kuaishou/local)→ 3. 元数据(yt-dlp --dump-json,B站失败走公开 API fallback)→ 4. 字幕优先(B站/YouTube)→ 5. 无字幕则音频下载 + faster-whisper / whisper.cpp 转写 → 6. 下载 ≤720p H.264 视频抽代表帧(20%/50%/80%)→ 7. 输出产物。

产物五件套

文件 用途
*_final_notes.md 用户可见笔记(先读这个
*_chunk_summaries.md 分块摘要(第二顺位读)
*_transcript.json 完整转写档案(仅在用户要求原始细节时读)
*_visual_manifest.json 帧索引:timestamp / image_path / nearby_transcript
*_frames/ 关键帧图片

配置

环境变量(可放 <runtime>/.env,runtime 默认 ~/.cache/video-notes-generator):

变量 默认 说明
YTDLP / FFMPEG 自动探测 二进制路径
TRANSCRIBER_TYPE faster-whisper 转写引擎;whisper.cpp 可选(有 git/编译器时自动编译)
WHISPER_MODEL base 转写模型。嘈杂音频建议 large-v3-turbo(首次需下载模型);内置别名 tiny/base/small/medium/large-v1/v2/v3/v3-turbo
WHISPER_DEVICE / WHISPER_COMPUTE_TYPE 留空 = 自动探测 显式设值最优先;取值与降级行为见「转写算力」小节
VIDEO_NOTES_CUDA_BIN 自动搜索 cublas64_12.dll 的目录,供借用 CUDA 运行库时指定
VIDEO_NOTES_PROXY 标准 proxy env yt-dlp/网络代理;也可用 <runtime>/config/proxy.json {"enabled":true,"url":"..."}
VIDEO_NOTES_MAX_AGENT_FRAMES 3 默认最大抽帧数
VIDEO_NOTES_FRAME_MAX_WIDTH 640 帧宽上限

CLI 参数:位置参数 url 必填;-o/--output(默认 ./notes);--no-subtitle--transcribe--model--frame-interval--max-frames--no-frames--print-full-json(勿在 Agent 场景使用)。已废弃:--url/--file/--style/--format/--quality

Read the full file on GitHub · 127 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +6 lines 971e3937b6af
  2. 4d ago First seen · 121 lines · 66 tokens per session scan A e4eeaaae1411

Subscribe to this mod's changes

video-notes-generator is a skill published in the GitHub repository DDDFXYqiming/Agent_Extensions (7 stars, last pushed yesterday), licensed MIT. It adds 66 tokens to every session and 2,266 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories