$npx -y skills add indranilbanerjee/socialforge --skill full-pipelineRun the complete end-to-end production pipeline — parse, match, compose, copy, preview, review, finalize.
| 1 | # /socialforge:full-pipeline — Complete Production Pipeline |
| 2 | |
| 3 | Run all phases sequentially with quality gates between each. |
| 4 | |
| 5 | ## Context efficiency |
| 6 | |
| 7 | Asset-heavy skill. **Grep before Read** the asset catalog (`${CLAUDE_PLUGIN_DATA}/<brand>/assets/index.json`) — never list the asset directory. Reference generated images / videos by path, not by loading metadata. Brand profile loads once per session. |
| 8 | |
| 9 | ## Pipeline Phases |
| 10 | |
| 11 | | Phase | Skill | Gate | |
| 12 | |-------|-------|------| |
| 13 | | -1 | credential-check | API credentials configured (Vertex AI and/or WaveSpeed) | |
| 14 | | 0 | parse-calendar | Calendar parsed, all required fields present | |
| 15 | | 1 | match-assets | Asset matches confirmed by user | |
| 16 | | 2 | compose-creative | All images/videos generated, quality scores ≥7.0 | |
| 17 | | 3 | adapt-copy | Copy adapted, compliance passed | |
| 18 | | 4 | create-previews | Previews rendered for all posts | |
| 19 | | 5 | build-review-gallery | Gallery built and accessible (images + video) | |
| 20 | | 6 | manage-reviews | All posts reviewed (async — pipeline pauses here) | |
| 21 | | 7 | finalize-month | All approved posts packaged for delivery | |
| 22 | |
| 23 | ## Phase -1: Credential Check |
| 24 | |
| 25 | Before any production work begins, verify that the required API credentials are configured via `credential_manager.py`. |
| 26 | |
| 27 | 1. Run `credential_manager.py status` to check Vertex AI and WaveSpeed configuration |
| 28 | 2. **Image generation** requires Vertex AI credentials configured via `/socialforge:setup` |
| 29 | 3. **Video generation** requires WaveSpeed API key (only checked if calendar contains video posts) |
| 30 | 4. If any required credential is missing, stop the pipeline and prompt the user: |
| 31 | "Required credentials not configured. Run `/socialforge:setup` to configure API keys before starting production." |
| 32 | 5. If all credentials are valid, proceed to Phase 0 |
| 33 | |
| 34 | ## Phase 2: Compose Creative |
| 35 | |
| 36 | Phase 2 operates in two distinct modes depending on how it is invoked. |
| 37 | |
| 38 | ### Interactive mode (`/socialforge:generate-post`) |
| 39 | |
| 40 | Produces creative for a single post with full user control at each stage. |
| 41 | |
| 42 | **Image posts — 4-stage approval:** |
| 43 | 1. **Direction** — Review creative direction and prompt before generation |
| 44 | 2. **Generate** — AI generates 2-3 variants; user picks the best or requests regeneration |
| 45 | 3. **Composite** — Selected variant composited with brand asset, overlay, and logo; user approves |
| 46 | 4. **Resize** — Platform-specific resizes produced; user confirms final set |
| 47 | |
| 48 | **Video posts — 5-stage approval:** |
| 49 | 1. **Direction** — Review video concept, storyboard outline, and scene descriptions |
| 50 | 2. **Script** — Approve shot-by-shot script with timing and transitions |
| 51 | 3. **Generate** — AI generates video clip; user reviews motion and pacing |
| 52 | 4. **Composite** — Overlay, logo, and captions applied; user approves |
| 53 | 5. **Resize** — Platform-specific aspect ratios produced; user confirms final set |
| 54 | |
| 55 | ### Batch mode (`/socialforge:generate-all`) |
| 56 | |
| 57 | Produces creative for all posts in the calendar with minimal interruption. |
| 58 | |
| 59 | 1. **Group-based direction** — Posts are grouped by creative mode (ANCHOR, ENHANCE, STYLE_REF, PURE). User approves creative direction per group rather than per post. |
| 60 | 2. **Auto-generate** — All posts generate in sequence using the approved group directions. Progress is displayed per post with quality scores. |
| 61 | 3. **Gallery review** — Once all posts are generated, a review gallery is built automatically so the user can review everything at once. |
| 62 | 4. **Flagged regeneration** — User flags any posts that need rework. Flagged posts regenerate with adjusted prompts. Unflagged posts proceed as approved. |
| 63 | |
| 64 | ## Phase 5: Review Gallery |
| 65 | |
| 66 | The review gallery (`/socialforge:review`) now supports both image and video content: |
| 67 | - **Image posts** display as before — preview thumbnail, quality score, copy, and compliance status |
| 68 | - **Video posts** display with side-by-side `<video>` tags showing the raw generated clip alongside the composited version with overlays, enabling direct comparison of motion, pacing, and brand overlay placement |
| 69 | |
| 70 | ## Progress |
| 71 | |
| 72 | ``` |
| 73 | SocialForge Full Pipeline — AcmeCorp / April 2026 |
| 74 | |
| 75 | [pre] Credential Check ✓ — Vertex AI ready, WaveSpeed ready |
| 76 | [1/7] Parse Calendar ✓ — 28 posts extracted (24 image, 4 video) |
| 77 | [2/7] Match Assets ✓ — 8 ANCHOR, 5 ENHANCE, 9 STYLE_REF, 4 PURE, 2 CAROUSEL |
| 78 | [3/7] Compose Creative → IN PROGRESS |
| 79 | Mode: batch (group-based direction) |
| 80 | Groups approved: ANCHOR ✓ ENHANCE ✓ STYLE_REF ✓ PURE → awaiting direction |
| 81 | Generated: 18/28 posts (~10 min remaining) |
| 82 | Latest: P18 — STYLE_REFERENCED — Score: 8.4/10 ✓ |
| 83 | Videos: 2/4 generated — P07 Score: 7.8/10 ✓ |
| 84 | [4/7] Adapt Copy — waiting |
| 85 | [5/7] Create Previews — waiting |
| 86 | [6/7] Review Gallery — waiting |
| 87 | [7/7] Finalize — waiting |
| 88 | ``` |
| 89 | |
| 90 | ## Rules |
| 91 | - Each phase must pass its gate before the next starts |
| 92 | - Phase -1 (Credential Check) is the first gate — no production without valid creden |