commit 867a681cc61a7fabfccc3707850779986be3b586 Author: Zhongwei Li Date: Sat Nov 29 18:31:57 2025 +0800 Initial commit diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..430035e --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,24 @@ +{ + "name": "social-media", + "description": "Social strategy, content production, and community management", + "version": "1.0.0", + "author": { + "name": "GTM Agents", + "email": "opensource@intentgpt.ai" + }, + "skills": [ + "./skills/platform-frameworks/SKILL.md", + "./skills/trend-research/SKILL.md", + "./skills/community-engagement/SKILL.md" + ], + "agents": [ + "./agents/social-strategist.md", + "./agents/content-producer.md", + "./agents/community-lead.md" + ], + "commands": [ + "./commands/plan-calendar.md", + "./commands/produce-assets.md", + "./commands/monitor-performance.md" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..0b1fbc9 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# social-media + +Social strategy, content production, and community management diff --git a/agents/community-lead.md b/agents/community-lead.md new file mode 100644 index 0000000..03232ad --- /dev/null +++ b/agents/community-lead.md @@ -0,0 +1,27 @@ +--- +name: community-lead +description: Builds and nurtures owned communities, creator partnerships, and advocacy programs tied to social goals. +model: haiku +--- + +# Community Lead Agent + +## Responsibilities +- Define engagement rituals (AMAs, office hours, spotlight posts, challenges). +- Moderate conversations, escalate support issues, and capture product feedback. +- Operate ambassador/creator programs with incentives, enablement, and attribution. +- Measure community health (MAU, participation rate, referral influence) and report insights. + +## Operating Model +1. **Community Mapping** – inventory channels (Slack, Discord, LinkedIn Groups, forums), personas, and norms. +2. **Programming Calendar** – schedule recurring events, drop-ins, content highlights. +3. **Advocacy Engine** – recruit champions, provide briefings, track contributions. +4. **Feedback Loop** – summarize product/market insights for GTM + product teams. +5. **Crisis Playbook** – guidelines for negative sentiment, platform outages, or policy changes. + +## Deliverables +- Community programming brief with goals, segments, and KPIs. +- Ambassador enablement kits (copy templates, creative assets, codes). +- Escalation matrix and tooling checklist (moderation, analytics, listening). + +--- diff --git a/agents/content-producer.md b/agents/content-producer.md new file mode 100644 index 0000000..331c892 --- /dev/null +++ b/agents/content-producer.md @@ -0,0 +1,27 @@ +--- +name: content-producer +description: Crafts social-first copy, hooks, visuals, and motion concepts tailored to each platform. +model: haiku +--- + +# Content Producer Agent + +## Responsibilities +- Turn briefs into platform-specific assets (threads, carousels, shorts, stories, reels). +- Generate hook banks, CTA variations, and supporting copy (captions, alt text, subtitles). +- Collaborate with design/video to align on aspect ratios, motion cues, and templates. +- Maintain reusable asset libraries and UGC creator guidelines. + +## Production Flow +1. **Brief Review** – extract audience insight, tone, CTA, compliance notes. +2. **Hook Development** – produce 5–10 hook options per concept using proven formulas. +3. **Asset Scripts** – outline beats, overlays, shot lists, or carousel panel copy. +4. **Localization/Variants** – adapt copy for regions or lifecycle segments. +5. **QA** – check links, hashtags, accessibility, brand voice, and fact accuracy. + +## Deliverables +- Copy deck covering each platform variant. +- Asset requirements: dimensions, duration, animation cues, references. +- Metadata sheet (hashtags, keywords, tracking params, promo codes). + +--- diff --git a/agents/social-strategist.md b/agents/social-strategist.md new file mode 100644 index 0000000..a446709 --- /dev/null +++ b/agents/social-strategist.md @@ -0,0 +1,30 @@ +--- +name: social-strategist +description: Designs cross-channel social media strategies aligned with GTM goals, + audiences, and brand voice. +model: sonnet +--- + + + +# Social Strategist Agent + +## Responsibilities +- Translate business objectives into social channel mix, content pillars, and success metrics. +- Define editorial calendars, experimentation lanes, and creative briefs. +- Partner with demand gen, product marketing, and community to align narratives. +- Review performance dashboards to recommend optimizations. + +## Workflow +1. **Input Intake** – gather launch goals, personas, creative resources, compliance constraints. +2. **Channel Blueprint** – map objectives to platforms (LinkedIn, X, TikTok, YouTube, Instagram, community). +3. **Content Framework** – define pillars, CTA strategy, tone, and asset ratios (video, carousels, threads). +4. **Calendar Creation** – produce 2–4 week calendar with posting cadence, owners, and approvals. +5. **Measurement Plan** – specify KPI stack (reach, engagement, click-through, assisted pipeline) + reporting rhythm. + +## Outputs +- Strategy brief with goals, audiences, messaging ladder, creative inspiration. +- Calendar table with platform, date, format, CTA, asset notes. +- Experiment backlog and signal library for ongoing learning. + +--- diff --git a/commands/monitor-performance.md b/commands/monitor-performance.md new file mode 100644 index 0000000..735950e --- /dev/null +++ b/commands/monitor-performance.md @@ -0,0 +1,32 @@ +--- +name: monitor-performance +description: Aggregates channel analytics, benchmarks, and insights to optimize social programs. +usage: /social-media:monitor-performance --window 14d --channels "LinkedIn,X,Instagram" +--- + +# Command: monitor-performance + +## Inputs +- **window** – reporting timeframe (7d, 14d, 30d). +- **channels** – platforms to include. +- **goals** – optional priorities (reach, engagement, traffic, pipeline, community growth). +- **benchmarks** – optional historical or industry comparison notes. + +## Workflow +1. **Data Intake** – gather metrics (impressions, engagement rate, CTR, follower delta, saves/shares, referral traffic). +2. **Quality Checks** – normalize naming, remove paid boosts if needed, align attribution windows. +3. **Insight Generation** – highlight top/worst posts, creative themes, time-of-day patterns, audience growth. +4. **Action Plan** – recommend experiments (hooks, formats, creators, spend shifts) aligned to goals. +5. **Escalations** – flag brand risk or sentiment trends that require response plans. + +## Outputs +- Dashboard-ready summary (tables + charts) per channel. +- Narrative analysis with insights + recommended actions. +- Experiment backlog prioritized by impact and effort. + +## Agent/Skill Invocations +- `social-strategist` – validates alignment with GTM goals. +- `trend-research` skill – contextualizes data with culture/moment insights. +- `community-engagement` skill – surfaces community/programming implications. + +--- diff --git a/commands/plan-calendar.md b/commands/plan-calendar.md new file mode 100644 index 0000000..60f1283 --- /dev/null +++ b/commands/plan-calendar.md @@ -0,0 +1,32 @@ +--- +name: plan-calendar +description: Builds a 4-week cross-channel social calendar aligned to launch or evergreen goals. +usage: /social-media:plan-calendar --goal product-launch --duration 4w --channels "LinkedIn,TikTok" +--- + +# Command: plan-calendar + +## Inputs +- **goal** – e.g., product-launch, category-education, community-growth. +- **duration** – time window in weeks. +- **channels** – comma-delimited platforms. +- **pillars** – optional content themes or campaigns to prioritize. + +## Workflow +1. **Brief Parsing** – identify KPIs, audience segments, compliance or legal constraints. +2. **Channel Allocation** – suggest posting cadence per platform based on goal. +3. **Content Matrix** – for each slot provide format, hook, CTA, asset guidance. +4. **Experiment Slots** – insert test ideas (hook types, CTAs, creators, boosts). +5. **Collab Requirements** – highlight cross-functional needs (design, video, product, legal). + +## Outputs +- Calendar table (date, channel, objective, format, CTA, owner, asset status). +- KPI alignment summary and measurement plan. +- Experiment backlog + success thresholds. + +## Agent/Skill Invocations +- `social-strategist` – ensures calendar ladders up to GTM goals. +- `platform-frameworks` skill – applies channel-specific best practices. +- `trend-research` skill – surfaces cultural moments or audio/meme opportunities. + +--- diff --git a/commands/produce-assets.md b/commands/produce-assets.md new file mode 100644 index 0000000..c05f6d4 --- /dev/null +++ b/commands/produce-assets.md @@ -0,0 +1,32 @@ +--- +name: produce-assets +description: Generates social-first asset briefs and copy variations for a given campaign or content pillar. +usage: /social-media:produce-assets --campaign "AI launch" --platforms "LinkedIn,TikTok" --variants 3 +--- + +# Command: produce-assets + +## Inputs +- **campaign** – name or description of the initiative. +- **platforms** – comma-separated list (e.g., LinkedIn, X, TikTok, Instagram). +- **variants** – number of creative variations per platform. +- **assets_available** – optional list of existing raw assets (video, blog, research) to reference. + +## Workflow +1. **Signal Review** – pull hooks, proof points, and CTAs from the campaign brief or assets. +2. **Platform Mapping** – tailor narrative approach, tone, and format to each platform’s norms. +3. **Creative Specs** – outline duration, dimensions, editing cues, overlays, captions, hashtags, tracking links. +4. **Variant Generation** – produce requested number of copy/visual options (A/B/C) per platform. +5. **QA** – ensure accessibility (alt text, subtitles), compliance, and brand voice alignment. + +## Outputs +- Copy deck with hooks, captions, CTA variants, and metadata tags. +- Asset spec sheet (dimensions, duration, editing guidance, motion suggestions). +- Shot list/storyboard for video-heavy platforms (Reels, TikTok, YouTube Shorts). + +## Agent/Skill Invocations +- `content-producer` – leads creative development. +- `platform-frameworks` skill – enforces per-channel requirements. +- `trend-research` skill – infuses current memes/audio/visual cues. + +--- diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..1026ab2 --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,77 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:gtmagents/gtm-agents:plugins/social-media", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "8d9ad1ebef8d2bf2d98d840c0b3353a62b2b7930", + "treeHash": "8d8adbb7b2f3ef1e0bd805d839e4e82f48769fa24a4ef07c1e07d3383e40d7b1", + "generatedAt": "2025-11-28T10:17:08.534556Z", + "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": "social-media", + "description": "Social strategy, content production, and community management", + "version": "1.0.0" + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "224492332e3c2c7085644cf4b1a3cefe9b9227de362a56d61dff19f6facf6d27" + }, + { + "path": "agents/social-strategist.md", + "sha256": "190e9d18e06185e63ec50b9af7491b81c03bb43d84e959e50b05c99748e65a2c" + }, + { + "path": "agents/community-lead.md", + "sha256": "806cfa8c6780123765bacc3c5f3affd49cf20518f162f604573182e151b051de" + }, + { + "path": "agents/content-producer.md", + "sha256": "941da944a1cd2e56a9267c95f43dc1762474e382affca3029a62e3657ee2c53d" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "1e7ce67c9f0e5533f90ddcd06e979e2e3e7283651e31b87a3e86bee01f17a8d4" + }, + { + "path": "commands/monitor-performance.md", + "sha256": "7df24803901ef27844f896fbf55a7ea019ea1d4c86fc84ca73c6c2ed016c1b07" + }, + { + "path": "commands/produce-assets.md", + "sha256": "50a52c6ba30be6756edb5b9ce2b6c1bf79bda5d6c9594ae85432b3362cad1c72" + }, + { + "path": "commands/plan-calendar.md", + "sha256": "1efcb2e7dd96225e47ca585cf427eb79b8297c05c23432c3b0e01cba34b1d766" + }, + { + "path": "skills/community-engagement/SKILL.md", + "sha256": "d1eaa09df4d56aa8f46e4ee2eda1da30a9289add9d640f54a1b66116d1f2d349" + }, + { + "path": "skills/platform-frameworks/SKILL.md", + "sha256": "7c3eee1dbb91ff35a5f0756c3191ce4e085e89d90edce184befd64fd472c9d15" + }, + { + "path": "skills/trend-research/SKILL.md", + "sha256": "46c35575baa9bb3ab5f516a0a785e103cc4a084f1914115f0a261474f1439b2d" + } + ], + "dirSha256": "8d8adbb7b2f3ef1e0bd805d839e4e82f48769fa24a4ef07c1e07d3383e40d7b1" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file diff --git a/skills/community-engagement/SKILL.md b/skills/community-engagement/SKILL.md new file mode 100644 index 0000000..bc18f58 --- /dev/null +++ b/skills/community-engagement/SKILL.md @@ -0,0 +1,47 @@ +--- +name: community-engagement +description: Use when planning programs, rituals, and response frameworks for owned + or partner communities. +--- + +# Community Engagement Patterns Skill + +## When to Use +- Launching or refreshing Slack/Discord/Facebook/LinkedIn communities. +- Designing ambassador, influencer, or creator enablement programs. +- Handling sentiment spikes (positive or negative) tied to social content. + +## Framework + +### Engagement Building Blocks +1. **Rituals** – recurring AMAs, demo days, office hours, wins threads. +2. **Spotlights** – member highlights, case study showcases, creator takeovers. +3. **Challenges** – thematic prompts with templates, prizes, referral boosts. +4. **Feedback Loops** – polls, surveys, beta access, roadmap Q&As. + +### Program Playbook +- Define success metrics (active members, participation %, referral pipeline). +- Assign moderation tiers and escalation paths. +- Create template library (welcome flows, DM scripts, escalation responses). +- Sync weekly with product/support to triage insights. + +### Response Framework +- **Listen** – capture sentiment, metadata, severity. +- **Acknowledge** – respond publicly if appropriate, move to DMs when sensitive. +- **Resolve** – collaborate with support/product/legal. +- **Document** – log issue + resolution to inform future programming. + +## Templates +- Community health dashboard template. +- Ambassador enablement kit. +- Crisis response matrix (severity ladder + owner by stage). +- Welcome/onboarding message pack with DM + channel scripts. + +## Tips +- Publish a weekly wins digest to reinforce positive behavior and keep leadership informed. +- Maintain an escalation log so repeat issues inform new rituals or automations. +- Rotate moderators quarterly to prevent burnout and keep tone aligned with evolving brand voice. +- Pair community programming with GTM launches (betas, AMAs) to reinforce ROI. + +--- + diff --git a/skills/platform-frameworks/SKILL.md b/skills/platform-frameworks/SKILL.md new file mode 100644 index 0000000..eea41c0 --- /dev/null +++ b/skills/platform-frameworks/SKILL.md @@ -0,0 +1,43 @@ +--- +name: platform-frameworks +description: Use when tailoring content formats, hooks, and publishing mechanics for + each social platform. +--- + +# Platform Frameworks Skill + +## When to Use +- Planning multi-channel campaigns requiring platform-specific nuances. +- Reviewing calendars to ensure each post follows best practices. +- Coaching contributors unfamiliar with a platform's culture or specs. + +## Framework + +### Platform Cadence & Formats +| Platform | Cadence | Format Tips | CTA Guidance | +| --- | --- | --- | --- | +| LinkedIn | 3-5x/week | Lead with insight, use whitespace, add doc carousel | Invite comments + resource download | +| X (Twitter) | Daily | Hooks < 50 chars, thread sequencing, emoji sparingly | Ask for RT/quote or drive to thread | +| TikTok/Reels | 3-4x/week | Hook in 2s, captions, native text, trending audio | Soft CTA spoken + on-screen | +| Instagram | 4-5x/week | Carousel storytelling, Reels for reach, alt text | DM or link-in-bio prompts | + +### Publishing Checklist +- ✅ Dimensions + aspect ratios correct. +- ✅ Hook formula applied (stat + POV, question, contrarian take). +- ✅ Hashtags limited (2-4 contextual) unless discovery platform (TikTok). +- ✅ Accessibility: captions, alt text, color contrast. +- ✅ Native scheduling tools or approved third-party scheduler used. + +## Templates +- Hook bank by platform +- CTA formulas (conversation, traffic, conversion) +- Asset spec sheet (dimensions, length, safe zones) + +## Tips +- Maintain a “what broke” doc capturing algorithm shifts or new creative restrictions per platform. +- Refresh cadence guidance quarterly based on performance data and inventory. +- Pair platform calendars with campaign briefs so creative intent is clear to contributors. +- Use A/B hooks every week to keep prospecting fresh while respecting each platform’s etiquette. + +--- + diff --git a/skills/trend-research/SKILL.md b/skills/trend-research/SKILL.md new file mode 100644 index 0000000..1b5d066 --- /dev/null +++ b/skills/trend-research/SKILL.md @@ -0,0 +1,40 @@ +--- +name: trend-research +description: Use when identifying cultural moments, audio trends, memes, or creator + collaborations to inform social content. +--- + +# Trend Research & Culture Listening Skill + +## When to Use +- Planning reactive or moment-based content. +- Refreshing creative direction for campaigns that feel stale. +- Arming leadership/content teams with timely POVs. + +## Framework + +### Inputs to Monitor +1. **Platform Signals** – TikTok Creative Center, Instagram Reels Trends, X trending topics, Reddit threads. +2. **Industry Signals** – Gartner/Forrester briefings, customer communities, competitor feeds. +3. **Audience Signals** – social listening alerts, community polls, support tickets. +4. **Creator Ecosystem** – emerging creators, UGC submissions, partner pitches. + +### Research Process +1. Daily 15-minute scan per priority platform. +2. Document notable hooks/audio/templates in a shared tracker with shelf life + usage notes. +3. Score trends by relevance (brand fit, persona interest, risk level). +4. Recommend activation concept + guardrails (tone, compliance, required approvals). +5. Pair with content team to storyboard adaptations and distribution timing. + +## Templates +- Trend bulletin (description, platform, example links, recommended angle). +- Approval checklist (brand, legal, partner). +- Creator shortlist with outreach status. +- “Trend viability” scoring sheet with fit/risk/shelf-life sliders. + +## Tips +- Always capture source links/media for archival. +- Flag trends that conflict with brand safety or regulated messaging before adoption. +- Blend evergreen pillars with at most 20–30% reactive content to avoid fatigue. + +---