cf-social-adapt

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 Reads what it needs from those paths — never inline the full article into the Task prompt. agents/10-social-adapter.md owns the extraction rules, platform formatting, hashtag tiers and the post-quality gate; this skill owns argument parsing, the quality-score precondition, and presenting the result.

The Social Adapter Agent identifies 10-15 moments from the article that will resonate on social media.

Extraction criteria:

• Statistics and data points (numbers grab attention)
• Counterintuitive insights (challenge assumptions)
• Actionable tips (practical value)
• Quotable statements (from sources or the article itself)
• Provocative questions (drive engagement)
• Before/after comparisons (transformation stories)
• Lists and frameworks (easy to visualize)

SYNTHETIC EXAMPLE — fabricated for illustration. All statistics and organizations below are invented; never reuse them in real output:

Shareworthy Moments Extracted: 12

1. STATISTIC: "73% of healthcare organizations now use AI-powered diagnostics, up from 12% in 2024"
2. INSIGHT: "AI diagnostic accuracy now exceeds human radiologists by 14% for early-stage cancers"
3. TIP: "Three steps to evaluate AI diagnostic tools: accuracy benchmarks, integration requirements, compliance checklist"
4. QUOTE: "The question is no longer whether to adopt AI in healthcare, but how fast you can implement it"
5. DATA: "$4.2 billion saved annually by hospitals using AI triage systems"
6. PROVOCATIVE: "Manual diagnostic processes will be considered malpractice liability by 2030"
7. COMPARISON: "AI-assisted diagnosis: 4 minutes avg vs. traditional: 45 minutes"
8. FRAMEWORK: "The 3-layer AI healthcare stack: data ingestion, model inference, clinical integration"
9. TREND: "Precision medicine powered by AI will reduce misdiagnosis rates by 60% by 2028"
10. CASE STUDY: "Northlake Clinic (a fictional example hospital) reduced diagnostic wait times by 78% after implementing AI triage"
11. LIST: "Top 5 AI healthcare applications: diagnostics, drug discovery, patient monitoring, administrative automation, clinical trials"
12. ACTIONABLE: "Start with radiology -- it has the highest AI ROI and lowest integration complexity"

Step 3: Generate Platform-Specific Posts (1-2 minutes)

For each platform, generate the requested number of posts using platform specs from config/social-platform-specs.json.

Each post includes:

• Platform-optimized hook (first line grabs attention)
• Body content adapted to platform voice and length
• Hashtags (platform-appropriate count and style)
• Call-to-action or engagement hook
• Character count
• Recommended image spec
• Suggested posting time

Step 4: Quality Check

Every post is validated against:

• Character limit for the platform
• Self-contained meaning (reader does not need to click a link to understand the value)
• Contains a CTA or engagement hook (question, poll prompt, or link)
• Hashtags within platform norms
• No broken or placeholder content
• Brand voice alignment

Output Format

Per-Platform Post Set

The output is organized by platform with all metadata included.

Before generating output, read references/output-format-example.md (in this skill's directory) for a full synthetic worked example covering all 5 illustrative platforms (LinkedIn, Twitter/X, Instagram, Facebook, Threads) plus the summary block — reproduce this shape and level of per-post detail (hook, body, hashtags, character count, image spec, recommended time) for every requested platform, and follow with a SUMMARY block (total posts, character-limit compliance, self-contained rate, CTA rate, publishing schedule, estimated reach).

Error Handling

Content Not Found

Error: REQ-001 not found in Google Drive or local output
Action: Verify requirement ID or provide direct file path

Content Not Approved

Error: Content quality score 4.8/10 (below 7.0 threshold)
Action: Content must pass quality review before social adaptation.
  Run /contentforge to complete the pipeline first.

Platform Not Recognized

Error: Platform "<name>" is not in config/social-platform-specs.json
Supported: <list the platform keys actually present in the config>
Action: Use a supported platform, or add a spec block for the new
  platform to config/social-platform-specs.json

Missing Published URL

Warning: No published URL provided for link-sharing posts.
Action: Posts generated without link. Add --url parameter to include article link.
  Some post types (link share, CTA) will use "[link in bio]" placeholder.

AI-Content Labels (platform disclosure)

Major platforms provide AI-content labeling options, and EU AI Act Article 50 (applicable from 2 Aug 2026) requires disclosure of AI-generated content shown to EU audiences:

• LinkedIn / Meta (Facebook, Instagram) / TikTok / YouTube — each offers an "AI-generated or AI-assisted" label or disclosure toggle at posting time. If the brand targets EU audiences or the brand profile's guardrails require disclosure, remind the user to enable the platform label when scheduling these posts, and note it in the handoff summary.
• When disclosure applies, include a per-post metadata note in the output: AI-label: recommended (EU targeting).

Agent Used

• Social Adapter Agent (post-pipeline) -- see agents/10-social-adapter.md

Configuration

• Platform specs: config/social-platform-specs.json
• Post templates: templates/social-post-templates.md

Integration with Other Skills

Before Social Adaptation:

• /contentforge:create-content -- Produce the source article
• /contentforge:cf-publish -- Publish the article to your CMS (get the URL for social posts)

After Social Adaptation:

• Copy posts to your social scheduling tool (Buffer, Hootsuite, Sprout Social)
• Track engagement metrics per post to refine future adaptations

Related Skills

• /contentforge:create-content -- Full content production pipeline
• /contentforge:cf-publish -- Publish to Webflow/WordPress
• /contentforge:content-refresh -- Update existing content
• /contentforge:batch-process -- Sequential, checkpointed batch production

Agent: Social Adapter (10-social-adapter) Config: config/social-platform-specs.json (single source of truth for platform rules) Templates: templates/social-post-templates.md Default: 3 posts per platform