$npx -y skills add indranilbanerjee/contentforge --skill cf-social-adaptRepurpose finished articles into platform-specific social media posts for LinkedIn, Twitter/X, Instagram, Facebook, and Threads
| 1 | # Social Content Adaptation — ContentForge Post-Pipeline |
| 2 | |
| 3 | Repurpose any ContentForge article into ready-to-publish social media posts for LinkedIn, Twitter/X, Instagram, Facebook, and Threads. Each post is tailored to platform character limits, audience expectations, hashtag conventions, and optimal posting times. |
| 4 | |
| 5 | ## Platform rules — single source of truth |
| 6 | |
| 7 | **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 platform keys in that config (e.g., linkedin, twitter, instagram, facebook, threads — plus any additions such as tiktok, bluesky, youtube-shorts). |
| 8 | |
| 9 | ## When to Use |
| 10 | |
| 11 | Use `/contentforge:cf-social-adapt` when: |
| 12 | - You have a **published or approved article** and want to promote it on social media |
| 13 | - You need **platform-native posts** (not the same text copy-pasted everywhere) |
| 14 | - You want **multiple posts per platform** to sustain engagement over days/weeks |
| 15 | - You need **hashtag strategies**, **image specifications**, and **posting schedules** |
| 16 | - You want to **repurpose one article into 15-25 social posts** across 5 platforms |
| 17 | |
| 18 | **Do NOT use for:** |
| 19 | - Content still in pipeline (must be Phase 7+ approved or Phase 8 complete) |
| 20 | - Creating original social content from scratch (this repurposes existing articles) |
| 21 | - Paid ad copy (different skill set and compliance requirements) |
| 22 | |
| 23 | ## What This Command Does |
| 24 | |
| 25 | 1. **Load Source Content** -- Pull the finished article from Google Drive, local output, or by requirement ID |
| 26 | 2. **Extract Shareworthy Moments** -- Identify 10-15 key points (statistics, insights, quotes, tips) |
| 27 | 3. **Apply Platform Specs** -- Load character limits, hashtag rules, and format guidelines from `config/social-platform-specs.json` |
| 28 | 4. **Generate Posts** -- Create platform-specific posts with hooks, CTAs, and engagement elements |
| 29 | 5. **Add Metadata** -- Character counts, hashtags, image specs, recommended posting times |
| 30 | 6. **Quality Check** -- Ensure each post is self-contained, under character limit, and has a CTA |
| 31 | |
| 32 | ## Required Inputs |
| 33 | |
| 34 | **Minimum Required:** |
| 35 | - **Source Content** -- Google Drive URL, local file path, or requirement ID (e.g., `REQ-001`) |
| 36 | - **Platforms** -- `all`, or a comma-separated subset of the platform keys defined in `config/social-platform-specs.json` |
| 37 | |
| 38 | **Optional:** |
| 39 | - **Posts Per Platform** -- Number of posts per platform (default: 3, max: 10) |
| 40 | - **Brand** -- Brand profile for voice/tone alignment (auto-detected from content metadata if not specified) |
| 41 | - **Campaign Hashtag** -- Branded hashtag to include in all posts (e.g., `#AcmeMedInsights`) |
| 42 | - **Published URL** -- URL of the live article (for link-sharing posts) |
| 43 | - **Image Assets** -- URLs or paths to images/graphics available for social use |
| 44 | - **Tone Override** -- Override brand default (e.g., `casual`, `professional`, `provocative`) |
| 45 | |
| 46 | ## How to Use |
| 47 | |
| 48 | ### Interactive Mode |
| 49 | ``` |
| 50 | /contentforge:cf-social-adapt |
| 51 | ``` |
| 52 | **Prompts you for:** |
| 53 | 1. Content source (Drive URL, file path, or requirement ID) |
| 54 | 2. Platforms (select from list or type `all`) |
| 55 | 3. Posts per platform (default: 3) |
| 56 | 4. Published article URL (if available) |
| 57 | |
| 58 | ### Quick Mode (All Parameters) |
| 59 | ``` |
| 60 | /contentforge:cf-social-adapt REQ-001 --platforms=linkedin,twitter,instagram --count=5 --url=https://acme-corp.com/blog/ai-healthcare-2026 |
| 61 | ``` |
| 62 | |
| 63 | ### All Platforms, Default Count |
| 64 | ``` |
| 65 | /contentforge:cf-social-adapt REQ-001 --platforms=all |
| 66 | ``` |
| 67 | |
| 68 | ### With Campaign Hashtag |
| 69 | ``` |
| 70 | /contentforge:cf-social-adapt REQ-001 --platforms=all --hashtag=#AcmeMedInsights --count=4 |
| 71 | ``` |
| 72 | |
| 73 | ## What Happens |
| 74 | |
| 75 | ### Step 1: Load and Analyze Source Content (15-30 seconds) |
| 76 | |
| 77 | **Load the finished article and extract key metadata:** |
| 78 | ``` |
| 79 | Source Content Loaded |
| 80 | --------------------------------------------------- |
| 81 | Title: "AI in Healthcare: 2026 Trends" |
| 82 | Brand: AcmeMed |
| 83 | Word Count: 1,947 |
| 84 | Quality Score: 9.2/10 |
| 85 | Key Topics: AI diagnostics, precision medicine, patient care, cost reduction |
| 86 | Primary Keyword: "AI in healthcare" |
| 87 | --------------------------------------------------- |
| 88 | ``` |
| 89 | |
| 90 | ### Step 2: Extract Shareworthy Moments (30-60 seconds) |
| 91 | |
| 92 | The Social Adapter Agent (`agents/10-social-adapter.md`) identifies 10-15 moments from the article that will resonate on social media. |
| 93 | |
| 94 | **Extraction criteria:** |
| 95 | - Statistics and data points (numbers grab attention) |
| 96 | - Counterintuitive insights (challenge assumptions) |
| 97 | - Actionable tips (practical value) |
| 98 | - Quotable statements (from sources or the article itself) |
| 99 | - Provocative questions (drive engagement) |
| 100 | - Before/after comparisons (transformation stories) |
| 101 | - Lists and frameworks (easy to visualize) |
| 102 | |
| 103 | **SYNTHETIC EXAMPLE — fabricated f |