Convert markdown articles/text into platform-optimized social media posts.
One content → multiple formats (Twitter thread, LinkedIn post, Reddit post).
Save to files (twitter.txt, linkedin.txt, reddit.md)
--json
Output as JSON
Platform Rules
Twitter
Hook tweet with 🧵 + numbered thread (1/N, 2/N...)
Each tweet strictly < 280 chars
Smart sentence splitting (no mid-sentence cuts)
6-8 tweets max, CTA at the end
LinkedIn
Hook paragraph visible before "see more" (~1300 chars)
Emoji bullets, frequent line breaks for mobile
3000 chars max, 5-8 hashtags at the end
Professional but engaging tone
Reddit
Title < 300 chars
TL;DR at the top
Full markdown body preserved (headers, bold, bullets)
Dependencies
Python 3.10+ stdlib only. No external packages, no API calls.
Examples
# Twitter thread from an article
python3 scripts/md2social.py convert article.md --platform twitter
# All platforms, saved to files
python3 scripts/md2social.py convert article.md --all --output ./social-posts
# Quick text to LinkedIn
python3 scripts/md2social.py convert --text "Big news today..." --platform linkedin
# JSON output for automation
python3 scripts/md2social.py convert article.md --all --json
File Structure
skills/markdown-to-social/
├── SKILL.md # This file
└── scripts/
└── md2social.py # Main CLI script
1---2name: markdown-to-social-23description: markdown-to-social4---5# markdown-to-social67Convert markdown articles/text into platform-optimized social media posts.8One content → multiple formats (Twitter thread, LinkedIn post, Reddit post).910## Usage1112```bash13python3 scripts/md2social.py convert <file.md> --platform twitter|linkedin|reddit14python3 scripts/md2social.py convert <file.md> --all15python3 scripts/md2social.py convert --text "Direct text" --platform twitter16```1718## Options1920| Flag | Description |21|------|-------------|22| `--platform` | `twitter`, `linkedin`, or `reddit` |23| `--all` | Generate all 3 formats at once |24| `--text` | Use direct text instead of a file |25| `--output DIR` | Save to files (twitter.txt, linkedin.txt, reddit.md) |26| `--json` | Output as JSON |2728## Platform Rules2930### Twitter31- Hook tweet with 🧵 + numbered thread (1/N, 2/N...)32- Each tweet strictly < 280 chars33- Smart sentence splitting (no mid-sentence cuts)34- 6-8 tweets max, CTA at the end3536### LinkedIn37- Hook paragraph visible before "see more" (~1300 chars)38- Emoji bullets, frequent line breaks for mobile39- 3000 chars max, 5-8 hashtags at the end40- Professional but engaging tone4142### Reddit43- Title < 300 chars44- TL;DR at the top45- Full markdown body preserved (headers, bold, bullets)4647## Dependencies4849Python 3.10+ stdlib only. No external packages, no API calls.5051## Examples5253```bash54# Twitter thread from an article55python3 scripts/md2social.py convert article.md --platform twitter5657# All platforms, saved to files58python3 scripts/md2social.py convert article.md --all --output ./social-posts5960# Quick text to LinkedIn61python3 scripts/md2social.py convert --text "Big news today..." --platform linkedin6263# JSON output for automation64python3 scripts/md2social.py convert article.md --all --json65```6667## File Structure6869```70skills/markdown-to-social/71├── SKILL.md # This file72└── scripts/73 └── md2social.py # Main CLI script74```
Run npx skillmds@latest add demerzels-lab/markdown-to-social-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
markdown-to-social It is listed under Docs & Writing on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Demerzels-lab (@demerzels-lab) published this skill. Their other Agent Skills are listed on their SkillMD profile.