Canghe Danger X To Markdown

This converts X posts and articles to markdown files with YAML front matter, saving them locally with a clean file structure organized by username and tweet ID. It uses a reverse-engineered API, so there's a consent flow before first use that warns about potential breakage and account risks. The interesting part is the media handling: you can configure it to always download images and videos locally, never download them, or ask each time. Authentication pulls from environment variables or falls back to opening Chrome to grab cookies. It includes a first-time setup that asks where you want to save preferences and how to handle media by default. Useful when you want to archive threads or articles from X without dealing with the official API.

skills.sh installs: 489
GitHub stars: 474
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add freestylefly/canghe-skills --skill canghe-danger-x-to-markdown --agent claude-code

Installs into .claude/skills of the current project.

Files

X to Markdown

Converts X content to markdown:

Tweets/threads → Markdown with YAML front matter
X Articles → Full content extraction

Script Directory

Scripts located in scripts/ subdirectory.

Path Resolution:

SKILL_DIR = this SKILL.md's directory
Script path = ${SKILL_DIR}/scripts/main.ts

Consent Requirement

Before any conversion, check and obtain consent.

Consent Flow

Step 1: Check consent file

# macOS
cat ~/Library/Application\ Support/canghe-skills/x-to-markdown/consent.json

# Linux
cat ~/.local/share/canghe-skills/x-to-markdown/consent.json

Step 2: If accepted: true and disclaimerVersion: "1.0" → print warning and proceed:

Warning: Using reverse-engineered X API. Accepted on: <acceptedAt>

Step 3: If missing or version mismatch → display disclaimer:

DISCLAIMER

This tool uses a reverse-engineered X API, NOT official.

Risks:
- May break if X changes API
- No guarantees or support
- Possible account restrictions
- Use at your own risk

Accept terms and continue?

Use AskUserQuestion with options: "Yes, I accept" | "No, I decline"

SKILL.md on GitHub