Video Description
Documentsvideo-descriptionVideo Description is an Agent Skill for documents published in the GoogleCloudPlatform/devrel-demos repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/GoogleCloudPlatform/devrel-demos/blob/HEAD/agents/skills/video-description/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/video-description, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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.