# Send Markdown to Social to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "markdown-to-social",
    "name": "Markdown to Social",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/HugoSbl/markdown-to-social",
    "canonicalUrl": "https://clawhub.ai/HugoSbl/markdown-to-social",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/markdown-to-social",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=markdown-to-social",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/md2social.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "markdown-to-social",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:39:24.842Z",
      "expiresAt": "2026-05-07T03:39:24.842Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=markdown-to-social",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=markdown-to-social",
        "contentDisposition": "attachment; filename=\"markdown-to-social-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "markdown-to-social"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/markdown-to-social"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/markdown-to-social",
    "downloadUrl": "https://openagent3.xyz/downloads/markdown-to-social",
    "agentUrl": "https://openagent3.xyz/skills/markdown-to-social/agent",
    "manifestUrl": "https://openagent3.xyz/skills/markdown-to-social/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/markdown-to-social/agent.md"
  }
}
```
## Documentation

### 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

FlagDescription--platformtwitter, linkedin, or reddit--allGenerate all 3 formats at once--textUse direct text instead of a file--output DIRSave to files (twitter.txt, linkedin.txt, reddit.md)--jsonOutput as JSON

### 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: HugoSbl
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T03:39:24.842Z
- Expires at: 2026-05-07T03:39:24.842Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/markdown-to-social)
- [Send to Agent page](https://openagent3.xyz/skills/markdown-to-social/agent)
- [JSON manifest](https://openagent3.xyz/skills/markdown-to-social/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/markdown-to-social/agent.md)
- [Download page](https://openagent3.xyz/downloads/markdown-to-social)