How do I install the Markdown To Social skill?

Run npx skillmds@latest add demerzels-lab/markdown-to-social 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.

What does the Markdown To Social skill do?

markdown-to-social It is listed under Docs & Writing on SkillMD.

Is Markdown To Social safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Markdown To Social?

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.

Is Markdown To Social free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Markdown To Social?

Demerzels-lab (@demerzels-lab) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Markdown To Social by demerzels-lab

Name: Markdown To Social
Author: Demerzels-lab

File contents

markdown-to-social

Convert markdown articles/text into platform-optimized social media posts. One content → multiple formats (Twitter thread, LinkedIn post, Reddit post).

Usage

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

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

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

---name: markdown-to-socialdescription: markdown-to-social---# markdown-to-socialConvert markdown articles/text into platform-optimized social media posts.One content → multiple formats (Twitter thread, LinkedIn post, Reddit post).## Usage```bashpython3 scripts/md2social.py convert <file.md> --platform twitter|linkedin|redditpython3 scripts/md2social.py convert <file.md> --allpython3 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)## DependenciesPython 3.10+ stdlib only. No external packages, no API calls.## Examples```bash# Twitter thread from an articlepython3 scripts/md2social.py convert article.md --platform twitter# All platforms, saved to filespython3 scripts/md2social.py convert article.md --all --output ./social-posts# Quick text to LinkedInpython3 scripts/md2social.py convert --text "Big news today..." --platform linkedin# JSON output for automationpython3 scripts/md2social.py convert article.md --all --json```## File Structure```skills/markdown-to-social/├── SKILL.md # This file└── scripts/ └── md2social.py # Main CLI script```

Frequently asked questions

Markdown To Social