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-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add MacHu-GWU/sanhe-claude-code-plugins.
Contents
Discovered from sourceSkills 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
