swarmxq-creative-director

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

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/Scardubu/SwarmXQ --skill swarmxq-creative-director-scardubu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swarmxq-creative-director
Source: https://github.com/Scardubu/SwarmXQ/tree/main/.ai/skills/swarmxq-creative-director
Command: npx skills add https://github.com/Scardubu/SwarmXQ --skill swarmxq-creative-director-scardubu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Short-form video generation pipelines often produce scripts with weak hooks, generic captions, and inconsistent storyboards that fail to retain viewers. This Skill encodes every creative constraint governing SwarmXQ video output so that tone routing, virality scoring, caption generation, and storyboard prompts stay consistent and enforceable across the video-orchestrator.ts pipeline. ## 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). - TONE_RULES Governance: Maintains the tone variant map (contrarian, urgent, educational, cinematic, warm, minimal, faceless_broll, kinetic_text) with prompt modifiers, colors, and archetypes. - 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) and storyboard scene counts, per-scene line format, and comfyPrompt standards. - Use Case: When adding a new tone variant to VideoJobRequest.tone, use 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 and ask the AI to review or modify the hook generation prompt in video-orchestrator.ts so it enforces the 18-word limit and HOOK_BLOCKLIST.

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 short-form 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", and match one of the seven hook patterns such as Number Shock or Named Villain.

How is the virality score calculated for generated videos?

The overall virality score uses a fixed weighted formula: hookStrength×0.35 + completionProxy×0.25 + shareability×0.25 + seoScore×0.15. Each dimension is scored 0–1 against rubric anchors, and weights must not change without a documented A/B test.

What caption rules apply for TikTok, Reels, and YouTube Shorts?

The firstLine must be 40 characters or fewer and never start with I, My, This, We, or Our. Use 3–5 hashtags with at least one niche tag, at most one verified trending tag, and respect platform caps: 2200 chars for TikTok and Reels, 5000 for YouTube Shorts.

How many storyboard scenes should a video have?

Scene count depends on job 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 pipeline?

Add the tone to the TONE_RULES table first, 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 scenes?

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" or "beautiful tech scene" are rejected.