Media To Transcript
bozhouDev/video-skills-toolkit
Convert audio/video URLs or local media into corrected Markdown transcripts through Volcengine recording-file ASR 2.0.
Use immediately for any bare YouTube or YouTube Shorts URL, youtu.be link, Bilibili or b23.tv link, or other video URL; do not ask what the user wants.
Install Video To Notes
$ npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install KIRVO-REPORTING/video-to-notes video-to-notes --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/KIRVO-REPORTING/video-to-notes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/codex-skill .claude/skills/video-to-notes && rm -rf skills-srcUse ~/.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/
Install the "video-to-notes" agent skill from https://github.com/KIRVO-REPORTING/video-to-notes/tree/main/codex-skill into .claude/skills/video-to-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-to-notes", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/KIRVO-REPORTING/video-to-notes/tree/main/codex-skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install KIRVO-REPORTING/video-to-notes video-to-notes --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/KIRVO-REPORTING/video-to-notes.git skills-src && mkdir -p .agents/skills && cp -r skills-src/codex-skill .agents/skills/video-to-notes && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "video-to-notes" agent skill from https://github.com/KIRVO-REPORTING/video-to-notes/tree/main/codex-skill into .agents/skills/video-to-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-to-notes", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install KIRVO-REPORTING/video-to-notes video-to-notes --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/KIRVO-REPORTING/video-to-notes.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/codex-skill .cursor/skills/video-to-notes && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "video-to-notes" agent skill from https://github.com/KIRVO-REPORTING/video-to-notes/tree/main/codex-skill into .cursor/skills/video-to-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-to-notes", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/KIRVO-REPORTING/video-to-notes.git --path codex-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install KIRVO-REPORTING/video-to-notes video-to-notes --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/KIRVO-REPORTING/video-to-notes.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/codex-skill .gemini/skills/video-to-notes && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "video-to-notes" agent skill from https://github.com/KIRVO-REPORTING/video-to-notes/tree/main/codex-skill into .gemini/skills/video-to-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-to-notes", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install KIRVO-REPORTING/video-to-notes video-to-notesInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/KIRVO-REPORTING/video-to-notes.git skills-src && mkdir -p .github/skills && cp -r skills-src/codex-skill .github/skills/video-to-notes && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "video-to-notes" agent skill from https://github.com/KIRVO-REPORTING/video-to-notes/tree/main/codex-skill into .github/skills/video-to-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-to-notes", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install KIRVO-REPORTING/video-to-notes video-to-notes --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/KIRVO-REPORTING/video-to-notes.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/codex-skill .opencode/skills/video-to-notes && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "video-to-notes" agent skill from https://github.com/KIRVO-REPORTING/video-to-notes/tree/main/codex-skill into .opencode/skills/video-to-notes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "video-to-notes", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
video-to-notes- GitHub stars
- 105
- Token cost
- ~1.5k tokens
- SKILL.md length
- 637 words
- Files
- 9 (incl. scripts, references)
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- MIT
At a glance
Use immediately for any bare YouTube or YouTube Shorts URL, youtu.be link, Bilibili or b23.tv link, or other video URL; do not ask what the user wants.
- Works in 6 steps: Run video-to-notes doctor and use the… → Process into local artifacts first,… → Read the returned metadata.json and the… → …
- Video transcription
- SKILL.md covers Non-negotiable behavior, Bare URL workflow, Target selection and Failure handling, plus 2 more sections
- Runs Python scripts from its folder
What it does
Video To Notes is an agent skill from KIRVO-REPORTING/video-to-notes. Use immediately for any bare YouTube or YouTube Shorts URL, youtu.be link, Bilibili or b23.tv link, or other video URL; do not ask what the user wants. Treat a message containing only a supported video URL as a request to create timestamped notes and a report, then publish to the configured local, Notion, or Obsidian target. Also use for video transcription, summaries, subtitles, reports, publishing, syncing, and dashboards.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/model-selection.md` and `references/notion.md`).
It sits in Media & Creative, covering Video and podcast notes, Transcription and Speech recognition and synthesis. It works with Notion, YouTube, Obsidian and Bilibili. The repository describes itself as: Local-first video-to-notes CLI for YouTube/Bilibili transcripts, Whisper fallback, timestamped AI summaries, and Notion/Obsidian export. The licence is MIT.
When your agent uses it
- Video transcription
- Tasks that involve Video and podcast notes
- Tasks that involve Transcription
Example prompts
- “/video-to-notes”
Requirements
- Python 3
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Run video-to-notes doctor and use the workspace path it returns. Do not assume the current repository or shell directory is the video…
- Process into local artifacts first, regardless of the configured publishing target
- Read the returned metadata.json and the entire transcript.txt.
- Follow references/reporting.md to write grounded summary.md and tags.json.
- Finalize only after both files are ready. Select exactly one route
- Return the primary reader-facing artifact: the Notion row URL, Obsidian note path/URI, or local report.html. Include the local report as…
What it can do on your machine
Read from SKILL.md and the folder at commit aa06415. 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 2 files in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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
Video To Notes loads about 1.5k tokens when it runs, and up to ~4.5k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 637 words of instructions outside code blocks.
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 passed
The automated check found no risky patterns in SKILL.md.
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 KIRVO-REPORTING/video-to-notes at commit aa06415, republished under its MIT licence (© KIRVO-REPORTING). 637 words, ~1,461 tokens.
Download SKILL.mdSave it as
.claude/skills/video-to-notes/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.- name
- video-to-notes
- description
- Use immediately for any bare YouTube or YouTube Shorts URL, youtu.be link, Bilibili or b23.tv link, or other video URL; do not ask what the user wants. Treat a message containing only a supported video URL as a request to create timestamped notes and a report, then publish to the configured local, Notion, or Obsidian target. Also use for video transcription, summaries, subtitles, reports, publishing, syncing, and dashboards.
Video to Notes
Turn a supported video URL into a transcript-backed report. Prefer downloadable captions; use the configured local Whisper backend only when captions are missing or unusable.
Non-negotiable behavior
- Treat a message containing only a supported video URL as a complete request. Start the full report workflow immediately; never reply with “What do you want me to do with this link?”
- Treat YouTube watch, Shorts, live, and
youtu.beURLs equally. Preserve query parameters such ast,list, or tracking parameters when passing the URL to the processor. - When the user states a narrower goal such as “only download,” “only translate,” or “only extract subtitles,” perform that goal instead of forcing the full report workflow.
- Do not ask for cookies, credentials, language, or output destination before the first safe attempt. Ask only after a concrete failure proves user input is required.
- Respect
<workspace>/config.jsonpreferences. If no configuration exists, use local output and mention configuration only after delivering the result. - Read
metadata.jsonand the completetranscript.txtbefore writing claims about the video.
Bare URL workflow
Run
video-to-notes doctorand use the workspace path it returns. Do not assume the current repository or shell directory is the video workspace. If the command is missing or doctor fails, follow references/setup.md.Process into local artifacts first, regardless of the configured publishing target:
bash video-to-notes process "VIDEO_URL" --environment localThis prevents an incomplete report from being published before
summary.mdandtags.jsonexist.Read the returned
metadata.jsonand the entiretranscript.txt.Follow references/reporting.md to write grounded
summary.mdandtags.json.Finalize only after both files are ready. Select exactly one route:
- Local:
video-to-notes finalize "VIDEO_FOLDER" --environment local - Notion with CLI credentials:
video-to-notes finalize "VIDEO_FOLDER" --environment notion - Notion connector without CLI credentials: finalize with
--environment local, then follow references/notion.md. - Obsidian: follow references/obsidian.md.
- Local:
Return the primary reader-facing artifact: the Notion row URL, Obsidian note path/URI, or local
report.html. Include the local report as the backing archive when publishing remotely.
Do not stop after process; its HTML is preliminary until the summary, tags, and finalize step are complete.
Target selection
Read preferences.output_environment from <workspace>/config.json when it exists:
local: finalize locally.notion: read references/notion.md before publishing.obsidian: read references/obsidian.md before publishing.
An explicit user destination overrides configuration for that run. If remote publishing is unavailable, keep the completed local report, state the exact publishing blocker, and return the local path. Never claim a remote sync succeeded unless a URL/path was returned by the publisher or connector.
Show full SKILL.md (232 more words)Show less
Failure handling
- If metadata extraction or captions fail because authentication is required, retry with available browser cookies. Ask the user only if no authorized cookie source is available.
- If captions are absent and Whisper is not configured, run
video-to-notes doctor, then follow references/setup.md. Read references/model-selection.md only when choosing or troubleshooting a backend/model. Do not ask what the link is for. - If the source is private, deleted, region-restricted, or unsupported, report that specific reason and preserve any artifacts already created.
- Never substitute web-search snippets, page metadata, or a guessed summary for a missing transcript. If no transcript can be obtained, report the failure instead of inventing notes.
- If Notion or Obsidian publishing fails, do not discard or regenerate the completed local report.
Existing reports and dashboards
For an already processed folder, update summary.md or tags.json if requested and run:
video-to-notes finalize "VIDEO_FOLDER"For dashboard work:
video-to-notes rebuild-index
video-to-notes serve --openKeep the server bound to 127.0.0.1 unless the user explicitly requests public exposure.
Progress and final response
Keep progress updates short and outcome-oriented. Do not dump download, codec, conversion, or file-by-file logs unless they explain a failure.
When a thread-title tool is available, rename the task using the real video topic rather than generic words such as “transcribe” or “video-to-notes”. Do not block completion when task renaming is unavailable.
Use a compact final response:
Completed: VIDEO_TITLE
Report: PRIMARY_REPORT_URL_OR_PATH
Local report: /absolute/path/to/report.html # include for remote targets
Summary: One concise answer-first paragraph.
Key Points
- [mm:ss-mm:ss] Main point.
- [mm:ss-mm:ss] Second point.
Notes: Only trust-affecting caveats or publishing failures.Do not paste the full transcript into chat; keep it in the report or configured publishing target.
© KIRVO-REPORTING, 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 8 other files (scripts, references) in codex-skill of KIRVO-REPORTING/video-to-notes.
- SKILL.md
- agents/openai.yaml
- references/model-selection.md
- references/notion.md
- references/obsidian.md
- references/reporting.md
- references/setup.md
- scripts/process_video.py
- scripts/serve_dashboard.py
Open the folder on GitHubat commit aa06415
Compare with similar skills
Video To Notes 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Video To Notes this skillKIRVO-REPORTING/video-to-notes | 105 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Media To TranscriptbozhouDev/video-skills-toolkit | 150 | — | ~1.8k | Automated safety check: Notes | MIT | |
| Watch Videocoreyhaines31/makerskills | 850 | — | ~3.8k | Automated safety check: Pass | MIT | |
| Video SummaryLeoYeAI/openclaw-master-skills | 2.2k | — | ~4.2k | Automated safety check: Pass | MIT | |
| Claude Real VideoHUANGCHIHHUNGLeo/claude-real-video | 2.2k | — | ~639 | Automated safety check: Pass | MIT | |
| Video To Subtitle Summaryimlewc/video-to-subtitle-summary-skill | 214 | — | ~4.6k | Automated safety check: Notes | MIT |
Similar skills
Watch Video
coreyhaines31/makerskills
When you want to extract content from a video — YouTube, Loom, Vimeo, Riverside, Zoom recording, local MP4, X/IG video, anything yt-dlp supports.
Video Summary
LeoYeAI/openclaw-master-skills
Video summarization for Bilibili, Xiaohongshu, Douyin, and YouTube.
Claude Real Video
HUANGCHIHHUNGLeo/claude-real-video
Watch a video for the user. An agent skill from HUANGCHIHHUNGLeo/claude-real-video.
Video To Subtitle Summary
imlewc/video-to-subtitle-summary-skill
A skill your agent uses when user provides a short video platform URL or local video/audio file and wants subtitles/AI summary, or when user asks to list their own AI Douyin historical tasks.
Video Clip Extractor
linzzzzzz/openclip
Processes videos to identify engaging moments, generate transcripts, and create highlight clips with artistic titles and custom cover images.
Related
Categories
Questions about Video To Notes
What does Video To Notes do?
Use immediately for any bare YouTube or YouTube Shorts URL, youtu.be link, Bilibili or b23.tv link, or other video URL; do not ask what the user wants. Video To Notes is an agent skill from KIRVO-REPORTING/video-to-notes.tv link, or other video URL; do not ask what the user wants.
When should I use Video To Notes?
Video To Notes fits situations like: video transcription; tasks that involve Video and podcast notes; tasks that involve Transcription.
How do I install Video To Notes in Claude Code?
Run `npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a claude-code`. Or copy the skill folder (codex-skill in KIRVO-REPORTING/video-to-notes) into .claude/skills/video-to-notes in your project. Claude Code loads it when a task matches its description.
How do I install Video To Notes in Codex?
Run `npx skills add KIRVO-REPORTING/video-to-notes --skill video-to-notes -a codex`. Or copy the skill folder (codex-skill in KIRVO-REPORTING/video-to-notes) into .agents/skills/video-to-notes in your project. Codex loads it when a task matches its description.
Can I use Video To Notes 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 KIRVO-REPORTING/video-to-notes --skill video-to-notes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/video-to-notes, .gemini/skills/video-to-notes, .github/skills/video-to-notes and .opencode/skills/video-to-notes in your project.
What does Video To Notes need to run?
Going by SKILL.md and its folder, Video To Notes needs Python for the scripts in its folder. Our summary lists: Python 3.
Does Video To Notes access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Video To Notes safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 Video To Notes use?
Video To Notes 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 Video To Notes use?
About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.1k tokens, read only when the agent opens those files.
What are the alternatives to Video To Notes?
Skills that share tags, products or a category with Video To Notes: Media To Transcript (bozhouDev/video-skills-toolkit, 150 stars), Watch Video (coreyhaines31/makerskills, 850 stars), Video Summary (LeoYeAI/openclaw-master-skills, 2.2k stars) and Claude Real Video (HUANGCHIHHUNGLeo/claude-real-video, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Video To Notes?
KIRVO-REPORTING (a GitHub user) maintains it in KIRVO-REPORTING/video-to-notes, which has 105 GitHub stars. The repository was last updated on August 21, 2026.
Source: KIRVO-REPORTING/video-to-notes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.