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
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.
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
| 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 |
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 | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/mrsahilbeniwal/social-campaigns/main/install.ps1 | iexOr 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 onlyThe installer supports --claude, --global, and --local flags. Run with --help for all options.
After installing, use these in your AI coding assistant. 12 commands total, works across all supported platforms.
| 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 |
| 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 |
| Command | What You Say | Output |
|---|---|---|
campaign status |
"What's been generated so far?" | Lists all campaign files and their completion status |
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.
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 │
└─────────────────────────┘
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
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
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
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
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
- A/B test variants of high-priority posts
- Repurpose content across platforms
- Multi-language adaptations
- Performance-informed refinements
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
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 |
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
"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.
"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.
"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.
"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.
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.
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.
- 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
#SocialCampaignAIon Twitter/X
MIT License — Copyright (c) 2026 Sahil Beniwal
Free to use, modify, and distribute. Attribution appreciated but not required.
Built by Sahil Beniwal