indranilbanerjee
socialforge
Open-source agency-grade social media production engine with AI image/video, C2PA signing, and asset-first compositing.
Repository last updated Jun 28, 2026
Overview
SocialForge is an open-source social media production engine designed for monthly content calendar automation. It uses asset-first compositing to generate AI-composed creative and video while maintaining the integrity of original brand assets. The tool includes C2PA content provenance signing for AI-generated media, ensuring compliance with regulations like the EU AI Act Article 50.
With 16 skills, 25 commands, and 5 agents, SocialForge handles everything from calendar parsing and asset indexing to creative composition, copy adaptation, and review management. It supports per-platform copy adaptation for Instagram, TikTok, LinkedIn, Threads, X, Facebook, and YouTube Shorts in a single pass. AI image generation uses Vertex AI Nano Banana Pro, and AI video generation uses WaveSpeed Kling v3.0 Pro.
SocialForge is built for agencies and in-house teams running monthly content calendars. It installs on Claude Code, Anthropic Cowork, OpenAI Codex, Cursor 2.5+, GitHub Copilot CLI, Google Antigravity 2.0, Hermes Agent, OpenClaw, and 35+ additional Agent Skills platforms.
Highlights
- 16 skills, 25 commands, 5 agents, 22 scripts, 10 HTTP MCP connectors
- Asset-first compositing keeps brand photos pixel-faithful
- Per-platform copy adaptation for 7 social platforms
- C2PA content provenance signing for EU AI Act compliance
- Compatible with 8 native and 35+ Agent Skills platforms
Features
Asset-First Compositing
Brand assets remain pixel-faithful while AI generates backgrounds, mood, and context around them.
AI Image & Video Generation
Uses Vertex AI Nano Banana Pro for images and WaveSpeed Kling v3.0 Pro for videos.
C2PA Signing
Every AI-generated image and video is signed with C2PA content provenance before delivery.
Multi-Platform Copy Adaptation
Automatically adapts copy for Instagram, TikTok, LinkedIn, Threads, X, Facebook, and YouTube Shorts.
Monthly Calendar Automation
Commands like /socialforge:new-month, /socialforge:generate-all, and /socialforge:review streamline production.
Human-in-the-Loop Review
Review galleries and approval workflows ensure quality before finalization.
Installation
Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.
> If SocialForge saves your team time, [give it a star ⭐](https://github.com/indranilbanerjee/socialforge/stargazers) — it's the single thing that helps other agencies find it.
**Status:** Production Ready · 16 skills · 25 commands · 5 agents · 22 scripts · 10 HTTP MCP connectors · 0 global hooks
Agency-grade social media calendar automation with asset-first compositing and AI video generation. Takes monthly content calendars, matches brand assets, generates AI-composed creative, renders carousels, produces AI-generated video clips, adapts copy per platform, produces review galleries and delivery documents — with C2PA content provenance signed into every AI-generated image/video before delivery.
## Core Principle
**Brand assets are sacred. AI is the creative layer around them.**
Product photos, headshots, screenshots — these are the brand’s real visual identity. AI generates backgrounds, mood, and context around them. The brand asset stays pixel-faithful in every composition.
## The Four Creative Modes
| Mode | When | What Happens |
|------|------|-------------|
| ANCHOR_COMPOSE | Brand photo is the centerpiece | AI generates scene around the untouched asset |
| ENHANCE_EXTEND | Brand photo is the base | AI extends/enhances periphery, core stays faithful |
| STYLE_REFERENCED | No specific asset needed | AI generates using brand’s style reference photos as visual DNA |
| PURE_CREATIVE | Generic/abstract content | AI generates from text prompt + brand colors/mood |
## Quick Start## Supported surfaces (v1.13.1)
| Platform | Install command | Manifest path | Status |
|---|---|---|---|
| **Claude Code** CLI + IDE extensions | `/plugin install socialforge@neels-plugins` | `.claude-plugin/plugin.json` | Full support (canonical) |
| **Anthropic Cowork** | Plugins UI → Add marketplace → `indranilbanerjee/neels-plugins` → Install SocialForge | same `.claude-plugin/` files | Full support — no `/plugin` slash commands in Cowork (UI-only) |
| **OpenAI Codex** CLI + IDE + App | `codex plugin marketplace add indranilbanerjee/neels-plugins` then `codex plugin install socialforge@neels-plugins` | `.codex-plugin/plugin.json` (published OpenAI schema) | Full skills + MCP support |
| **Cursor 2.5+** | In any Cursor Agent chat: `/add-plugin socialforge@https://github.com/indranilbanerjee/socialforge` | `.cursor-plugin/plugin.json` (verified Cursor 2.5+ JSON Schema) | Full skills + agents + commands support |
| **GitHub Copilot CLI** | `copilot plugin marketplace add indranilbanerjee/neels-plugins` then `copilot plugin install socialforge@neels-plugins` | `.github/plugin/plugin.json` (Copilot also recognizes `.claude-plugin/plugin.json` as fallback) | Full skills + MCP support |
| **Google Antigravity 2.0** CLI + IDE | `agy plugin install https://github.com/indranilbanerjee/socialforge` | `gemini-extension.json` (at repo root, per Google's reference pattern) | Full skills + hooks support |
| **Hermes Agent** (Nous Research) — Desktop + CLI on macOS / Windows / Linux | `hermes plugins install indranilbanerjee/socialforge` | `plugin.yaml` + `__init__.py` at repo root (Hermes native spec) | Native plugin — adapter walks `skills/` at register time and exposes all 16 skills via `ctx.register_skill()`. Targets Hermes Desktop v0.15.2+ (public preview June 2 2026). |
| **OpenClaw** (formerly Clawdbot / Moltbot) | `openclaw plugins install git:github.com/indranilbanerjee/socialforge` | `openclaw.plugin.json` at repo root (also auto-detects `.claude-plugin/plugin.json` as Claude-compatible bundle) | Native plugin via `openclaw.plugin.json`; `skills` field points at `./skills`. |
**Why this works:** Agent Skills became an open standard in December 2025 (41+ agent products by June 2026). All 16 SKILL.md files in SocialForge are platform-portable as written.
**Works on 35+ additional Agent Skills platforms** without per-platform manifests — Goose (Block), OpenHands, OpenCode (sst), Junie (JetBrains), Gemini CLI, Roo Code, Cline/Windsurf, Kiro, Amp, Letta, Mux, Factory, Workshop, Tabnine, Mistral Vibe, and more. Point any Agent-Skills-compatible client at `https://github.com/indranilbanerjee/socialforge/tree/main/skills` and all 16 SocialForge skills are immediately discoverable.
## Architecture
- **16 skills** — Calendar parsing, asset indexing, creative composition, copy adaptation, review management, C2PA signing
- **25 commands** — Monthly production, post generation, editing, review, approval, finalization
- **5 agents** — Image compositor, carousel builder, copy adapter, quality reviewer, compliance checker
- **22 scripts** — Deterministic execution (compositing, rendering, resizing, video post-processing, compliance checking, C2PA signing)
- **10 HTTP connectors** — Notion, Canva, Slack, Gmail, Google Calendar, Figma, fal.ai, Replicate, Asana, Cloudinary (all Cowork-compatible)
- **0 global hooks** — As of v1.5.0. Prior hook config preserved at `hooks/hooks-reference.example.json`. Credential status now via `/socialforge:status` on demand. See the [release notes](#current-release-v1131) for the rationale.
- **Model curator (v1.8.2+)** — `scripts/model_registry.json` + `resolve_model.py` + `refresh_models.py`. Single source of truth for image / vision / video model ids; deprecated ids passed via `--model` / `--video-model` auto-fall-forward to their replacement; `refresh_models.py` polls live provider catalogs and reports drift. See [`docs/MODEL-CURATOR.md`](docs/MODEL-CURATOR.md).
## Installation
### Option A: From Marketplace (recommended)### Option B: Direct from GitHub### Option C: From Local DirectoryRequirements
- Google Cloud service account JSON key file (for Vertex AI image generation)
- WaveSpeed API key (for video generation)
- Python 3.x
- Claude Code, Cowork, Codex, Cursor 2.5+, Copilot CLI, Antigravity 2.0, Hermes Agent, or OpenClaw
How it's built
SocialForge is written in Python and organized as a plugin with manifests for multiple agent platforms. The repository includes .claude-plugin/plugin.json, .codex-plugin/plugin.json, .cursor-plugin/plugin.json, .github/plugin/plugin.json, and openclaw.plugin.json. The Hermes Agent integration uses a plugin.yaml and __init__.py at the root, with an adapter that walks the skills/ directory and registers all 16 skills via ctx.register_skill().
The architecture includes 16 skills, 25 commands, 5 agents, 22 scripts, and 10 HTTP MCP connectors. The model curator (scripts/model_registry.json + resolve_model.py + refresh_models.py) provides a single source of truth for model IDs, with auto-fall-forward for deprecated models. Image generation requires Google Cloud Vertex AI, and video generation requires a WaveSpeed API key, configured via the /socialforge:setup command.
Source
This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The indranilbanerjee/socialforge repository is the authoritative source and the place to file issues or contribute.
Category: Content Creation · Licensed under MIT