Brief shortform
Production-ready brief for short-form video — hook, shot list, on-screen text, audio plan, caption, CTA, aspect, length. Covers live-action + motion-graphic. 1 hero + 2 variants per run. Reads the per-platform research-shortform catalog. Not for static visual assets (use brief-graphic), organic social copy (use write-social), paid ad creative (use write-ad), or rendering (use produce-video).From its SKILL.md
npx -y skills add hungv47/meta-skills --skill brief-shortformAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
10.6 KB, ~2.4k tokens by cl100k_base, as published. Nobody here has run it
Short-Form Brief — Orchestrator
Production-grade brief for one short-form asset. Reads the per-platform research catalog and turns an angle into a hero brief plus optional per-platform variants. Capability metadata (route triggers, prerequisites, load map, artifact contract) lives in routing.yaml. Agent table + dispatch graph + 4-sub-critic gate: references/agent-manifest.md. Methodology: references/playbook.md.
Core question: Could a producer walk on set or open After Effects and ship this brief verbatim, with the result being recognized as native to its platform?
Critical Gates — load first
- Soft-required:
research-shortformartifact. Missing → warn but proceed (briefs lack current trend signals; flag in artifact frontmatter). Stale beyond 30d trends or 180d mechanics → recommend re-run; user can override. - Variant cap (soft): 1 hero + 2 variant platforms default. More platforms extend the recut set with a per-recut cost+craft warning (
deepbudget; critic attention per variant thins past 2); re-invoke instead for full per-platform craft verification. Mode + tier:references/_shared/options-selection.md(DELIVERY, tier A). - Hard cap:
brand_modeisfounderORcompany— nohybrid. User picks per-brief. - No fabricated VoC. Every quote in the brief traces to
research/icp-research.md. Cold-start audience hint accepted but flagged in artifact. - Generic content fails. Critic gate enforces specificity at four axes (hook, production, algorithm-fit, brand-fit). Two cycles max, then ship
done_with_concerns. - Variants are TRUE RECUTS, not caption-resizes.
platform-tailor-agentrebuilds hook + audio + caption + CTA per platform.
Quality Gate — 4 critics
All four PASS required, max 2 rewrite cycles. Full 4-sub-critic rubric + Rewrite Routing Table: references/agent-manifest.md § 4-Sub-Critic Gate.
- Hook — clears platform's hook window from research; visual + verbal + text triad simultaneous; 3Q test passes; archetype tagged
- Production — every shot/scene has timing (seconds), framing, action, on-screen text, audio sync; audio names a track or VO direction; production notes filled
- Algorithm-fit — aligns with target platform's algorithmic preferences (completion thresholds, hold rates, audio rules, captions, watermarks)
- Brand-fit — caption + verbal lines use VoC phrases from ICP; voice matches
BRAND.mdarchetype; visual/motion direction anchored toCREATIVE-DIRECTION.md+FRAME.md(when present — FRAME.md gives the frame-composition layer: safe areas, type-at-distance, on-screen pacing) and to a realized exemplar (a shipped on-brand video / live product capture) rather than tokens alone — or the explicit fallback is recorded (frame_direction: absentwhen FRAME.md missing; token-only perreferences/_shared/realized-surface-grounding.md); no generic founder/company tropes
Before Starting
Apply references/_shared/before-starting-check.md. Recommended context:
| Artifact | Source | Required? |
|---|---|---|
docs/forsvn/artifacts/research/research-shortform/[slug].md | research-shortform | Soft-required (Critical Gate 1) — proceeds without it but flags trend_signals_stale |
research/icp-research.md | research-icp | Soft-required (Critical Gate 4) — proceeds with cold-start hint but flags voc_source: cold-start-hint |
brand/BRAND.md | create-brand | Recommended — brand_mode inference + voice archetype |
brand/CREATIVE-DIRECTION.md | create-brand | Recommended — house art direction (movement, light, pacing); anchor visuals to it + a realized exemplar, not tokens alone |
brand/FRAME.md | create-brand | Soft-required — frame direction (safe areas, type-at-distance, on-screen pacing, bumper grammar); matched by canonical path + headings. Present → spec shots/text to its safe areas + type floors + hold times. Absent → flag frame_direction: absent and fall back to CREATIVE-DIRECTION.md + DESIGN.md tokens, never silently (references/_shared/realized-surface-grounding.md) |
docs/forsvn/artifacts/marketing/campaign-plan.md | plan-campaign | Optional — inherits theme/dates/CTAs + ## Creative Direction (per-campaign art direction) if [slug] matches |
Pre-Dispatch + Mode
Run canonical Pre-Dispatch (references/_shared/pre-dispatch-protocol.md). Needed dimensions: angle · platforms (1-3 typical; more extends recuts with a cost warning) · brand_mode (founder | company) · production_mode (auto | live-action | motion-graphic | mixed) · market · optional campaign tie-in. Warm/Cold Start (5-question bundled) + Write-back map + VN auto-routing for polish chain: references/procedures/pre-dispatch.md.
Mode (references/_shared/mode-resolver.md): --fast skips Layer 2 (no critic, no platform-tailor) and runs Layer 1 + 1.5 single-pass via single-agent fallback. --fast does NOT skip Cold Start or Critical Gates 1-6.
Session execution profile (single-vs-multi): inherit per references/_shared/execution-policy.md.
Routing
Single route — always runs Layer 1 + Layer 1.5 + Layer 2. Multi-platform invocations add platform-tailor-agent in Layer 2. Full dispatch graph: references/agent-manifest.md.
Artifact Contract
- Hero path:
docs/forsvn/artifacts/marketing/brief-shortform/[slug]/brief.md. - Variant path:
docs/forsvn/artifacts/marketing/brief-shortform/[slug]/variants/[platform].md. - Lifecycle:
pipeline— one artifact per (angle, platform-set, market); re-run on angle/platform/market pivot. - Frontmatter:
type,role,status,decision_state,review_tool,reviewed_at,reviewer,date,slug,angle,brand_mode,production_mode,market,hero_platform,variants[],research_artifact,research_trend_signals_date,research_mechanics_date,campaign_tie_in,frame_direction,critic_passes[],critic_loop_count,polish_chain_applied. - Hero body sections (15, in order): TL;DR for the Producer · What This Brief Bets On · Audience & Voice · Format Specification · Hook · Storyboard · On-Screen Text Choreography · Audio Plan · Caption · CTA · Production Notes · What NOT To Do · Success Criteria · Variant Roadmap · Review Gate.
- Variant body sections: What Changed From Hero · Hook · Storyboard delta · Audio Plan · Caption · CTA.
- Consumed by: human producers / video editors / motion designers;
produce-video(consumes the brief to emit multi-runtime export bundles). - Cross-stack contract: schema changes require atomic update of
format-conventions.md§ "Frontmatter field order" + § "Body section headers (verbatim)". Review fields are additive and orthogonal — consumers match sections by heading.
Full template + per-section format rules: references/format-conventions.md.
Anti-Patterns
Read references/anti-patterns.md before output ships. 5 sub-critic clusters (Hook / Production / Algorithm-fit / Brand-fit / Variant) + 5 soft anti-patterns + 6 cross-cutting marketing-stack (VN auto-routing, polish-chain on FAIL, variant-cap creep, cross-stack contract drift, mixed production-mode transition principle).
Most common in practice: AI-slop openers ("Hey guys"), vague action verbs ("show product"), caption-only variant resizing, missing VoC in caption first-line, generic founder/company tropes.
Durable Rules (protected)
<!-- SLOW_UPDATE_START --> <!-- No pinned rules yet. Populate via the slow-update workflow (see references/slow-update-fence.md). Each pinned rule must (a) be procedural not instance-specific, (b) be earned from a regression or critic-flagged failure, (c) cite the artifact / decision record that justified pinning. --> <!-- SLOW_UPDATE_END -->Completion Status
- DONE — all 4 critics PASS within ≤2 cycles. Hero + all requested variants produced.
- DONE_WITH_CONCERNS — loop cap reached; remaining FAILs surfaced as warnings. Concerns pinned at top of artifact.
- BLOCKED — research stale beyond windows AND user declined re-run; ICP read fails; WebSearch/WebFetch blocked when verifying audio.
- NEEDS_CONTEXT — required inputs missing (no research AND user declined to proceed; no BRAND.md AND brand_mode unresolvable). State which upstream skill provides what's missing.
Execution
At brief-binding, bind the video target tool — inherit tool_targets or ask once per references/_shared/tool-target.md; production notes tune to it, tool-agnostic stays the default.
Offer the registry-gated fork (category video) — Brief-only: hand the brief to produce-video for the render-ready scaffold (→ evaluate-shortform); Assisted/Direct: a verified engine renders, you approve at the gate. See execution-fork.md; record execution_mode. When picking Assisted/Direct, batch-check the render surface first (all blockers at once + named fallback) — see capability-preflight.md.
Worked Example
End-to-end walkthrough (Pre-Dispatch warm-start → Layer 1 parallel → Layer 1.5 parallel → Layer 2 platform-tailor + critic PASS → polish chain → deliver; plus FAIL-handling cycle 2 + --fast variant): references/examples/brief-shortform-walkthrough.md. Two condensed reference briefs: references/_examples/example-1-vn-founder-tiktok.md, references/_examples/example-2-us-company-reels-shorts.md.
What ships with it: 70 files
743.9 KB alongside SKILL.md, 8 of them executable
agents/
- audio-agent.md5.2 KB
- copy-pack-agent.md5.2 KB
- critic-agent.md9.8 KB
- format-agent.md5.6 KB
- hook-agent.md6.6 KB
- platform-tailor-agent.md7.5 KB
- production-mode-agent.md5.9 KB
- storyboard-agent.md8.4 KB
- _template.md1.8 KB
- voc-extraction-agent.md5.4 KB
references/
- agent-manifest.md4.3 KB
- anti-patterns.md10.7 KB
- caption-cta-rules.md3.9 KB
- examples/brief-shortform-walkthrough.md10.5 KB
- _examples/example-1-vn-founder-tiktok.md8.9 KB
- _examples/example-2-us-company-reels-shorts.md9.9 KB
- _examples/example-3-b2b-founder-shorts-slowburn.md7.0 KB
- format-conventions.md11.7 KB
- playbook.md11.9 KB
- polish-chain.md3.6 KB
- procedures/dispatch-mechanics.md6.5 KB
- procedures/pre-dispatch.md8.1 KB
- production-modes.md4.3 KB
- _shared/before-starting-check.md9.8 KB
- _shared/capability-preflight.md5.6 KB
- _shared/execution-fork.md5.6 KB
- _shared/execution-policy.md7.0 KB
- _shared/hook-archetypes.md6.1 KB
- _shared/legibility-convention.md4.9 KB
- _shared/manifest-spec.md29.2 KB
- _shared/mode-resolver.md11.0 KB
- _shared/options-selection.md7.0 KB
- _shared/performance-data.md15.8 KB
- _shared/performance-grounding.md5.8 KB
- _shared/platform-intelligence/CONTRACT.md6.0 KB
- _shared/platform-intelligence/facebook.md9.8 KB
- _shared/platform-intelligence/founder-demo.md6.2 KB
- _shared/platform-intelligence/.generated-support151 B
- _shared/platform-intelligence/linkedin-launch.md15.5 KB
- _shared/platform-intelligence/linkedin.md31.0 KB
30 more files not listed here. See all 70 in the repository.