/cf-social-adapt

name: cf-social-adapt
description: "Repurpose a finished article into ready-to-publish, platform-native social posts for LinkedIn, Twitter/X, Instagram, Facebook, Threads, TikTok, Bluesky, and YouTube Shorts — each with hook, hashtags, CTA, character count, image spec, and posting time, typically 24-40 posts per article. Triggers on \"/contentforge:cf-social-adapt\", \"turn this article into LinkedIn posts\", \"make social posts from this blog\", \"repurpose this for social media\", \"promote the published article\". Dispatches the contentforge:social-adapter agent, takes all platform limits from config/social-platform-specs.json, reads the brand profile for voice, and requires pipeline-approved content (score >=7.0). Pairs with /contentforge:cf-publish for the live article URL."
disable-model-invocation: true
argument-hint: "[article-path]"
effort: medium

Social Content Adaptation — ContentForge Post-Pipeline

Repurpose any ContentForge article into ready-to-publish social media posts for LinkedIn, Twitter/X, Instagram, Facebook, Threads, TikTok, Bluesky, and YouTube Shorts. Each post is tailored to platform character limits, audience expectations, hashtag conventions, and optimal posting times.

Platform rules — single source of truth

**All character limits, hashtag counts, ideal lengths, and format rules come from `config/social-platform-specs.json`. Read that file at run time and use its values. Never use remembered limits, and never trust any limit that appears in an example in this file.** The supported platform list is exactly the set of top-level keys in that config whose value contains a `character_limit` field (or, for video platforms, a `title_max_chars` field). Top-level keys without one of those fields are not platforms — `_description`, `_posting_times_note`, `hashtag_tiers`, and `post_frameworks` must be skipped. As shipped this resolves to 8 platforms: `linkedin`, `twitter`, `instagram`, `facebook`, `threads`, `tiktok`, `bluesky`, `youtube_shorts`.

When to Use

Use `/contentforge:cf-social-adapt` when:

• You have a **published or approved article** and want to promote it on social media
• You need **platform-native posts** (not the same text copy-pasted everywhere)
• You want **multiple posts per platform** to sustain engagement over days/weeks
• You need **hashtag strategies**, **image specifications**, and **posting schedules**
• You want to **repurpose one article into 24-40 social posts** across 8 platforms

**Do NOT use for:**

• Content still in pipeline (must be Phase 7+ approved or Phase 8 complete)
• Creating original social content from scratch (this repurposes existing articles)
• Paid ad copy (different skill set and compliance requirements)

What This Command Does

1. **Load Source Content** -- Pull the finished article from Google Drive, local output, or by requirement ID 2. **Extract Shareworthy Moments** -- Identify 10-15 key points (statistics, insights, quotes, tips) 3. **Apply Platform Specs** -- Load character limits, hashtag rules, and format guidelines from `config/social-platform-specs.json` 4. **Generate Posts** -- Create platform-specific posts with hooks, CTAs, and engagement elements 5. **Add Metadata** -- Character counts, hashtags, image specs, recommended posting times 6. **Quality Check** -- Ensure each post is self-contained, under character limit, and has a CTA

Required Inputs

**Minimum Required:**

• **Source Content** -- Google Drive URL, local file path, or requirement ID (e.g., `REQ-001`)
• **Platforms** -- `all`, or a comma-separated subset of the platform keys defined in `config/social-platform-specs.json`

**Optional:**

• **Posts Per Platform** -- Number of posts per platform (default: 3, max: 10)
• **Brand** -- Brand profile for voice/tone alignment (auto-detected from content metadata if not specified)
• **Campaign Hashtag** -- Branded hashtag to include in all posts (e.g., `#AcmeMedInsights`)
• **Published URL** -- URL of the live article (for link-sharing posts)
• **Image Assets** -- URLs or paths to images/graphics available for social use
• **Tone Override** -- Override brand default (e.g., `casual`, `professional`, `provocative`)

How to Use

Interactive Mode

/contentforge:cf-social-adapt

**Prompts you for:** 1. Content source (Drive URL, file path, or requirement ID) 2. Platforms (select from list or type `all`) 3. Posts per platform (default: 3) 4. Published article URL (if available)

Quick Mode (All Parameters)

/contentforge:cf-social-adapt REQ-001 --platforms=linkedin,twitter,instagram --count=5 --url=https://acme-corp.com/blog/ai-healthcare-2026

All Platforms, Default Count

/contentforge:cf-social-adapt REQ-001 --platforms=all

With Campaign Hashtag

/contentforge:cf-social-adapt REQ-001 --platforms=all --hashtag=#AcmeMedInsights --count=4

What Happens

Step 1: Load and Analyze Source Content (15-30 seconds)

**Load the finished article and extract key metadata:**

Source Content Loaded
---------------------------------------------------
Title: "AI in Healthcare: 2026 Trends"
Brand: AcmeMed
Word Count: 1,947
Quality Score: 9.2/10
Key Topics: AI diagnostics, precision medicine, patient care, cost reduction
Primary Keyword: "AI in healthcare"
---------------------------------------------------

Step 2: Extract Shareworthy Moments (30-60 seconds)

**Dispatch the agent — do not do this inline.** Call `Task` with `subagent_type: contentforge:social-adapter`, exactly as the main orchestrator dispatches its pipeline phases. The Task prompt carries only:

• the source-content path (`phase-6.5-humanized.md` in pipeline mode, or the user-supplied file/URL in standalone mode),
• `phase-7-review.json` and `phase-6-seo.md` paths when running after a pipeline run,
• the brand-profile path, target platforms, posts-per-platform, published URL and campaign hashtag.

The agent `Read`s what it needs from those paths — never inline the full articl