Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

X (Twitter) to Markdown Converter

Turns X/Twitter tweets, threads, and articles into Markdown files with YAML front matter.

UtilitiesIntermediate★ 24,749⑂ 2,764AI score 6/10Last updated: Jul 4, 2026

What it does

  • Takes a tweet, thread, or X Article URL from x.com / twitter.com and converts it into a Markdown file.
  • Adds YAML front matter with url, author, tweetCount, and coverImage.
  • Optional --download-media saves images/videos into local imgs/ and videos/ folders and rewrites links to relative paths.
  • Runs a consent/disclaimer flow on first use and stores your preferences in EXTEND.md (media handling, default output directory).
  • Output layout: x-to-markdown/{username}/{tweet-id}/{slug}.md

⚠️ This skill uses a reverse-engineered, unofficial X API and needs X_AUTH_TOKEN/X_CT0 env vars or your Chrome login cookies. Account restrictions are possible — use at your own risk.

Who it's for

  • Anyone archiving great tweets/threads into Obsidian, Notion, or a personal knowledge base.
  • Content creators repurposing X Articles into blog drafts or newsletters.
  • Researchers who need verbatim tweet text plus source metadata for citation.

Examples

  1. Archive a thread: "Save this thread as markdown: https://x.com/user/status/123" → file created under x-to-markdown/user/123/ with images pulled down locally.
  2. Repurpose an article: pass an X Article URL and ask to "extract the full text into my blog drafts folder" using the -o flag.
  3. Automation pipeline: use --json to get structured output and pipe it into your own summarization or translation script.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/baoyu-danger-x-to-markdown folder from the GitHub repo JimLiu/baoyu-skills into my ~/.claude/skills/baoyu-danger-x-to-markdown/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/JimLiu/baoyu-skills.git /tmp/baoyu-skills && mkdir -p ~/.claude/skills && cp -r /tmp/baoyu-skills/skills/baoyu-danger-x-to-markdown ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Prerequisites: run bun --version or npx --version. If neither exists, install bun with curl -fsSL https://bun.sh/install | bash.
  2. Clone the repo: git clone https://github.com/JimLiu/baoyu-skills.git /tmp/baoyu-skills
  3. Copy the skill: mkdir -p ~/.claude/skills && cp -r /tmp/baoyu-skills/skills/baoyu-danger-x-to-markdown ~/.claude/skills/
  4. Restart Claude Code and confirm baoyu-danger-x-to-markdown shows up in your skill list.
  5. Set up auth (optional but recommended): export X_AUTH_TOKEN and X_CT0. Otherwise the tool opens Chrome to log in and caches cookies locally.
  6. First run: ask "convert https://x.com/... to markdown". You'll see the disclaimer prompt and three first-time setup questions (media handling, output dir, where to save prefs).
  7. Check the generated file under ./x-to-markdown/.
View source on GitHub ↗License: MIT