adapt-copy
Adapt post copy per platform: character limits, hashtags, tone and the right CTA mechanism. \"rewrite this caption for LinkedIn\"
indranilbanerjee · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add indranilbanerjee/socialforge --skill adapt-copyAbout this skill
name: adapt-copy description: "Adapt post copy per platform: character limits, hashtags, tone and the right CTA mechanism. "rewrite this caption for LinkedIn"" argument-hint: "[--post ] [--all] [--platform ]" effort: medium user-invocable: true
/socialforge:adapt-copy — Copy Adapter
Transform a single caption brief into platform-optimized copy for each target platform.
Context efficiency
Asset-heavy skill. Grep before Read the asset catalog (${CLAUDE_PLUGIN_DATA}/socialforge/brands/<brand>/asset-index.json) — never list the asset directory. Reference generated images / videos by path, not by loading metadata. Brand profile loads once per session.
Process (Per Post x Per Platform)
- Load post brief (topic, caption_brief, CTA, hashtags, campaign)
- Load brand-config.json (tone, hashtags, language settings)
- Load compliance-rules.json (banned phrases, disclaimers)
- For X/Twitter posts with live-source context, read the optional X/Twitter research intake note and use only reviewed evidence
- Write platform-specific copy (tone and structure per platform, within these limits):
| Platform | Tone | Limit | Hashtags: aim / script cap | Link |
|---|---|---|---|---|
| Professional | 3,000 chars (140 before fold) | 3-5 / 5 | Direct URL | |
| Conversational | 2,200 chars | 3-5 / 5 (first comment) | Link in bio | |
| X/Twitter | Punchy, concise | 280, counted by weight (emoji and CJK 2, any URL 23) | 1-2 / 2 | Direct URL |
| Casual | 500 chars optimal (63,206 hard limit) | 1-3 / 3 | Direct URL | |
| YouTube | Description format | 5,000 chars | 3-5 / 5 | Direct URLs |
| TikTok | Casual, trend-aware | 2,200 chars | 3-5 / 10 (trending + branded) | Link in bio |
| Search-friendly description | 800 chars | 5-10 / 20 | Direct URL | |
| Threads | Conversational | 500 chars | 1 / 1 | Direct URL |
| Bluesky | Concise, community-first | 300 chars | 1-2 / 2 (via tag facets) | Direct URL |
The limits are data, and not all of them are confirmed. scripts/platform_limits.json records every number with its source URL, the date it was checked and a status: confirmed (a primary platform page says it), differs, or unsourced (SocialForge's working value, no readable primary page). On 2026-10-04 the character limits for Instagram, Facebook and TikTok were unsourced (third-party pages report 4,000 for TikTok; unconfirmed, so 2,200 stays as the safe cap), as is every fold position. Run python "${CLAUDE_PLUGIN_ROOT}/scripts/adapt_copy.py" --sources before telling anyone a limit is official; platforms change limits without notice. "Aim" is a working range from SocialForge's platform notes, not a platform rule. The script cap is how many hashtags adapt_copy.py keeps.
- Measure and fit every variant with
adapt_copy.py(see "Run the adapter" below) - Apply brand hashtags (always_include + campaign-specific), up to each platform's cap, and tell the user which ones the cap dropped
- Run compliance check - flag banned phrases, add disclaimers
- Handle bilingual posts if configured
- Save to
production/copy/post-{id}-{platform}-copy.txt
No significance markers. Never write a line whose only job is to announce that the next line matters: "here's the thing", "the thing is,", "here's the kicker", "here's where it gets interesting", "that's the part that got me", "let that sink in", "read that again". They read as machine-written, and on a 280-character platform they spend budget the point needs. Lead with the specific instead — "Approvals went from 14 days to 31" beats "Here's the thing about approval timelines". Same for stacked soft adverbs (honestly / genuinely / truly / literally / actually / basically): at most one per caption, never two in a sentence.
This is a writing rule enforced by the copy-adapter agent, not a scan. SocialForge ships no AI-tell scanner on purpose — caption-length copy has no document structure to measure, and per-1000-word metrics are noise at 280 characters.
When the post's CTA is a conversation (a keyword that opens a DM, a WhatsApp or Messenger thread), read conversational-commerce.md: opt-in and 24-hour-window rules, and playbooks for the post, the first reply, the handoff, and templates.
Run the adapter
Write each variant without the CTA and without hashtags, then measure and fit it:
python "${CLAUDE_PLUGIN_ROOT}/scripts/adapt_copy.py" --text "<the variant>" --platform x --brand <slug> --cta "<CTA wording and URL>" --campaign-hashtags "#Tag1" "#Tag2"
Read these fields of the JSON it prints:
within_limit,char_count,char_limit- the variant measured against the limit.count_methodsays how it was counted:code_points(plain characters) everywhere except X, which isx_weighted: emoji and CJK characters count 2 and every URL counts 23 however long it is, so X'schar_countis notlen(copy). Ifwithin_limitis false, shorten the copy or the CTA.copy- the variant with the CTA turned into the platform's mechanism. If it is shorter than what you wrote, the script cut it mechanically: tighten the prose and run it again rather than shipping the cut.hashtags,first_comment- what to post and where (Instagram: first comment).hashtags_dropped- the hashtags the platform's cap left out, in the order given (an empty list when none). Tell the user which hashtags were dropped, per platform; a cap must never remove a tag without saying so. Put the tags that must survive first.
What the script does not measure: Threads counts emoji as UTF-8 bytes (more than 1 each), Bluesky's limit is 300 graphemes (code points can only over-count), and a bare domain without http://, https:// or www. counts as plain text although X links it. Keep a margin on X and Threads when the copy has emoji or bare domains.