content-documenter

# Content Documenter Skill

Transforms media-reviewer analysis into structured JSON documentation.

## What This Skill Does

Takes your media-reviewer analysis and produces ContentSummary JSON
with all 16 required fields.

## Input

You should have already used media-reviewer skill which provides:
- Deep understanding of content structure
- Core ideas and their connections
- Narrative flow analysis
- Key moments and quotes with timestamps
- Thematic patterns

## Output Fields

### Core Fields (7)

1. **contentId** (string)
   - Copy from input file frontmatter id field

2. **headline** (string, 10-200 chars)
   - One compelling sentence capturing the essence
   - Should make someone want to read more
   - Focus on the unique value or insight

3. **tldr** (string, 20-500 chars)
   - 3-5 sentence summary
   - Cover the main points concisely
   - Answer: "What is this about and why does it matter?"

4. **bullets** (string[], 1-10 items)
   - Key points as bullet list
   - Each bullet = one distinct insight
   - Ordered by importance or logical flow

5. **tags** (string[], 1-20 items)
   - Topic tags for categorization
   - Include broad tags (e.g., "AI") and specific (e.g., "Constitutional AI")
   - Lowercase, no special characters

6. **sentiment** ("positive" | "neutral" | "negative")
   - Overall tone of content
   - Based on language and framing, not topic

7. **category** (string)
   - Content type: article, video, podcast, tutorial, interview, etc.

8. **score.relevanceToUser** (number, 0-1)
   - Based on user-profile.json topics
   - 1.0 = perfectly matches user interests
   - 0.0 = no relevance to user interests
   - Calculate: sum(matched topic weights) / sum(all topic weights)

### Documentary Fields (8)

9. **overview** (string, min 50 chars)
   - 2-3 rich paragraphs introducing the material
   - Write for someone unfamiliar with the content
   - Cover: what it is, who it's for, why it matters
   - Set the stage for detailed analysis

10. **keyThemes** (stri