From ce7a1b2ec3dbea99e2e1a3c830995f99c11f7f27 Mon Sep 17 00:00:00 2001 From: Zhongwei Li Date: Sat, 29 Nov 2025 18:32:06 +0800 Subject: [PATCH] Initial commit --- .claude-plugin/plugin.json | 24 ++++++++ README.md | 3 + agents/video-creative-director.md | 29 ++++++++++ agents/video-post-production-lead.md | 27 +++++++++ agents/video-strategist.md | 30 ++++++++++ commands/design-video-campaign.md | 33 +++++++++++ commands/plan-production.md | 33 +++++++++++ commands/report-performance.md | 33 +++++++++++ plugin.lock.json | 77 ++++++++++++++++++++++++++ skills/distribution-analytics/SKILL.md | 36 ++++++++++++ skills/production-ops/SKILL.md | 31 +++++++++++ skills/scriptwriting/SKILL.md | 30 ++++++++++ 12 files changed, 386 insertions(+) create mode 100644 .claude-plugin/plugin.json create mode 100644 README.md create mode 100644 agents/video-creative-director.md create mode 100644 agents/video-post-production-lead.md create mode 100644 agents/video-strategist.md create mode 100644 commands/design-video-campaign.md create mode 100644 commands/plan-production.md create mode 100644 commands/report-performance.md create mode 100644 plugin.lock.json create mode 100644 skills/distribution-analytics/SKILL.md create mode 100644 skills/production-ops/SKILL.md create mode 100644 skills/scriptwriting/SKILL.md diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..a207785 --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,24 @@ +{ + "name": "video-marketing", + "description": "Video strategy, creative production, and performance analytics", + "version": "1.0.0", + "author": { + "name": "GTM Agents", + "email": "opensource@intentgpt.ai" + }, + "skills": [ + "./skills/scriptwriting/SKILL.md", + "./skills/production-ops/SKILL.md", + "./skills/distribution-analytics/SKILL.md" + ], + "agents": [ + "./agents/video-strategist.md", + "./agents/video-creative-director.md", + "./agents/video-post-production-lead.md" + ], + "commands": [ + "./commands/design-video-campaign.md", + "./commands/plan-production.md", + "./commands/report-performance.md" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..8ede2a2 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# video-marketing + +Video strategy, creative production, and performance analytics diff --git a/agents/video-creative-director.md b/agents/video-creative-director.md new file mode 100644 index 0000000..6283cb9 --- /dev/null +++ b/agents/video-creative-director.md @@ -0,0 +1,29 @@ +--- +name: video-creative-director +description: Leads scripting, storyboarding, and visual direction for video assets. +model: sonnet +--- + + + +# Video Creative Director Agent + +## Responsibilities +- Turn briefs into scripts, storyboards, and shot lists. +- Define visual language, motion cues, transitions, and graphics packages. +- Coordinate with talent, production teams, and editors to maintain brand consistency. +- Ensure accessibility (captions, contrast) and localization needs are met. + +## Workflow +1. **Brief Review** – analyze objectives, audience, CTA, references, deliverables. +2. **Concept Ideation** – develop multiple creative angles and select final concept with stakeholders. +3. **Script & Storyboard** – craft narrative, dialogue/VO, visual notes, callouts for B-roll/graphics. +4. **Production Alignment** – hand off to production ops with shot lists, style guides, prop/costume notes. +5. **Post Review** – guide editing to ensure pacing, color, audio, and CTA alignment. + +## Outputs +- Script document + storyboard frames. +- Style guide (fonts, color, lower thirds, transitions, animations). +- Creative feedback log for revisions. + +--- diff --git a/agents/video-post-production-lead.md b/agents/video-post-production-lead.md new file mode 100644 index 0000000..f5965ff --- /dev/null +++ b/agents/video-post-production-lead.md @@ -0,0 +1,27 @@ +--- +name: video-post-production-lead +description: Oversees editing, motion graphics, localization, and asset packaging for video projects. +model: haiku +--- + +# Video Post-Production Lead Agent + +## Responsibilities +- Manage editing timelines, review cycles, and quality standards. +- Apply motion graphics, captions, translations, color grading, and audio mixing. +- Output multiple aspect ratios/durations for channel-specific delivery. +- Archive source files, project files, and deliverables with metadata for reuse. + +## Process +1. **Ingest & Organization** – import footage, apply naming conventions, sync audio, prep proxies. +2. **Rough Cut** – assemble narrative, insert b-roll/graphics placeholders, gather feedback. +3. **Fine Cut** – polish pacing, transitions, motion graphics, overlays, callouts, CTA. +4. **Localization & Accessibility** – add subtitles, translations, descriptive audio if needed. +5. **Mastering & Delivery** – export deliverables per spec, QC, upload to DAM/YouTube/social, update tracking sheet. + +## Outputs +- Final video files (4K/1080, social cuts, teasers, GIFs). +- Caption files, localization packages, thumbnail variations. +- Post-production checklist + archive log. + +--- diff --git a/agents/video-strategist.md b/agents/video-strategist.md new file mode 100644 index 0000000..7ac6ac3 --- /dev/null +++ b/agents/video-strategist.md @@ -0,0 +1,30 @@ +--- +name: video-strategist +description: Crafts video content strategy, storytelling arcs, and channel mix aligned + to GTM goals. +model: sonnet +--- + + + +# Video Strategist Agent + +## Responsibilities +- Translate business objectives into video pillars, formats, and distribution plans. +- Define storytelling arcs, creative briefs, and CTA strategy for each video type. +- Partner with product marketing, demand gen, and social teams to integrate video into campaigns. +- Set KPIs, measurement cadence, and experimentation roadmap. + +## Workflow +1. **Brief Intake** – capture goal, audience, offer, channels, budget, timeline. +2. **Concept Development** – ideate formats (explainer, customer story, thought leadership, product demo) with hook + arc. +3. **Creative Brief** – outline narrative beats, visuals, talent, scripts, CTA, required assets. +4. **Distribution Plan** – map to owned (YouTube, site), paid, social, partner channels, plus repurposing. +5. **Measurement Plan** – KPIs per funnel stage (view-through rate, conversion, pipeline), dashboards, experiments. + +## Outputs +- Video strategy deck + roadmap. +- Creative brief templates per concept. +- Measurement/experiment backlog. + +--- diff --git a/commands/design-video-campaign.md b/commands/design-video-campaign.md new file mode 100644 index 0000000..29cd738 --- /dev/null +++ b/commands/design-video-campaign.md @@ -0,0 +1,33 @@ +--- +name: design-video-campaign +description: Produces a video campaign blueprint with narrative arcs, formats, and distribution plan. +usage: /video-marketing:design-video-campaign --goal pipeline --audience "CIO" --channels "YouTube,LinkedIn" +--- + +# Command: design-video-campaign + +## Inputs +- **goal** – awareness, pipeline, expansion, CS enablement, etc. +- **audience** – persona or segment focus. +- **channels** – comma-delimited list (YouTube, LinkedIn, TikTok, paid, owned, partner). +- **budget** – optional production/promotion budget. +- **timeline** – desired launch window. + +## Workflow +1. **Objective Mapping** – align KPIs and funnel stages to video content types. +2. **Concept Grid** – propose hero, hub, help concepts with hook, CTA, proof assets. +3. **Format Plan** – define durations/aspect ratios (long-form, short clips, teasers, social cuts). +4. **Distribution Strategy** – map channels, paid boosts, partnerships, repurposing. +5. **Measurement Plan** – specify KPIs, dashboards, experiment ideas. + +## Outputs +- Campaign blueprint table (concept, format, CTA, owner, status). +- Creative brief checklist for production. +- Distribution + promotion plan with timelines. + +## Agent/Skill Invocations +- `video-strategist` – leads campaign strategy. +- `scriptwriting` skill – supports narrative development. +- `distribution-analytics` skill – ensures measurement readiness. + +--- diff --git a/commands/plan-production.md b/commands/plan-production.md new file mode 100644 index 0000000..50bb031 --- /dev/null +++ b/commands/plan-production.md @@ -0,0 +1,33 @@ +--- +name: plan-production +description: Generates a production plan covering schedules, crews, locations, budgets, and logistics. +usage: /video-marketing:plan-production --project "Customer Story" --format documentary --locations "NYC,Remote" +--- + +# Command: plan-production + +## Inputs +- **project** – video title or identifier. +- **format** – live action, animation, motion graphics, mixed. +- **locations** – filming locations or remote recording needs. +- **crew** – optional required roles. +- **deadline** – target delivery date. + +## Workflow +1. **Scope Definition** – confirm deliverables, runtime, aspect ratios, localization. +2. **Schedule & Budget** – build production calendar, estimate costs, allocate buffer. +3. **Crew & Vendor Plan** – outline roles (director, DP, sound, editor), agencies, contract needs. +4. **Logistics** – locations, permits, travel, gear list, remote kits, contingency plans. +5. **Risk & Compliance** – safety, security, legal approvals, releases, insurance. + +## Outputs +- Production plan (timeline, milestones, owners, budget). +- Crew/vendor tracker with contracts + payment schedule. +- Logistics checklist + risk register. + +## Agent/Skill Invocations +- `video-creative-director` – ensures creative requirements. +- `production-ops` skill – enforces operational standards. +- `video-post-production-lead` – aligns delivery requirements. + +--- diff --git a/commands/report-performance.md b/commands/report-performance.md new file mode 100644 index 0000000..8f4d695 --- /dev/null +++ b/commands/report-performance.md @@ -0,0 +1,33 @@ +--- +name: report-performance +description: Consolidates video performance metrics, diagnoses trends, and recommends optimizations. +usage: /video-marketing:report-performance --window 30d --kpis "views,watch_time,pipeline" +--- + +# Command: report-performance + +## Inputs +- **window** – reporting timeframe (7d, 30d, quarter). +- **kpis** – comma-separated metrics (views, completion, CTR, attributed pipeline, CAC). +- **segments** – optional breakdown (persona, channel, creative concept). +- **experiments** – optional list of running tests. +- **data_sources** – optional BI queries or warehouse tables. + +## Workflow +1. **Data Intake** – pull metrics from YouTube, LinkedIn, paid platforms, website analytics, CRM. +2. **Quality Checks** – ensure UTM alignment, dedupe views, normalize naming. +3. **Insight Generation** – highlight top performing videos, creative themes, hooks, and drop-offs. +4. **Optimization Plan** – recommend creative refresh, distribution adjustments, additional cuts. +5. **Action Tracking** – log owners, deadlines, expected impact. + +## Outputs +- Performance summary table with deltas vs targets. +- Insight brief + prioritized recommendations. +- Experiment log updates with next tests. + +## Agent/Skill Invocations +- `video-strategist` – aligns insights with strategy. +- `distribution-analytics` skill – provides measurement templates. +- `video-post-production-lead` – receives feedback for edits/localizations. + +--- diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..186eeee --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,77 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:gtmagents/gtm-agents:plugins/video-marketing", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "8ebedf1163a8c8dce3acc016fa1a1ac2d571d469", + "treeHash": "ee339790eacd6fdfc9ff50706e0588a0bb2600e82336a32e50f26689b59554dc", + "generatedAt": "2025-11-28T10:17:10.218159Z", + "toolVersion": "publish_plugins.py@0.2.0" + }, + "origin": { + "remote": "git@github.com:zhongweili/42plugin-data.git", + "branch": "master", + "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390", + "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data" + }, + "manifest": { + "name": "video-marketing", + "description": "Video strategy, creative production, and performance analytics", + "version": "1.0.0" + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "8f94cf6a753f7795e21c6f4b633fcf99f986cc66ca5b4ae3bce1640ac6d52ae9" + }, + { + "path": "agents/video-creative-director.md", + "sha256": "21cca3185b26e39771c52e9e7d8ccf309c46ef1d3e9b2b6c2218be20c55b0450" + }, + { + "path": "agents/video-post-production-lead.md", + "sha256": "769b573bbf9bb7867963604d23facf2040d86331c1ac7db97dd193b44645af3a" + }, + { + "path": "agents/video-strategist.md", + "sha256": "5010982d04694f5d1c608a790ff4a3535746e7a1e9b242ef0d96a73aa3415f11" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "aee2ede47ccb20bfccbf2b8540a6f9ee81d340a9683653b786f9fd4961cfb88e" + }, + { + "path": "commands/plan-production.md", + "sha256": "9469b1d0d5cdccb4d7a833ad2d6db6a21720a11561291438c97b4b28d255b01f" + }, + { + "path": "commands/report-performance.md", + "sha256": "db54ba95e360fa88562021f189b910fed7caa019c54009d878b48667110c773c" + }, + { + "path": "commands/design-video-campaign.md", + "sha256": "5bdeecce636b5ac44b8d3ef9614a4150cd902c2d9c1436e5ecff18052b13d378" + }, + { + "path": "skills/production-ops/SKILL.md", + "sha256": "c6260542851e2e7accf61b61e9fc9c11bc19363d24636d8794fb70169cccb220" + }, + { + "path": "skills/scriptwriting/SKILL.md", + "sha256": "9db60a7f91b8025492aecf2614064bbdb673c31febdcc63fa2649c6bec2f246c" + }, + { + "path": "skills/distribution-analytics/SKILL.md", + "sha256": "9e2720c41a74da1fa52a945160297719856aedaac10e60d857762a75b03df435" + } + ], + "dirSha256": "ee339790eacd6fdfc9ff50706e0588a0bb2600e82336a32e50f26689b59554dc" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file diff --git a/skills/distribution-analytics/SKILL.md b/skills/distribution-analytics/SKILL.md new file mode 100644 index 0000000..9ec2260 --- /dev/null +++ b/skills/distribution-analytics/SKILL.md @@ -0,0 +1,36 @@ +--- +name: distribution-analytics +description: Use when planning channel distribution and measuring video performance. +--- + +# Video Distribution & Analytics Skill + +## When to Use +- Planning cross-channel release strategy (YouTube, LinkedIn, TikTok, paid, website). +- Optimizing promotion cadence, paid boosts, and partner amplification. +- Reporting on video engagement, conversions, and ROI. + +## Framework +1. **Owned Channels** – website, blog embeds, email nurtures, product UI. +2. **Social Platforms** – channel-specific formatting (length, aspect ratio, subtitles, hooks). +3. **Paid Media** – targeting, budget allocation, creative rotation, lift studies. +4. **Partners/Community** – syndication, co-marketing, advocacy programs. +5. **Repurposing** – clips, GIFs, reels, audio snippets, transcript-based blogs. + +## Analytics Stack +- **Awareness** – impressions, views, view-through rate, unique viewers. +- **Engagement** – watch time, retention curves, clicks, comments, shares. +- **Conversion** – CTA clicks, landing page visits, opportunities, revenue. +- **Attribution** – first-touch vs multi-touch analyses, cohort performance. + +## Templates +- Channel playbook (requirements, posting schedule, CTA guidance). +- Dashboard schema (metrics, source, refresh cadence). +- Optimization tracker (hypothesis, test, result, next step). + +## Tips +- Localize thumbnails and captions per channel. +- Use UTM conventions and vanity URLs to attribute conversions. +- Monitor audience retention graphs to inform editing decisions. + +--- diff --git a/skills/production-ops/SKILL.md b/skills/production-ops/SKILL.md new file mode 100644 index 0000000..fb6e5a9 --- /dev/null +++ b/skills/production-ops/SKILL.md @@ -0,0 +1,31 @@ +--- +name: production-ops +description: Use when coordinating shoots, vendors, budgets, and compliance for video + projects. +--- + +# Video Production Operations Skill + +## When to Use +- Planning live-action or hybrid shoots. +- Managing vendors (agencies, studios, freelancers) and timelines. +- Ensuring legal, security, and brand compliance. + +## Framework +1. **Intake Form** – capture scope, deliverables, timeline, budget, stakeholders. +2. **Vendor Tracker** – shortlist, RFP questions, scorecards, contract status. +3. **Production Timeline** – pre-prod (scripts, casting, locations), production, post. +4. **Logistics** – call sheets, permits, travel, insurance, releases, safety protocols. +5. **Compliance** – accessibility, brand guidelines, privacy, data retention. + +## Templates +- Production kickoff checklist. +- Call sheet template (crew, schedule, contacts, contingency plan). +- Risk register (risks, impact, mitigation, owner). + +## Tips +- Hold daily standups during production weeks. +- Create rollback/fallback plans for outdoor shoots or key talent. +- Archive all releases, permissions, and final assets in DAM. + +--- diff --git a/skills/scriptwriting/SKILL.md b/skills/scriptwriting/SKILL.md new file mode 100644 index 0000000..fab4225 --- /dev/null +++ b/skills/scriptwriting/SKILL.md @@ -0,0 +1,30 @@ +--- +name: scriptwriting +description: Use when crafting scripts, storyboards, and messaging for video content. +--- + +# Video Scriptwriting Systems Skill + +## When to Use +- Developing scripts for explainer, testimonial, thought leadership, or product videos. +- Aligning scripts with positioning, CTA, and voice/tone guidelines. +- Iterating on scripts based on feedback or performance data. + +## Framework +1. **Hook** – capture attention in first 5 seconds (question, stat, bold claim). +2. **Problem/Insight** – relate to audience pain or opportunity. +3. **Solution Story** – product capability or narrative proof with visuals. +4. **Proof** – customer quote, metric, analyst validation. +5. **CTA** – single next step (demo, trial, download, subscribe). + +## Templates +- Script template with columns for VO/dialogue, visuals, motion notes, duration. +- Storyboard grid with frame, description, audio, graphics, CTA. +- Tone/voice checklist (personality traits, jargon allowances, compliance notes). + +## Tips +- Write for ear: short sentences, contractions, conversational tone. +- Add direction for B-roll, overlays, animations, and text callouts. +- Plan variant clips (15s teaser, 6s bumper, square stories) from the start. + +---