swarmxq-creative-director

Enforces creative quality rules for short-form video scripts, captions, and storyboards.

1|Updated Sep 3, 2026
One-click install
npx skills add https://github.com/sabiscore/the-yap-engine --skill swarmxq-creative-director-sabiscore
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swarmxq-creative-director
Source: https://github.com/sabiscore/the-yap-engine/tree/main/.ai/skills/swarmxq-creative-director
Command: npx skills add https://github.com/sabiscore/the-yap-engine --skill swarmxq-creative-director-sabiscore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Short-form videos fail when hooks are weak, captions exceed platform limits, or storyboards lack visual specificity. This Skill encodes every creative constraint governing the SwarmXQ video generation pipeline so that script sections, virality scores, captions, and storyboard scenes meet enforceable quality gates instead of relying on subjective judgment. ## Core Features & Use Cases - Script Section Contracts: Defines non-negotiable rules for [HOOK] (≤18 words, no preamble openers), [BODY] (stakes escalation with [VISUAL:] tags), [RESOLUTION] (action frame), and [CTA] (5–8 specific words). - Virality Scoring Contract: Specifies the ViralitySignal interface, the weighted formula (hookStrength×0.35 + completionProxy×0.25 + shareability×0.25 + seoScore×0.15), and scoring rubric anchors. - Caption & Storyboard Gates: Enforces CAPTION_RULES (firstLine ≤40 chars, 3–5 hashtags, platform character caps for TikTok/Reels/Shorts) and storyboard scene counts per video length with ComfyUI-ready comfyPrompt standards. - Use Case: When modifying video-orchestrator.ts tone prompts or adding a new tone variant to VideoJobRequest, load this Skill to update TONE_RULES, TONE_BACKGROUNDS, and TONE_ACCENTS in the correct order without breaking the pipeline. ## Quick Start Load this skill alongside swarmxq-video-pipeline-architect before making any change to script prompts, tone routing, virality scoring, or caption generation in the video pipeline.

Frequently Asked Questions about swarmxq-creative-director

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a hook for a TikTok or YouTube Shorts video script?▼

Keep the hook at 18 words or fewer and open with tension, a number, or a counterintuitive claim. Never start with preamble like "In today's video" or self-referential openers like "I" or "My" — these are blocklisted and trigger regeneration.

How is a virality score calculated for short-form video scripts?▼

The overall score is a weighted aggregate: hookStrength×0.35 + completionProxy×0.25 + shareability×0.25 + seoScore×0.15. Each dimension is scored 0–1 against rubric anchors, and hook strength carries the most weight because it gates all other engagement.

What are the caption character limits for TikTok, Reels, and YouTube Shorts?▼

TikTok and Instagram Reels have a 2,200-character hard cap with soft in-feed limits of 280 and 125 characters respectively. YouTube Shorts allows 5,000 characters with a 300-character soft limit. The firstLine must stay under 40 characters.

How many storyboard scenes should a short-form video have?▼

Scene count depends on video length: short videos (≤45s) need 5–7 scenes, medium (46–120s) need 6–10, and long (121–600s) need 11–18. Under the minimum fails with STORYBOARD_FAILED; over the maximum is truncated with a warning.

How do I add a new tone variant to the video generation pipeline?▼

First add a row to the TONE_RULES table, then add matching TONE_BACKGROUNDS and TONE_ACCENTS entries in ffmpeg-video-renderer.ts, and finally add the TONE_RULES entry in video-orchestrator.ts. Never reverse this order.

What makes a comfyPrompt valid for storyboard scene generation?▼

A valid comfyPrompt includes resolution (720p or 480p), aspect ratio (16:9 or 9:16), at least one style keyword like cinematic or photorealistic, and a specific subject description. Generic phrases like "developer working" are rejected.