By name: video-description description: Generates optimized descriptions for video platforms from transcripts and supplementary material. Use when the user asks for a video description or provides a transcript for video preparation.
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:
- Analyze Source Material: Read the video transcript and any supplementary documents. Identify key topics, keywords, and calls to action.
- Determine Platform: Identify the target platform (e.g., YouTube, Instagram, TikTok). If not specified, default to a general SEO-friendly format.
- Select Template: Choose an appropriate template from TEMPLATES.md based on the video type and platform.
- 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.
- 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.
- Validate: Run the scripts/validate.py script to ensure the description meets platform-agnostic formatting standards.
Reference Materials
- Templates: See TEMPLATES.md for standard formats and platform variations.
- Examples: See EXAMPLES.md for few-shot examples.
- Validation: Detailed rules in scripts/validate.py.
- Regression Testing: Run
pytest scripts/test_validate.pyto check performance against assets/evaluations.json.