social-stack - SKILL.md Agent Skill

name: social-stack version: 1.2.1 repo: https://github.com/yourhandle/skynet-social-stack description: | Build, render, and schedule social-media post packs end-to-end across LinkedIn, Instagram, Facebook, X/Twitter, Pinterest, YouTube. Picks the right template (carousel / single card / news mix / X pack / Pin / video drip), generates HTML w/ html2canvas PNG download, builds GHL CSV in canonical 6-col format, applies image rotation + no-fake-claims + humanizer rules, schedules cross-platform drips, wires ManyChat keyword funnels.

Distilled from shipped patterns: - LinkedIn editorial dark+gold cards (Fraunces, 1080x1350) — 30+ batches - Tenfoldmarc-style cream+rust carousels (Archivo Black + circuit + robot mascot) - FB personal-news 9-card mix (4 info + 2 motiv + 3 sell + locked closer) - X 12-pack drip (MWF 3wk) - Pinterest 1000x1500 batch - GHL CSV format (canonical 6-col) - ManyChat keyword → WA template flow

Trigger when user says: "build a carousel", "social pack", "LI cards batch", "FB news drip", "X pack", "Pinterest batch", "GHL CSV", "schedule drip", "post pack for [topic]", "/social-stack", or pastes a topic + asks for cross-platform content. license: MIT compatibility: claude-code allowed-tools: - Read - Write - Edit - Glob - Grep - Bash - Agent - AskUserQuestion

Social Stack — Master Social-Media Post Engine

Ship a complete platform-ready post pack in one session: HTML → PNGs → GHL CSV → drip → ManyChat funnel.

Not generic. Niche-tuned, brand-locked, claim-safe, rotation-respecting.

INPUTS — ask if missing

Topic (e.g. "Claude Code limits", "AEO pivot", "n8n SaaS killer")
Format — carousel (6-slide multi) / LI single card / FB news mix / X pack / Pin batch / video drip
Volume — how many posts (default per format below)
Platforms — LI / IG / FB / X / Pin / YT (multi OK)
Drip start date + cadence (default: tomorrow, MWF or daily)
Brand variant — agency (@your-agency) or personal (@yourhandle)
CTA — DM keyword? link? save?

If 1 or 2 missing → use AskUserQuestion. Don't proceed.

DECISION TREE — pick the template

User signal	Template	Default volume
"carousel", "swipe", multi-slide tip pack	`templates/carousel-cream-rust/`	5–6 slides × N carousels
"LI card", "image card", quote/value post, dark editorial	`templates/li-card-editorial-dark/`	15–30 cards
"personal FB news", news commentary mix	`templates/fb-news-9card/`	9 cards × 3 days
"X pack", "tweet drip", short text	`templates/x-pack/`	12–20 tweets
"Pinterest", "Pin", vertical 1000×1500	`templates/pin-card/`	30 pins
"feature card", "announcement", "launch post", model/product drop w/ photo + why-it-matters	`templates/cream-feature/`	1 hero card
"video drip", existing MP4s	no template — go to `recipes/video-drip.md`	—

Full tree: references/post-type-decision-tree.md.

EXECUTION FLOW

PHASE 1 — Plan (3 min)

Confirm inputs.
Pick template (decision tree).
Draft outline: hook → tricks → CTA. Apply references/no-fake-claims.md — only real builds, real metrics, real case studies.
If using your photos → python <your-images>/_pick-next.py --count N (rule: references/image-rotation-rule.md).

PHASE 2 — Build HTML (10–20 min)

Fork the chosen template into outputs/<slug>-<YYYY-MM-DD>/index.html.
Render parameterized data (carousels array / cards array / etc).
Embed html2canvas for per-card PNG download + "Download all" button.
1080×1350 (LI/IG carousel), 1080×1080 (IG single), 1080×1920 (Story/Reel), 1000×1500 (Pin).
Avatars: copy picked photos to outputs/.../<slug>/_avatars/ for same-origin html2canvas.

PHASE 3 — Captions + humanize (10 min)

Write platform-tuned captions: LI long-form / IG hook+CTA / FB conversational / X tight.
Run through references/humanizer-checklist.md — strip em-dashes, AI tells, "delve", "moreover", inflated symbolism.
Apply references/no-fake-claims.md — flag any unverifiable metric.

PHASE 4 — GHL CSV (5 min)

Use scripts/build_ghl_csv.py — outputs canonical 6-col headers (see references/ghl-csv-format.md).
One CSV per platform (LI / FB / IG / Pin / X). X does NOT use GHL — separate text file.
Date-shift to drip window: scripts/shift_dates.py --start YYYY-MM-DD --cadence mwf|daily|weekday.

PHASE 5 — ManyChat + funnel (if CTA = DM keyword)

Wire keyword across IG/FB/WA per references/manychat-keyword-flow.md.
WA template needs 24–72h Meta soak — submit BEFORE drip Day 1 or dead-funnel risk.

PHASE 6 — Mark + ship

Mark each photo used: python _pick-next.py --use FILE.jpg "<post-tag>".
Save deliverable summary to outputs/<slug>/_README.md.
Add memory entry (see references/memory-update-template.md).

OUTPUT CONVENTIONS

outputs/<slug>-<YYYY-MM-DD>/
├── index.html                  # interactive preview + PNG download
├── _avatars/                   # photos used (rotation-tracked)
├── captions/
│   ├── linkedin.md
│   ├── facebook.md
│   ├── instagram.md
│   └── x.md
├── csv/
│   ├── ghl-linkedin.csv
│   ├── ghl-facebook.csv
│   ├── ghl-instagram.csv
│   └── ghl-pinterest.csv
└── _README.md                  # what / where / when / how to ship

RULES — always apply

No fake claims. Real builds only. No invented metrics. → references/no-fake-claims.md
Image rotation. Always pick via _pick-next.py. Never by eye. Mark used after. → references/image-rotation-rule.md
Humanize. No em-dash storms, no "delve/moreover/it's worth noting", no rule-of-three filler. → references/humanizer-checklist.md
Brand split. Personal posts (motivation + casual Q, no hard sell) vs SkynetLabs (sell + proof). → references/brand-split.md (or memory: feedback-personal-social-style)
GHL CSV format = 6-col canonical. Don't invent headers. → references/ghl-csv-format.md
NDA scrub. Strip client names from FB/IG/Pin (LinkedIn = signal but check). E.g. an NDA-bound client's name scrubbed from FB/IG/Pin per prior precedent.
Date-shift safety. Run shifter BEFORE upload or lose 9/30 pins to past dates (Pinterest precedent).
24–72h Meta soak. Submit WA templates BEFORE Day 1 or funnel dies.
Responsive output contract. Every PNG/PDF/MP4 ships fully responsive — fixed-px export node + fluid preview frame, viewport tests 360/480/768/1024/1440, ≥44px touch, role=img + aria-label. → references/responsive-output-contract.md

RECIPES — full playbooks

recipes/carousel-launch.md — 5-carousel × 6-slide drop, LI+IG primary
recipes/li-card-batch.md — 15–30 LI editorial dark+gold cards
recipes/fb-news-3day.md — 9-card personal FB news, 3×3 drip
recipes/x-pack-mwf-drip.md — 12-tweet pack, MWF over 3 weeks
recipes/pin-batch.md — 30 pins, +14d shift
recipes/cross-platform-pack.md — same content × 4 CSVs (LI/FB/IG/Pin)
recipes/post-mortem.md — engagement retro after every batch (top 5 / bottom 5 / pattern extraction)
recipes/repurpose-chain.md — 1 topic → 9 derivatives across LI/IG/FB/X/Pin/Newsletter
recipes/competitor-sweep.md — 15-min Sunday peer sweep, pattern-match weekly

TEMPLATES (6 working, v1.3.0)

templates/carousel-cream-rust/ — Archivo Black + circuit + robot mascot, 1080×1350
templates/li-card-editorial-dark/ — Fraunces serif + dark+gold, 1080×1350 (NEW v1.2)
templates/fb-news-9card/ — 9-card mix (4 info + 2 motiv + 3 sell + locked closer), 1080×1350 (NEW v1.2)
templates/x-pack/ — image-tweet 1200×675, 12-tweet pack w/ thread followups (NEW v1.2)
templates/pin-card/ — vertical 1000×1500, 30-pin batch, 3 palettes, UTM auto-inject (NEW v1.2)
templates/cream-feature/ — cream+emerald hero/announcement card, Fraunces + framed photo + why-it-matters strip, 1080×1350, render.js headless export (NEW v1.3)

Every template ships with: index.html (responsive preview + html2canvas export), data.json (sample data), README.md (responsive contract + usage), _avatars/ (rotation-log photo dest).

All templates inherit references/responsive-output-contract.md.

SCRIPTS

scripts/build_ghl_csv.py — canonical 6-col CSV builder (postAtSpecificTime, content, link, imageUrls, gifUrl, videoUrls). QUOTE_ALL. Validates input.
scripts/shift_dates.py — date-shift canonical CSV by N days, MWF/daily/weekday cadence. Try/except on malformed dates.
scripts/pick_avatar.py — wraps _pick-next.py w/ rotation-log validation + forced --mark or --no-mark (no silent skip)
scripts/utm_inject.py — adds utm params per row to GHL CSV
scripts/seed_replies.py — first-30-min engagement seed comments
scripts/caption_variants.py — A/B hook variants from hook-bank

ANTI-PATTERNS — don't do

Don't render HTML with random Picsum / Unsplash hot-link images — html2canvas can taint.
Don't ship without humanizer pass — AI-tell em-dashes kill reach on LI.
Don't claim case-study metrics you haven't verified — no-fake-claims rule.
Don't reuse a photo without checking rotation log.
Don't paste GHL CSVs without date-shift if window has shifted.
Don't skip Meta WA template soak — DM keyword posts will dead-funnel.

Last updated: 2026-04-30 (v1.2.0 — responsive contract + 4 templates shipped)