How are threads formatted?

Threads are concatenated into a single Markdown file with clear separation, preserving the flow of the original conversation with added YAML metadata.

Does it support both x.com and twitter.com URLs?

Yes, the skill recognizes and processes status URLs from both x.com and twitter.com, as well as newer X Article links.

How do I provide authentication for the X API?

You can set the X_AUTH_TOKEN and X_CT0 environment variables, or the skill will automatically attempt to refresh cookies via your local Chrome browser session.

Why is there a consent requirement?

The tool uses a reverse-engineered API rather than the official X API. The consent flow ensures you are aware of the risks, such as potential account restrictions or API instability.

Can I save files to a specific folder automatically?

Yes, you can configure a default output directory by creating an EXTEND.md file in your project directory or user home folder.

X to Markdown Converter

Name: X to Markdown Converter
Author: JimLiu

byJimLiu

•

2,275

•

Web Scraping & Data Collection

Converts X (Twitter) tweets, threads, and articles into clean Markdown files with YAML front matter.

This skill empowers Claude to extract and archive content from X (formerly Twitter) directly into your workspace. It handles individual tweets, multi-post threads, and long-form X Articles, converting them into structured Markdown files complete with metadata like author information and tweet counts in the YAML front matter. Designed for research and knowledge management, it includes a robust consent flow for its reverse-engineered API and supports flexible configuration through custom preference files, allowing you to automate the transition from social media content to permanent documentation.

Key Features

01Flexible Authentication: Supports authentication via environment variables or automated Chrome cookie caching.

02Thread and Article Extraction: Captures full tweet threads and long-form articles seamlessly.

03YAML Front Matter: Automatically generates metadata including author, URL, and tweet count.

04Customizable Preferences: Allows project-specific or global settings for output directories and formatting via EXTEND.md.

05Built-in Consent Flow: Ensures safe usage with a mandatory one-time disclaimer for the reverse-engineered API.

062,275 GitHub stars

Use Cases

01Automating content collection for social media research and digital gardening.

02Archiving insightful Twitter threads for personal knowledge bases or second brains.

03Converting technical X Articles into Markdown for offline reading and documentation.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimliu/baoyu-skills baoyu-danger-x-to-markdown

For use in Claude.ai and ChatGPT

Download Skill