Files
gh-machu-gwu-sanhe-claude-c…/commands/yt-to-md.md
2025-11-30 08:38:41 +08:00

73 lines
2.0 KiB
Markdown

---
name: yt-to-md
description: Download, transcribe, and organize YouTube video into structured markdown 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:**
```markdown
# [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.