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.py to check performance against assets/evaluations.json.