Agent skill

Youtube Processor

Process YouTube videos into summarized Obsidian notes. An agent skill from nicepkg/ai-workflow.

Install Youtube Processor

skills CLI

$ npx skills add nicepkg/ai-workflow --skill youtube-processor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install nicepkg/ai-workflow youtube-processor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workflows/content-creator-workflow/.claude/skills/youtube-processor .claude/skills/youtube-processor && rm -rf skills-src

Use ~/.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/

Paste into Claude Code

Install the "youtube-processor" agent skill from https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/youtube-processor into .claude/skills/youtube-processor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "youtube-processor", 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

$skill-installer install https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/youtube-processor

Type 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.

skills CLI

$ npx skills add nicepkg/ai-workflow --skill youtube-processor -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install nicepkg/ai-workflow youtube-processor --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .agents/skills && cp -r skills-src/workflows/content-creator-workflow/.claude/skills/youtube-processor .agents/skills/youtube-processor && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "youtube-processor" agent skill from https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/youtube-processor into .agents/skills/youtube-processor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "youtube-processor", 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.

skills CLI

$ npx skills add nicepkg/ai-workflow --skill youtube-processor -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install nicepkg/ai-workflow youtube-processor --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/workflows/content-creator-workflow/.claude/skills/youtube-processor .cursor/skills/youtube-processor && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "youtube-processor" agent skill from https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/youtube-processor into .cursor/skills/youtube-processor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "youtube-processor", 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

$ gemini skills install https://github.com/nicepkg/ai-workflow.git --path workflows/content-creator-workflow/.claude/skills/youtube-processor

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add nicepkg/ai-workflow --skill youtube-processor -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install nicepkg/ai-workflow youtube-processor --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/workflows/content-creator-workflow/.claude/skills/youtube-processor .gemini/skills/youtube-processor && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "youtube-processor" agent skill from https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/youtube-processor into .gemini/skills/youtube-processor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "youtube-processor", 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.

GitHub CLI

$ gh skill install nicepkg/ai-workflow youtube-processor

Installs 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).

skills CLI

$ npx skills add nicepkg/ai-workflow --skill youtube-processor -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .github/skills && cp -r skills-src/workflows/content-creator-workflow/.claude/skills/youtube-processor .github/skills/youtube-processor && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "youtube-processor" agent skill from https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/youtube-processor into .github/skills/youtube-processor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "youtube-processor", 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.

skills CLI

$ npx skills add nicepkg/ai-workflow --skill youtube-processor -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install nicepkg/ai-workflow youtube-processor --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nicepkg/ai-workflow.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/workflows/content-creator-workflow/.claude/skills/youtube-processor .opencode/skills/youtube-processor && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "youtube-processor" agent skill from https://github.com/nicepkg/ai-workflow/tree/main/workflows/content-creator-workflow/.claude/skills/youtube-processor into .opencode/skills/youtube-processor/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "youtube-processor", 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: youtube-processor
GitHub stars: 285
Token cost: ~1.3k tokens
SKILL.md length: 497 words
Files: 12
Skills in repo: 75
Repo updated: Jan 20, 2026
First seen: Oct 9, 2026
Licence: MIT

At a glance

Process YouTube videos into summarized Obsidian notes. An agent skill from nicepkg/ai-workflow.

Works in 3 steps: Summarize the Transcript → Format for Obsidian → Save (Optional)
Given a YouTube URL to summarize
SKILL.md covers What This Does, When to Use, Location and How It Works, plus 7 more sections
Runs Python scripts from its folder; calls python3 and pip3; reaches youtube.com and youtube-processor-eight.vercel.app

What it does

Youtube Processor is an agent skill from nicepkg/ai-workflow. Process YouTube videos into summarized Obsidian notes. Use when given a YouTube URL to summarize, extract insights, or turn videos into notes. Triggers on "summarize this video", "process this YouTube", "what's this video about", or any YouTube URL shared for processing.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 15 other files (for example `TODO.md`, `api/main.py` and `docs/GUIDE.md`).

It sits in Writing & Content, covering Note-taking and Newsletters. It works with YouTube, Obsidian and Python. The repository describes itself as: 🚀 170+ pre-built skills for Claude Code, Cursor, Codex & 14+ AI tools. Stop re-teaching your AI the same things. One command → instant domain expertise. Marketing, SEO, Trading… The licence is MIT.

When your agent uses it

Given a YouTube URL to summarize
Extract insights
Turn videos into notes
Summarize this video

Example prompts

“summarize this video”
“process this YouTube”
“s this video about”
“/youtube-processor”

Requirements

Python 3
Pre-approved tools (allowed-tools): Read, Bash, Write, Glob, WebFetch

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Summarize the Transcript
Format for Obsidian
Save (Optional)

What it can do on your machine

Read from SKILL.md and the folder at commit d167b41. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Read
- Bash
- Write
- Glob
- WebFetch
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Python), which the agent can run.
Shell commands in SKILL.md call:
- python3
- pip3
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- youtube.com
- youtube-processor-eight.vercel.app
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

Youtube Processor loads about 1.3k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~72
When it runs · the whole SKILL.md, loaded when a task matches: ~1.3k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Read, Bash, Write, Glob, WebFetch
```

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from nicepkg/ai-workflow at commit d167b41, republished under its MIT licence (© nicepkg). 497 words, ~1,338 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-processor/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.

name: youtube-processor
description: Process YouTube videos into summarized Obsidian notes. Use when given a YouTube URL to summarize, extract insights, or turn videos into notes. Triggers on "summarize this video", "process this YouTube", "what's this video about", or any YouTube URL shared for processing.
allowed-tools: Read, Bash, Write, Glob, WebFetch

YouTube Processor

What This Does

Takes a YouTube URL, extracts the transcript, and you (Claude) summarize it. Outputs Obsidian-ready markdown. Zero friction: share a link, get actionable notes.

When to Use

"Summarize this video: [URL]"
"Turn this YouTube into notes"
"What's this video about?"
"Process this for my newsletter"
Any YouTube URL shared for processing

Location

This skill's tools live at:

/Users/eddale/Documents/GitHub/powerhouse-lab/skills/youtube-processor/tools/

How It Works

Step 1: Python extracts the transcript (no API key needed) Step 2: You (Claude) summarize using your intelligence + context Step 3: You write the Obsidian-formatted output

This approach means you can use mission-context, newsletter-coach, and other skills during summarization.

Instructions

Which Method to Use

Environment	Method
Claude Code	Local Python script (Step 1a)
Claude.ai / Mac Client	API via WebFetch (Step 1b)

Step 1a: Extract Transcript (Claude Code)

Run the Python tool to get the transcript:

bash

cd /Users/eddale/Documents/GitHub/powerhouse-lab/skills/youtube-processor/tools && \
python3 get_transcript.py --url "[URL]"

For JSON output (easier to parse):

bash

python3 get_transcript.py --url "[URL]" --json

Step 1b: Extract Transcript (Claude.ai / Mac Client)

Use the API endpoint via WebFetch:

WebFetch: https://youtube-processor-eight.vercel.app/transcript?url=[VIDEO_URL]

The API returns JSON:

json

{
  "success": true,
  "video_id": "abc123",
  "language": "en",
  "transcript": "...",
  "char_count": 5000,
  "word_count": 850
}

Example prompt for WebFetch: "Extract the transcript text from the response"

Step 2: Summarize the Transcript

Once you have the transcript, summarize it based on what the user needs:

Quick Summary:

Headline (1 sentence)
Key points (3-5 bullets)
Main takeaway

Detailed Analysis:

Headline summary
Key points with context
Main takeaways
Action items mentioned
How this relates to Ed's work (if relevant)

Newsletter Mining:

Hook ideas for an article
Core insight/framework
Story beats for anecdotes
Takeaways for readers
Newsletter angle for The Little Blue Report

Step 3: Format for Obsidian

Create markdown with this structure:

markdown

---
source: YouTube
video_id: [ID]
url: [URL]
processed: [YYYY-MM-DD HH:MM]
tags: [youtube, video-notes]
---

# [Video Title or Topic]

**Link**: [URL]
**Processed**: [Date]

## Summary

[Your summary here]

---

## Full Transcript

[The transcript]

---

_Generated by youtube-processor skill_

Step 4: Save (Optional)

Save to Ed's Zettelkasten:

/Users/eddale/Documents/COPYobsidian/MAGI/Zettelkasten/

Filename format: YT - [Topic] - YYYY-MM-DD.md

Error Handling

Error	Meaning	What to Do
"Transcripts disabled"	Creator turned off captions	Video can't be processed
"No transcript found"	No English captions available	Try a different video
"Video unavailable"	Private, deleted, or age-restricted	Check the URL

Show full SKILL.md (191 more words)Show less

Examples

Example 1: Quick Summary

User says:

Summarize this: https://www.youtube.com/watch?v=VIDEO_ID

You do:

Run: python3 get_transcript.py --url "https://www.youtube.com/watch?v=VIDEO_ID"
Read the transcript output
Provide a summary to the user

Example 2: Save to Obsidian

User says:

Turn this video into notes and save it: [URL]

You do:

Extract transcript with the Python tool
Summarize the content
Format as Obsidian markdown
Use Write tool to save to Zettelkasten
Confirm: "Saved to [filepath]"

User says:

I want to write about this video for the newsletter: [URL]

You do:

Extract transcript
Analyze for newsletter angles (hooks, insights, story beats)
Present the angles
Offer to hand off to newsletter-coach skill

Integration Points

newsletter-coach: After extracting video insights, hand off for article development
mission-context: Use Ed's voice and style when summarizing
task-clarity-scanner: Action items from videos can be added to daily notes

Dependencies

The Python tool requires:

youtube-transcript-api

Install if needed:

bash

pip3 install youtube-transcript-api

Version History

Version	Date	Changes
1.1	2026-01-03	Added Vercel API for Claude.ai/Mac client support
1.0	2026-01-02	Initial build with transcript extraction

Notes & Learnings

youtube-transcript-api works without API keys
Most videos have auto-generated English captions
Claude doing the summarization is better than Python calling the API (can use context)
~3-5 second transcript extraction for typical videos

Files

SKILL.md and 11 other files in workflows/content-creator-workflow/.claude/skills/youtube-processor of nicepkg/ai-workflow.

SKILL.md
.gitignore
TODO.md
api/main.py
docs/GUIDE.md
docs/ROADMAP.md
examples/sample-output.md
requirements.txt
tools/get_transcript.py
tools/process_video.py
tools/youtube_core.py
vercel.json

Open the folder on GitHubat commit d167b41

Compare with similar skills

Youtube Processor 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.

Youtube Processor compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Youtube Processor this skillnicepkg/ai-workflow	285	—	~1.3k	Automated safety check: Notes	MIT	8 mo ago
FIRE Card to EPUBtwhsi/skills	259	—	~1k	Automated safety check: Pass	None	2 mo ago
Video To NotesKIRVO-REPORTING/video-to-notes	105	—	~1.5k	Automated safety check: Pass	MIT	1 mo ago
YouTube Talk Notetakerdair-ai/dair-academy-plugins	614	—	~2.3k	Automated safety check: Pass	MIT	2 mo ago
Paper and Web Source Analyzerjuliye2025/evil-read-arxiv	1.7k	—	~715	Automated safety check: Pass	None	24 days ago
Summarizereysu/ai-life-skills	269	—	~7.7k	Automated safety check: Pass	MIT	1 mo ago

Similar skills

FIRE Card to EPUB
twhsi/skills
Converts FIRE analysis cards or project-note JSON into a validated EPUB book with directory, chapter and keyword index cards and backlinks.
259 GitHub stars~1k tokensUpdated 2 mo ago
Documents & OfficeAuto-check passed
Video To Notes
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.
105 GitHub stars~1.5k tokensUpdated 1 mo ago
Media & CreativeAuto-check passed
YouTube Talk Notetaker
dair-ai/dair-academy-plugins
Converts a YouTube talk into a markdown study note with slide images, a timestamped transcript and editable notes, browsable through a small local server.
614 GitHub stars~2.3k tokensUpdated 2 mo ago
Knowledge ManagementAuto-check passed
Paper and Web Source Analyzer
juliye2025/evil-read-arxiv
Analyzes arXiv papers, PDFs, project pages and blogs and writes an evidence-backed Obsidian note with images and a knowledge-graph entry.
1.7k GitHub stars~715 tokensUpdated 24 days ago
Research & ScienceAuto-check passed
Summarize
reysu/ai-life-skills
Summarize any content (YouTube video, article, whitepaper/PDF, podcast episode, book chapter, etc.) into a rich Obsidian note with section-by-section breakdowns, wikilinks to all technical concepts…
269 GitHub stars~7.7k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed
EPUB to HyperCard Obsidian
twhsi/skills
Converts an EPUB card book into an Obsidian folder with one Markdown file per card, keyword cards, navigation links and an optional shareable zip.
259 GitHub stars~1k tokensUpdated 2 mo ago
Documents & OfficeAuto-check passed

Questions about Youtube Processor

What does Youtube Processor do?

Process YouTube videos into summarized Obsidian notes. An agent skill from nicepkg/ai-workflow. Youtube Processor is an agent skill from nicepkg/ai-workflow. Process YouTube videos into summarized Obsidian notes.

When should I use Youtube Processor?

Youtube Processor fits situations like: given a YouTube URL to summarize; extract insights; turn videos into notes; summarize this video.

How do I install Youtube Processor in Claude Code?

Run `npx skills add nicepkg/ai-workflow --skill youtube-processor -a claude-code`. Or copy the skill folder (workflows/content-creator-workflow/.claude/skills/youtube-processor in nicepkg/ai-workflow) into .claude/skills/youtube-processor in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Processor in Codex?

Run `npx skills add nicepkg/ai-workflow --skill youtube-processor -a codex`. Or copy the skill folder (workflows/content-creator-workflow/.claude/skills/youtube-processor in nicepkg/ai-workflow) into .agents/skills/youtube-processor in your project. Codex loads it when a task matches its description.

Can I use Youtube Processor 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 nicepkg/ai-workflow --skill youtube-processor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-processor, .gemini/skills/youtube-processor, .github/skills/youtube-processor and .opencode/skills/youtube-processor in your project.

What does Youtube Processor need to run?

Going by SKILL.md and its folder, Youtube Processor needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and pip3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Bash, Write, Glob, WebFetch.

Does Youtube Processor access the network?

SKILL.md names 2 domains. In commands or code: youtube.com and youtube-processor-eight.vercel.app; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Youtube Processor safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Youtube Processor use?

Youtube Processor 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 Youtube Processor use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Youtube Processor?

Skills that share tags, products or a category with Youtube Processor: FIRE Card to EPUB (twhsi/skills, 259 stars), Video To Notes (KIRVO-REPORTING/video-to-notes, 105 stars), YouTube Talk Notetaker (dair-ai/dair-academy-plugins, 614 stars) and Paper and Web Source Analyzer (juliye2025/evil-read-arxiv, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Processor?

nicepkg (a GitHub organization) maintains it in nicepkg/ai-workflow, which has 285 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on January 20, 2026.

Source: nicepkg/ai-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Youtube Processor

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

YouTube Processor

What This Does

When to Use

Location

How It Works

Instructions

Which Method to Use

Step 1a: Extract Transcript (Claude Code)

Step 1b: Extract Transcript (Claude.ai / Mac Client)

Step 2: Summarize the Transcript

Step 3: Format for Obsidian

Step 4: Save (Optional)

Error Handling

Examples

Example 1: Quick Summary

Example 2: Save to Obsidian

Example 3: Newsletter Mining

Integration Points

Dependencies

Version History

Notes & Learnings

Files

Compare with similar skills

Similar skills

More from nicepkg/ai-workflow

Related

Questions about Youtube Processor