Markdown to Social

Convert markdown text into optimized social media posts tailored for Twitter, LinkedIn, or Reddit formats with appropriate length and style.

Security Scan

The skill's code and instructions match its stated purpose (converting Markdown into social-post formats), request no credentials, and use only Python stdlib — no obvious incoherence or exfiltration behavior was found, but part of the script output in the prompt was truncated so review that tail if you want maximal assurance.

Purpose & Capability

Name, SKILL.md, and the included Python script all describe converting markdown into Twitter/LinkedIn/Reddit formats. No unrelated binaries, services, or credentials are requested.

Instruction Scope

Runtime instructions tell the agent to run the included Python CLI on a supplied file or text. The visible code reads only the provided file or --text, parses and reformats it, and prepares platform-specific outputs. The file snippet in the prompt was truncated near CLI-handling output logic, so the very end of the script (likely handling writing files/JSON output) wasn't visible — this is the only area worth double-checking to ensure it doesn't perform unexpected filesystem or network actions.

Install Mechanism

No install spec — instruction-only with an included script. This is low-risk: nothing downloads or executes external installers. The SKILL.md claims Python 3.10+ stdlib only, which matches the script imports.

Credentials

The skill requests no environment variables, no credentials, and the code does not reference os.environ or any secret/config paths in the visible portion.

Persistence & Privilege

always is false and autonomous invocation is allowed by default. The skill does not request persistent system privileges or to modify other skills/configs in the visible code.

Assessment

This skill appears coherent and limited to converting Markdown into social-post drafts using only Python stdlib. Before running it on sensitive data, quickly inspect the end of scripts/md2social.py (the CLI finalization/writing logic) to confirm it writes only to the --output directory or stdout and does not read other unrelated files or make network calls. Run first on non-sensitive sample files, or execute in a sandbox/container if you want stronger isolation. If you plan to enable autonomous invocation, remember the agent could run the script without manual confirmation — ensure that behavior is acceptable for your environment.

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

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