social-campaigns

Social Campaign

Turn your codebase into social media content

An AI skill that scans your project, understands your brand, researches competitors, builds a marketing strategy, and generates ready-to-post content — from inside your IDE.

Quick Install · Commands · How It Works · Examples · Docs · Contributing

---

The Problem

You built something good. A SaaS app, an e-commerce store, a developer tool. But nobody knows about it.

You've seen your competitors posting everywhere — Instagram, LinkedIn, Twitter, TikTok. Clean graphics, good captions, consistent branding. And you're wondering how they find the time.

They probably don't. They either hired an agency, have a marketing person, or they're using tools.

Social Campaign fills that gap. It's an AI skill that lives in your code editor and does what a social media agency does — except it understands your product because it reads your code.

What Makes This Different

Most social media tools ask you to fill out a brand questionnaire. What are your colors? Who's your audience? What tone do you want?

This skill doesn't ask. It reads.

It scans your codebase — CSS files, Tailwind config, landing page copy, pricing page, README, meta tags — and extracts your brand. Colors, fonts, voice, products, value proposition. Everything.

Then it goes further:

• Researches your competitors — finds them, analyzes their social presence, spots gaps
• Builds a real strategy — not "post 3 times a week" advice, but something tailored to your brand and market
• Generates actual content — images, captions, hashtags, posting schedules, platform-specific adaptations
• Saves everything organized — brand profile, competitor analysis, strategy doc, and every post asset in your project

Campaign Modes

Mode	Description
Full Campaign	Complete strategy + 2 weeks of content for brands starting from zero
Product Launch	14-day launch sequence: teasers, reveal, post-launch momentum
Content Refresh	Fresh content batch for brands with existing social presence
Single Post	One polished post with image + caption for a specific announcement
Competitor Spy	Deep competitive analysis without content generation
Repurpose	Turn blog posts, docs, and changelogs into social media content

Quick Install

One command. It detects your AI coding tool and drops the skill in the right place.

Mac / Linux:

curl -fsSL https://raw.githubusercontent.com/mrsahilbeniwal/social-campaigns/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/mrsahilbeniwal/social-campaigns/main/install.ps1 | iex

Or install manually:

git clone https://github.com/mrsahilbeniwal/social-campaigns.git
cp -r social-campaign ~/.agents/skills/   # global — works with most tools
# or
cp -r social-campaign ~/.claude/skills/   # Claude Code specifically
# or
cp -r social-campaign .agents/skills/     # this project only

The installer supports --claude, --global, and --local flags. Run with --help for all options.

Commands

After installing, use these in your AI coding assistant. 12 commands total, works across all supported platforms.

Campaign Modes — Choose Your Workflow

Command	What You Say	What Happens
campaign full	"Create a social media campaign for this project"	Full 6-phase workflow: audit, research, strategy, creative brief, generate, iterate
campaign launch	"I'm launching v2.0 next week — create a launch campaign"	Launch sequence: teasers, sneak peek, countdown, launch, results
campaign refresh	"I need fresh content for next week"	New content using your existing brand profile
campaign single	"Create one Instagram post about our new pricing"	1 polished post with image + caption
campaign spy	"What are my competitors doing on social media?"	Competitive analysis report, no content generation
campaign repurpose	"Turn my latest blog post into social media content"	Transforms existing content into platform-specific posts

Phase-Selective — Run Any Phase Independently

Command	What You Say	Output
campaign brand-audit	"Scan my project and extract the brand identity"	social-campaign/brand-profile.md
campaign competitors	"Research my top 5 competitors"	social-campaign/competitor-analysis.md
campaign strategy	"Build a content strategy for my brand"	social-campaign/content-strategy.md
campaign brief	"Develop the campaign's creative concept"	social-campaign/creative-brief.md
campaign generate	"Generate the actual images and captions"	social-campaign/content/ folder
campaign iterate	"Create A/B variants of my best posts"	Variants, repurposing, multi-language

Utility

Command	What You Say	Output
campaign status	"What's been generated so far?"	Lists all campaign files and their completion status

Smart Dependency Handling

Each phase builds on the last. If you jump straight to campaign generate without running the earlier phases, the skill detects missing dependencies and runs them first — or asks you to confirm.

You:     "Generate social media content for my project"
Agent:   Checks for brand-profile.md → Not found
         → Runs Phase 1 (Brand Audit) automatically
         → Checks for competitor-analysis.md → Not found
         → Runs Phase 2 (Competitor Intelligence)
         → Continues to content generation

You don't have to type these commands exactly. The AI agent understands natural language — "help me with Instagram for my SaaS" works just as well as campaign full. The commands are just the most direct way to get what you want.

How It Works

Social Campaign follows a 6-phase process. There's a mandatory human approval gate between each phase — the agent stops and waits for your sign-off before proceeding:

┌──────────────────────────────────────────────────────────────┐
│                    YOUR PROJECT CODEBASE                      │
│  CSS · Tailwind · Components · Copy · Images · Package.json  │
└───────────────────────────┬──────────────────────────────────┘
                            │
                            ▼
              ┌─────────────────────────┐
              │  PHASE 1: Brand Audit   │
              │  Scan → Extract → Map   │
              │  + Narrative Synthesis   │
              │  brand-profile.md       │
              └────────────┬────────────┘
                           │ ⛔ User approves
                           ▼
              ┌─────────────────────────┐
              │  PHASE 2: Competitor    │
              │  Research → Analyze     │
              │  competitor-analysis.md │
              └────────────┬────────────┘
                           │ ⛔ User approves
                           ▼
              ┌─────────────────────────┐
              │  PHASE 3: Strategy      │
              │  Pillars · Calendar     │
              │  content-strategy.md    │
              └────────────┬────────────┘
                           │ ⛔ User approves
                           ▼
              ┌─────────────────────────┐
              │  PHASE 3B: Creative     │
              │  Brief — Campaign       │
              │  Concept · Narrative    │
              │  Arc · Visual System    │
              │  creative-brief.md      │
              └────────────┬────────────┘
                           │ ⛔ User approves
                           ▼
              ┌─────────────────────────┐
              │  PHASE 4: Generate      │
              │  Preview 1st post →     │
              │  ⛔ Approve direction → │
              │  Batch remaining posts  │
              │  content/week-1/...     │
              └────────────┬────────────┘
                           │ ⛔ User reviews
                           ▼
              ┌─────────────────────────┐
              │  PHASE 5: Iterate       │
              │  A/B · Repurpose        │
              │  Optimize · Expand      │
              └─────────────────────────┘

Phase 1 — Brand Audit

The AI reads your code like a brand strategist reads a brand book:

• Colors from your CSS, Tailwind config, or design tokens
• Typography from your font imports and CSS declarations
• Voice and tone from your landing page copy, meta descriptions, and README
• Products and pricing from your feature sections and pricing pages
• Target audience inferred from your copy, pricing tiers, and use cases

Phase 2 — Competitor Intelligence

Using web search, it finds your top 3-5 competitors and analyzes:

• What platforms they're on and how active they are
• What content types get them the most engagement
• Where they're strong and where they're weak
• The white space — opportunities nobody is filling

Phase 3 — Content Strategy

Combining brand DNA and competitive insights, it creates:

• Platform-specific strategy (which platforms and why)
• Content pillars (4-5 recurring themes)
• A sample 2-week content calendar
• Hashtag playbook
• Caption guidelines matching your brand voice
• KPIs and goals to track progress

Phase 3B — Creative Brief

The creative quality engine. Before generating a single image or caption, it develops:

• Campaign concept — One sentence that unifies the entire campaign (tested with the Competitor Swap Test)
• Narrative arc — A 5-act story that builds across 2 weeks: Wake-Up → Deeper Truth → Answer Exists → How It Works → Social Proof
• Visual identity system — Recurring motifs, color rules, typography hierarchy, and visual don'ts
• Concept-to-post mapping — Every post defines its campaign role, emotional beat, visual hook, caption hook, and core moment

Phase 4 — Content Generation

Using AI image generation with a three-layer prompt system (Concept Anchor → Emotional Intent → Visual Execution), it produces:

• Concept-anchored visuals — Every image expresses the campaign idea, not just brand colors
• Cohesive caption-image pairs — Each post starts with a Core Moment that both the image and caption serve
• Creative direction preview — First post generated and presented for approval before the full batch
• Platform-optimized captions with Hook, Value, CTA structure
• Alt text for accessibility
• Organized in a clean directory structure

Phase 5 — Iteration and Optimization

• A/B test variants of high-priority posts
• Repurpose content across platforms
• Multi-language adaptations
• Performance-informed refinements

What It Generates

After running a full campaign, your project gets a social-campaign/ directory:

social-campaign/
├── brand-profile.md              ← Brand DNA + narrative synthesis
├── competitor-analysis.md        ← Deep competitive research
├── content-strategy.md           ← Full marketing strategy
├── creative-brief.md             ← Campaign concept + narrative arc
├── content/
│   ├── week-1/
│   │   ├── mon-product-spotlight/
│   │   │   ├── image.png         ← Concept-anchored visual
│   │   │   ├── caption.md        ← Cohesive caption (paired with image)
│   │   │   └── alt-text.txt      ← Accessibility text
│   │   ├── tue-thought-leadership/
│   │   │   └── ...
│   │   └── .../
│   └── week-2/
│       └── .../
├── assets/
│   ├── color-palette.md
│   ├── hashtag-library.md
│   └── caption-templates.md
└── reports/
    └── campaign-summary.md       ← Executive overview

Compatible Platforms

Social Campaign works with any AI coding assistant that supports skills:

Platform	Status	Notes
Claude Code	Full support	Image generation, web search, file system
Google Antigravity / Kilo	Full support	Image generation, web search, file system
Cursor	Full support	With image gen via plugins
Windsurf	Full support	Native tool access
Cline (VS Code)	Full support	Via MCP tools
Aider	Partial	No image gen — saves prompts instead
GitHub Copilot	Partial	Limited tool access

How It Adapts

The skill detects what tools are available and adjusts:

• Has generate_image? Generates images directly
• Has Stitch MCP? Creates social posts as design screens
• Has search_web? Does real competitor research
• No image gen? Saves detailed prompts for Midjourney/DALL-E/Canva AI
• No web search? Asks you for competitor info, provides analysis framework

Real-World Examples

SaaS Product

"Create a social media campaign for my project management tool"

The skill scans the codebase, discovers it's a React app with a blue/white color scheme, finds the tagline "Ship faster, together", identifies three pricing tiers, and creates a LinkedIn + Twitter strategy focused on productivity tips, feature spotlights, and developer culture content.

E-Commerce Store

"I need Instagram content for my sustainable fashion brand"

It reads the Shopify/Next.js codebase, extracts the earthy green/cream palette, discovers 47 product listings, finds customer testimonials embedded in the site, and generates a carousel-heavy Instagram strategy with lifestyle photography prompts and eco-conscious messaging.

Open Source Project

"Help me promote my open source CLI tool on Twitter"

It reads the README, extracts feature highlights and usage examples, analyzes similar open-source tools' social presence, and creates a developer-focused Twitter strategy using code snippets, demo GIFs, and "how I built this" storytelling.

Product Launch

"I'm launching v2.0 next week — create a launch campaign"

It scans the changelog for v2.0 features, understands the existing brand from v1, and generates a complete 14-day launch sequence: mystery teasers, sneak peeks, countdown, launch day blitz, feature deep-dives, early results celebration.

Built-in Reference Library

The skill comes with a reference library that the AI uses during content generation:

Reference File	What It Contains
references/platform-specs.md	Image dimensions, character limits, and best practices for Instagram, LinkedIn, Twitter/X, Facebook, TikTok, and Pinterest
references/prompt-templates.md	Three-layer prompt system (Concept Anchor → Emotional Intent → Visual Execution) with 8+ templates, good/bad examples, and quality checklist
references/content-pillars.md	Industry-specific content pillar templates for e-commerce, SaaS, agencies, personal brands, and local businesses
references/campaign-types.md	Step-by-step playbooks for product launches, always-on campaigns, seasonal events, engagement growth, and crisis response
references/caption-frameworks.md	Caption-Image Cohesion System, 6 cohesion patterns, 8 caption frameworks, 10+ hook templates, and anti-pattern documentation
references/creative-brief-guide.md	3 complete example creative briefs (SaaS, E-Commerce, Personal Brand), concept development methodology, validation checklist

Want to go deeper? Check out the docs/ folder for advanced usage, supported frameworks, and FAQ.

Contributing

I'd love your help making this better. Whether it's:

• Reporting a bug or suggesting a feature
• Adding new prompt templates or caption frameworks
• Adding support for more platforms (Threads, Bluesky, Mastodon)
• Translating the skill to other languages
• Sharing real-world results to help others

Check out CONTRIBUTING.md for guidelines.

Community

• Found a bug or have a feature request? Open an issue
• Want to share results or ask questions? Start a discussion
• Share your campaigns with #SocialCampaignAI on Twitter/X

License

MIT License — Copyright (c) 2026 Sahil Beniwal

Free to use, modify, and distribute. Attribution appreciated but not required.

---

Built by Sahil Beniwal