Documentation
README
Platform Adaptation — Platform-Specific Content Adaptation Methodology
Specialist platform knowledge used by the sns-copywriter and blog-writer agents when converting content.
Why Platform Adaptation Matters
Copy-pasting the same message to every platform makes it optimal for none. Each platform has its own algorithm, format, and user expectations. Repurposing means completely reshaping the form while preserving the core.
Platform Content DNA
X (Twitter)
| Attribute | Value |
|---|---|
| Core Value | Speed, opinion, conversation |
| Optimal Length | Single tweet 100–200 chars, thread 5–12 tweets |
| Algorithm Favors | High reply+retweet ratio, dwell time |
| Avoid | Solo external link tweets (50% reach drop), long text without images |
| Conversion Strategy | Core insight as 1 tweet → expand "why it matters" as thread |
Thread Structure Formula:
- Hook tweet: Bold claim or counterintuitive fact
- Context tweet: "Why this matters"
- Evidence tweets (3–5): Data, examples, quotes
- Pivot tweet: "So what should you do?"
- CTA tweet: "If this thread was useful, RT"
- Self-reply: Source link
| Attribute | Value |
|---|---|
| Core Value | Visual, inspiration, community |
| Optimal Length | Caption 125–150 chars (before fold), carousel 7–10 slides |
| Algorithm Favors | Saves, Shares, carousel completion rate |
| Avoid | Link text (not clickable), text-only posts |
| Conversion Strategy | Key data as visual cards, processes as carousels |
Carousel Structure Formula:
- Cover slide: Curiosity-driven title (large text)
- Problem definition: "Sound familiar?"
- Solution slides (3–5): One point per slide
- Summary slide: 3-line key recap
- CTA slide: "Save this for later"
| Attribute | Value |
|---|---|
| Core Value | Expertise, experience, networking |
| Optimal Length | 1,300–2,000 chars (3–4 scrolls) |
| Algorithm Favors | Comment count, dwell time, native content |
| Avoid | External links in body (40% reach drop), excessive hashtags |
| Conversion Strategy | Personal experience + professional insight combo, link in first comment |
Post Structure Formula:
[Hook: First 2 lines that stop the scroll]
[Empty line — ensure hook shows above "see more"]
[Story/Experience: 3–4 paragraphs]
[Insight/Lesson: Specific and actionable]
[CTA: End with a question — drive comments]
#hashtags 3–5 (last line)
Blog (SEO)
| Attribute | Value |
|---|---|
| Core Value | Depth, searchability, evergreen content |
| Optimal Length | 1,500–3,000 words |
| SEO Favors | H2/H3 structure, 1–2% keyword density, internal/external links |
| Avoid | Keyword stuffing, thin content, duplicate content |
| Conversion Strategy | Expand + structure the source, titles and subheadings aligned to search intent |
Source → Platform Conversion Matrix
| Source Element | X | Blog | ||
|---|---|---|---|---|
| Core claim | Hook tweet | Cover slide | Opening 2 lines | Title (H1) |
| Data/stats | Individual tweet | Infographic card | Inline citation | Table/chart |
| Case/story | Thread (2–3 tweets) | Mid-carousel | Body story | Section (H2) |
| Process/method | Numbered thread | Step carousel | List | Step-by-step guide |
| Quote | Individual tweet | Text card | Indented | Block quote |
| CTA | Final tweet | Last slide | Question ending | CTA button/banner |
Message Consistency Checklist
The form changes per platform, but the core message must stay identical:
- Is the same single core claim clearly conveyed across all versions?
- Is the tone adapted per platform while maintaining brand voice?
- Are data and facts identical across all versions?
- Is the CTA's ultimate destination consistent?
- Do visual elements (colors, fonts) follow the brand guide?