Initial commit

SKILL.md

@@ -0,0 +1,106 @@
+---
+name: youtube-comment-analysis
+description: Use when user requests YouTube comments. Run standalone for comment analysis or sequential with youtube-to-markdown for cross-analysis with video summary.
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Task
+  - AskUserQuestion
+  - Skill
+---
+
+# YouTube Comment Analysis
+
+Execute all steps sequentially without asking for user approval. Use TodoWrite to track progress.
+
+## Step 0: Check for video summary
+
+If you don't know from conversation context whether a video summary exists for this URL, extract video ID from URL and check if file matching `<output_directory>/youtube - * ({video_id}).md` exists.
+
+If no summary file exists OR you don't know from context, ask user:
+
+```
+AskUserQuestion:
+- question: "No video summary found. How would you like to proceed with comment analysis?"
+- header: "Mode"
+- options:
+  1. label: "Create transcript first"
+     description: "Run youtube-to-markdown skill to create video summary, then cross-analyze comments against it"
+  2. label: "Standalone analysis"
+     description: "Analyze comments without video context (faster, less informed)"
+```
+
+If user chooses "Create transcript first": Run youtube-to-markdown skill with the URL first, then proceed with youtube-comment-analysis skill.
+
+If summary exists OR user chooses "Standalone analysis": Proceed directly to Step 1.
+
+## Step 1: Extract comments
+
+```bash
+python3 ./extract_comments.py "<YOUTUBE_URL>" "<output_directory>"
+```
+
+Creates: youtube_{VIDEO_ID}_name.txt, youtube_{VIDEO_ID}_comments.md
+
+## Step 2: Clean comments
+
+task_tool:
+- subagent_type: "general-purpose"
+- model: "haiku"
+- prompt:
+
+**Standalone mode (no summary):**
+```
+Read <output_directory>/${BASE_NAME}_comments.md and clean/curate comments. Write to <output_directory>/${BASE_NAME}_comments_cleaned.md. Do not translate.
+
+Tasks:
+- Remove low-value: "+1", "thanks", "great video", spam, duplicates
+- Remove comments that repeat content from other comments
+```
+
+**Sequential mode (with summary from youtube-to-markdown):**
+```
+Read Summary section from <output_directory>/youtube - * ({video_id}).md file to understand main points.
+
+Read <output_directory>/${BASE_NAME}_comments.md and clean/curate comments. Write to <output_directory>/${BASE_NAME}_comments_cleaned.md. Do not translate.
+
+Tasks:
+- Remove low-value: "+1", "thanks", "great video", spam, duplicates
+- Remove comments that are off-topic (use summary to identify)
+- Remove comments that repeat content from the summary or other comments
+```
+
+## Step 3: Extract Golden Comments
+
+task_tool:
+- subagent_type: "general-purpose"
+- prompt:
+
+**Standalone mode (no summary):**
+```
+Read <output_directory>/${BASE_NAME}_comments_cleaned.md. Extract and condense the MOST exceptional insights from highly upvoted comments. No fluff, NOT a document. Do not translate. Write to <output_directory>/${BASE_NAME}_comment_gold.md in format:
+
+**Golden Comments**:
+- [true insights from comments]
+```
+
+**Sequential mode (with summary from youtube-to-markdown):**
+```
+Read Summary section from <output_directory>/youtube - * ({video_id}).md file.
+
+Read <output_directory>/${BASE_NAME}_comments_cleaned.md. Extract, condense, combine and summarize ruthlessly for the MOST exceptional true golden insights NOT already covered by the summary. No fluff, NOT a document. Write to <output_directory>/${BASE_NAME}_comment_gold.md in format:
+
+**Golden Comments**:
+- [any true insights hiding in the comment garbage, NOT in summary]
+```
+
+## Step 4: Finalize
+
+```bash
+python3 ./finalize_comments.py "${BASE_NAME}" "<output_directory>"
+```
+
+Output: `youtube - {title} - comments ({video_id}).md`
+
+Use `--debug` flag to keep intermediate work files for inspection.