| name | viral-content |
| description | Generate viral content strategy — shorts planning with hooks, engagement scoring, and platform-optimized social media posts. USE THIS SKILL when the user wants to create viral clips, plan shorts for TikTok/YouTube/Instagram, or generate social media posts. Trigger phrases include "plan shorts", "viral strategy", "social posts", "TikTok post", "YouTube description", "Instagram caption", "engagement optimization". |
Viral Content Skill
This skill provides AI-powered viral content generation:
- Shorts Planning — Identify clip opportunities with hooks and engagement scoring
- Social Posts — Platform-optimized copy for TikTok, YouTube, Instagram, LinkedIn, X
Setup
Before using viral content tools, configure your Gemini API key:
- Get an API key from https://aistudio.google.com/apikey
- Run the
setup_vidpipe tool with your API key
- Run
vidpipe_status to verify configuration
When to Use
| Scenario | Tool |
|---|
| Check configuration status | vidpipe_status |
| Plan short clips from video | plan_shorts |
| Generate social media posts | generate_social_posts |
Tools
plan_shorts
AI-powered shorts strategy with hook-first content planning.
Input:
videoPath (string, required): Path to video filetranscriptJson (string, required): Transcript as JSON array of {start, end, text} segments
Output: Strategy with shorts including:
id: Unique slugtitle: Compelling titlestart/end: Timestampshook: Attention-grabbing momenthookText: ≤60 chars for on-screen overlayengagementScore: 1-100 predicted engagementplatforms: tiktok, youtube_shorts, instagram_reelstags: 3-6 lowercase tags
Strategy: Hook-First (Z→A→B→C)
Lead with the most exciting moment, then provide context. Viewers decide in 3 seconds.
generate_social_posts
Generate platform-specific social media posts.
Input:
videoPath (string, required): Path to video fileplatforms (array, required): Target platforms — tiktok, youtube, instagram, linkedin, twittercontext (string): Optional context about the video
Output: Posts for each platform with:
platform: Target platformcontent: Post copyhashtags: Relevant tagscharacterCount: Length validation
Platform Constraints:
| Platform | Max Length | Style |
|---|
| TikTok | 150 chars | Emoji-heavy, casual, trending hashtags |
| YouTube | SEO-focused | Title + description, searchable keywords |
| Instagram | 2200 chars | Visual storytelling, 30 hashtags max |
| LinkedIn | 3000 chars | Professional thought-leadership |
| X/Twitter | 280 chars | Thread-ready, conversation starters |
Examples
Plan shorts:
Plan viral shorts from this video and transcript
→ plan_shorts with video path and transcript JSON
Generate posts:
Write social media posts for TikTok and Instagram
→ generate_social_posts with platforms: ["tiktok", "instagram"]
Full workflow:
- Use
video-analyze skill to get clip analysis
- Use
plan_shorts with transcript for detailed strategy
- Use
video-edit skill to extract clips
- Use
generate_social_posts for platform copy
Content Types to Identify
- Key insights and revelations
- Surprising facts or controversial takes
- Emotional peaks (humor, inspiration, frustration)
- Before/after demonstrations
- Quick tips and how-tos
- Quotable moments
