id-generator

# ID Generator Skill

Expert at generating meaningful session IDs based on content source type and characteristics.

## What This Skill Does

- Reads ContentSummary JSON with detectedSource field
- Analyzes source type and main topic/theme
- Generates human-readable, meaningful session ID
- Returns ID with confidence score and rationale
- Enables reusable content identification

## ID Generation Process

Follow these 5 steps:

### Step 1: Validate Input
- Confirm ContentSummary has required fields
- Check if detectedSource field exists
- Note the content's main topic/headline/category

### Step 2: Analyze Source Type
- Review detectedSource value (podcast, transcript, article, youtube, twitter, text, other)
- Consider content characteristics:
  - **Podcast**: Audio transcript with timestamps, speaker markers, conversational flow
  - **Transcript**: Conversational content, dialogue, timestamps, multiple speakers
  - **Article**: Written structure, sections, headlines, formal tone
  - **YouTube**: Video description, channel info, timestamps
  - **Twitter**: Social media context, short-form, engagement metrics
  - **Text**: Unstructured thoughts, raw content, raw notes
  - **Other**: Any other content type

### Step 3: Extract Topic Keywords
- Identify main topic from headline, category, or keyThemes
- Select 1-2 most significant keywords
- Avoid generic terms, prefer specific subject matter
- Examples: "healthcare", "ai", "python", "productivity"

### Step 4: Generate Base ID
- Format: `{source-type}-{date}-{topic}`
- Source prefix from detectedSource (lowercase)
- Date in YYYY-MM-DD format
- Topic as 1-2 words (hyphen-separated, lowercase)
- Example: `podcast-2024-12-08-ai-healthcare`

### Step 5: Quality Check & Return
- Ensure ID is lowercase, hyphen-separated
- Validate length (20-50 characters preferred)
- Return JSON with:
  - `contentId`: Generated ID
  - `detectedSource`: Confirmed source type
  - `sourceConfidence`: 0.0-1.0 confidence in source detection
  -