Youtube toolkit for Claude Code. See https://github.com/MacHu-GWU/sanhe-claude-code-plugins/blob/main/plugins/social-media-network/youtube/README.md

Install

/plugin install youtube@sanhe-claude-code-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add MacHu-GWU/sanhe-claude-code-plugins.

Contents

Discovered from source

Skills 4

Audio Transcription Cleanup

Clean up raw audio transcriptions by removing filler words, fixing errors, and adding proper structure.

Usage

Use the audio_transcript_cleanup.py script to process transcript files:

# Use default output location (~/tmp/cleaned_transcript.md - allows overwrite)
python scripts/audio_transcript_cleanup.py --transcript-file /path/to/transcript.txt

# Specify custom output location (cannot overwrite existing files)
python scripts/audio_transcript_cleanup.py --transcript-file /path/to/transcript.txt --output /path/to/output.md

What It Does

The script automatically:

  • Removes verbal artifacts (um, uh, like, you know, 呃, 啊, 那个, etc.)
  • Fixes spelling and grammar errors
  • Adds semantic paragraph breaks and section headings
  • Converts spoken fragments into complete sentences
  • Preserves all original information (no summarization)
  • Auto-detects language and maintains natural expression

Options

  • --transcript-file (required) - Path to the transcript file to clean up
  • --output (optional) - Custom output path (default: ~/tmp/cleaned_transcript.md)

Output Behavior

  • Default location: ~/tmp/cleaned_transcript.md - Allows overwrite
  • Custom location: Cannot overwrite existing files (raises error if file exists)

Language Support

Auto-detects and works with:

  • English
  • Chinese (Mandarin, Cantonese)
  • Mixed language content
  • Multi-speaker transcriptions

Requirements

  • Python 3.11+
  • Claude CLI must be installed and accessible
  • Transcript file must exist at specified path

Enrich Citations

Enhance markdown documents by finding and adding authoritative source links for mentioned facts, tools, products, research, and references.

Usage

Use the enrich_citations.py script to process markdown documents:

# Use default output location (~/tmp/citation_enriched.md - allows overwrite)
python scripts/enrich_citations.py --document-file /path/to/document.md

# Specify custom output location (cannot overwrite existing files)
python scripts/enrich_citations.py --document-file /path/to/document.md --output /path/to/output.md

What It Does

The script automatically:

  • Identifies all references (tools, research, products, organizations, people, standards)
  • Performs web search to find authoritative sources
  • Adds markdown hyperlinks with proper spacing: [Reference](URL)
  • Verifies all URLs are valid and accessible
  • Preserves all original content (only adds hyperlinks, no text changes)
  • Prioritizes official sources and documentation

Options

  • --document-file (required) - Path to the markdown document to enrich
  • --output (optional) - Custom output path (default: ~/tmp/citation_enriched.md)

Output Behavior

  • Default location: ~/tmp/citation_enriched.md - Allows overwrite
  • Custom location: Cannot overwrite existing files (raises error if file exists)

Reference Types Identified

  • External sources and research papers
  • Tools, software, frameworks, libraries
  • Products and services
  • Organizations and institutions
  • Technical concepts and standards (RFC, W3C, APIs)
  • People and experts

Requirements

  • Python 3.11+
  • Claude CLI must be installed and accessible
  • Internet connection (for web searches)
  • Document file must exist at specified path

Transcribe Audio to Text

Convert audio files to text using audinota transcription service.

Usage

# Use default audio file (output from youtube-video-to-audio skill)
python scripts/transcribe_audio.py

# Specify custom audio file
python scripts/transcribe_audio.py --audio-file-path "/path/to/audio.mp3"

Options

  • --audio-file-path - Path to audio file to transcribe (default: ~/tmp/download_audio_result.mp3)

Examples

# Transcribe default audio file
python scripts/transcribe_audio.py

# Transcribe custom audio file
python scripts/transcribe_audio.py --audio-file-path "~/Music/podcast.mp3"

# Get help
python scripts/transcribe_audio.py -h

Requirements

  • Python 3.11+
  • audinota installed at ~/Documents/GitHub/audinota-project/.venv/bin/audinota
  • Audio file must exist at specified path

Integration

This skill works seamlessly with the youtube-video-to-audio skill. By default, it transcribes the audio file downloaded by that skill at ~/tmp/download_audio_result.mp3.

YouTube Video to Audio

Extract and download audio from YouTube videos.

Usage

python scripts/download_audio.py --video-url "https://www.youtube.com/watch?v=VIDEO_ID"

Options

  • --video-url (required) - YouTube video URL to download
  • --quality - Quality selector (default: "bestaudio[abr<=64]/worstaudio")
  • --audio-format - Output format: mp3, aac, wav (default: mp3)
  • --bitrate - Audio bitrate: 64K, 128K, 192K, 320K (default: 64K)
  • --output - Custom output path (default: ~/tmp/download_audio_result.mp3)

Examples

# Basic usage (default: 64K bitrate MP3 to ~/tmp/download_audio_result.mp3)
python scripts/download_audio.py --video-url "https://www.youtube.com/watch?v=d6rZtgHcbWA"

# High quality with custom bitrate
python scripts/download_audio.py --video-url "https://youtu.be/xyz" --quality "bestaudio" --bitrate "128K"

# Custom output location
python scripts/download_audio.py --video-url "https://youtu.be/xyz" --output "/path/to/output.mp3"

Requirements

  • Python 3.11+
  • ffmpeg installed at ~/ffmpeg
  • yt-dlp (auto-downloaded on first run)

Commands 2

Enrich a markdown document with authoritative citation links using the enrich-citations skill.

Input

The command accepts a file path as argument:

/enrich-citations $ARGUMENTS

Where $ARGUMENTS is the path to the markdown document to enrich.

Workflow

1. Run the enrich-citations Script

Execute the enrich-citations skill script to process the document:

The script will:

  • Read the markdown document from the specified path
  • Identify all references (tools, research, products, organizations, people, standards)
  • Perform web searches to find authoritative sources
  • Add markdown hyperlinks with proper spacing: [Reference](URL)
  • Verify all URLs are valid and accessible
  • Save the enriched document to ~/tmp/citation_enriched.md

2. Display Output Location

After the script completes, it will automatically print the absolute path in a clickable format:

✓ Citation enrichment completed successfully!
✓ Enriched document saved to: file:///Users/sanhehu/tmp/citation_enriched.md

Click the link above to open the document.

Usage Examples

Enrich a cleaned transcript:

/enrich-citations ~/tmp/cleaned_transcript.md

Enrich any markdown document:

/enrich-citations /Users/sanhehu/Documents/article.md

Complete workflow after /yt-to-md:

# Step 1: Create organized transcript
/yt-to-md https://www.youtube.com/watch?v=xyz

# Step 2: Optionally enrich with citations
/enrich-citations ~/tmp/cleaned_transcript.md

Note: This command uses the enrich-citations skill script which leverages Claude CLI with web search to automatically find and verify authoritative sources for all references in the document.

Process YouTube video $ARGUMENTS end-to-end and create a well-organized document:

Workflow

Execute these skills in sequence:

1. Download Audio

Use the youtube-video-to-audio agent skill to download audio from the provided YouTube URL.

2. Transcribe Audio

Use the transcribe-audio-to-text agent skill to transcribe the downloaded audio file.

3. Clean Up Transcription

Use the audio-transcription-cleanup agent skill to transform the raw transcription into a well-structured markdown document.

This step will:

  • Detect the primary language and use it for output
  • Add semantic paragraph breaks based on topic changes
  • Create descriptive section headings
  • Fix obvious spelling, terminology, and grammatical errors
  • Remove filler words and verbal artifacts
  • Maintain all original information from the video

Output Format:

# [Video Title]

## [Section 1 Heading]

[Cleaned paragraph content...]

[More cleaned content...]

## [Section 2 Heading]

[Content continues...]

## Key Takeaways

- Point 1
- Point 2
- Point 3

Save the cleaned document to: ~/tmp/organized_transcript.md

4. Display Output Location

After completing the cleanup and saving the document, print the absolute path of the final organized document in a clickable format.

Format: file:///absolute/path/to/organized_transcript.md

Example output:

✓ YouTube video processed successfully!
✓ Organized document saved to: file:///Users/sanhehu/tmp/organized_transcript.md

Click the link above to open the document.

Requirements:

  • Use absolute path (not relative path like ~/tmp/...)
  • Include file:// protocol prefix for clickability
  • Provide clear success message
  • Make it easy for user to access the final document

Note: This command automates the core workflow from video URL to organized markdown document. Each skill can also be run independently for partial workflows.

Sponsors

Details

Marketplace
MacHu-GWU/sanhe-claude-code-plugins
Source
plugins/social-media-network/youtube
Category
Community

More from MacHu-GWU/sanhe-claude-code-plugins

All 5