video-description

# Video Description This skill helps you create engaging, platform-optimized video descriptions. It synthesizes information from a video transcript and any provided supplementary context (like a blog post or technical specifications). ## Sequential Workflow Follow these steps to generate a high-quality description: 1. **Analyze Source Material**: Read the video transcript and any supplementary documents. Identify key topics, keywords, and calls to action. 2. **Determine Platform**: Identify the target platform (e.g., YouTube, Instagram, TikTok). If not specified, default to a general SEO-friendly format. 3. **Select Template**: Choose an appropriate template from [TEMPLATES.md](references/TEMPLATES.md) based on the video type and platform. 4. **Draft Description**: Create the description using the selected template. - **Point of View**: Always use first-person singular ("I", "my") instead of "we" or "our". - **Relevance**: Ensure the first few lines contain the most critical information and keywords. 5. **Add Metadata**: Include timestamps (if identifiable in the transcript), relevant links, and social CTA. - **Hashtags**: Limit to exactly 5 of the most relevant ones with broad appeal. 6. **Validate**: Run the [scripts/validate.py](scripts/validate.py) script to ensure the description meets platform-agnostic formatting standards. ## Reference Materials - **Templates**: See [TEMPLATES.md](references/TEMPLATES.md) for standard formats and platform variations. - **Examples**: See [EXAMPLES.md](references/EXAMPLES.md) for few-shot examples. - **Validation**: Detailed rules in [scripts/validate.py](scripts/validate.py). - **Regression Testing**: Run `pytest scripts/test_validate.py` to check performance against [assets/evaluations.json](assets/evaluations.json).