swarmxq-creative-director

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

1|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/sabiscore/swarmxq --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/swarmxq/tree/main/.ai/skills/swarmxq-creative-director
Command: npx skills add https://github.com/sabiscore/swarmxq --skill swarmxq-creative-director-sabiscore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Short-form videos fail when hooks are weak, captions violate platform limits, or storyboards lack visual specificity. This Skill encodes every creative constraint governing the SwarmXQ video generation subsystem so that script sections, tone routing, virality scoring, captions, and storyboards 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 ComfyUI-ready [VISUAL:] tags), [RESOLUTION] (action frame), and [CTA] (5–8 specific words). - Tone & Virality Governance: Maintains the TONE_RULES map for eight tone variants and the ViralitySignal scoring contract with a fixed weighted formula (hookStrength×0.35 + completionProxy×0.25 + shareability×0.25 + seoScore×0.15). - Caption & Storyboard Gates: Enforces CAPTION_RULES (firstLine ≤40 chars, 3–5 hashtags, platform character caps for TikTok/Reels/Shorts) and storyboard scene-count ranges with per-scene comfyPrompt standards. - Use Case: When modifying video-orchestrator.ts prompt templates, adding a new tone variant, or changing virality-scorer.ts, load this Skill to apply the hook blocklist, tone table, and scoring rubric before committing changes. ## Quick Start Load this skill alongside swarmxq-video-pipeline-architect and ask the AI to review or modify the scripting stage prompt in video-orchestrator.ts for hook quality compliance.

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, open with tension or a counterintuitive claim, and never start with preamble like "In today's video" or self-referential openers like "I" or "My". Use a taxonomy pattern such as Number Shock, Named Villain, or Identity Challenge for measurable scroll-stop power.

How is the virality score calculated for video scripts?

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 result.

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 dashboard should surface the soft limit as the primary warning badge.

How many storyboard scenes should a short 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.

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.

When should this skill not be used alone?

This skill governs creative constraints only and must be loaded alongside swarmxq-video-pipeline-architect, because creative quality is enforced inside pipeline stage functions. It does not cover pipeline orchestration, stage sequencing, or infrastructure concerns.