markdown-to-social
Convert markdown articles/text into platform-optimized social media posts.
Best use case
markdown-to-social is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Convert markdown articles/text into platform-optimized social media posts.
Teams using markdown-to-social should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/markdown-to-social/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How markdown-to-social Compares
| Feature / Agent | markdown-to-social | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Convert markdown articles/text into platform-optimized social media posts.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# markdown-to-social
Convert markdown articles/text into platform-optimized social media posts.
One content → multiple formats (Twitter thread, LinkedIn post, Reddit post).
## Usage
```bash
python3 scripts/md2social.py convert <file.md> --platform twitter|linkedin|reddit
python3 scripts/md2social.py convert <file.md> --all
python3 scripts/md2social.py convert --text "Direct text" --platform twitter
```
## Options
| Flag | Description |
|------|-------------|
| `--platform` | `twitter`, `linkedin`, or `reddit` |
| `--all` | Generate all 3 formats at once |
| `--text` | Use direct text instead of a file |
| `--output DIR` | 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
```bash
# 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
```Related Skills
```markdown
# OpenClaw-Last.fm
glasses-to-social
Turn smart glasses photos into social media posts. Monitors a Google Drive folder for new images from Meta Ray-Ban glasses (or any smart glasses), analyzes them with vision AI, drafts tweets/posts in the user's voice, and publishes on approval. Use when setting up a glasses-to-social pipeline, processing smart glasses photos for social media, or creating hands-free content workflows.
social-media-detox
Break social media addiction with screen-free streaks, urge tracking, and digital wellness
simplified-social-media
Manage your entire social media presence — post, schedule, and analyze — directly from your AI coding tool.
agent-social
Interact with AgentGram social network for AI agents. Post, comment, vote, follow, and build reputation. Open-source, self-hostable, REST API.
markdown-fetch
Optimizes web fetching by using Cloudflare's Markdown for Agents, reducing token consumption by ~80%.
socialite-guide
Expert guidance for generating "Socialite Style" (名媛风) images using AI art tools (Nano Banana Pro)
Social Media Story Video
**Version**: 1.0.0
Social Media Carousel
**Version**: 1.0.0
social-media-extractor
This skill enables Claude to extract public data from **Instagram**, **TikTok**, and **Reddit**.
efnet-social
The IRC social network for AI agents. Chat, share knowledge, and build bot culture on EFnet.
social-scheduler-extended
Schedule and manage social media posts via Postiz API (self-hosted or cloud). Direct API integration — no n8n dependency. Supports X/Twitter, LinkedIn, Bluesky with platform-specific character limits. Includes deduplication, scheduling, media upload, and thread creation. WHAT IT CAN DO: - Schedule posts to 28+ channels (X, LinkedIn, Bluesky, Reddit, Instagram, Facebook, Threads, YouTube, TikTok, Pinterest, Mastodon, and more) - Multi-platform posting in a single API call with platform-adapted content - X/Twitter thread creation for longer content - Media upload (file and URL) - Find next available posting slot per channel - List, query, update, and delete scheduled posts - Deduplication workflow (check existing before posting) - Platform-specific character limits and content tone guidance - Post state management (QUEUE, PUBLISHED, ERROR, DRAFT) - Helper script for quick posting with auto-validation USE WHEN: scheduling social media posts, creating multi-platform content, managing a posting calendar, uploading media for social posts, checking post status, creating X/Twitter threads, or automating social media workflows.