x-readable

Read X post URLs into readable Markdown, text, and JSON.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/XindanZhang/reader-skill --skill x-readable
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-readable
Source: https://github.com/XindanZhang/reader-skill/tree/main/skills/x-readable
Command: npx skills add https://github.com/XindanZhang/reader-skill --skill x-readable

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read post URLs from X into readable Markdown, text, and JSON to be consumed by AI agents and assistants.

Core Features & Use Cases

  • Read a single post URL and render it as clean, readable Markdown or JSON.
  • Expand threads to deliver the conversation in a structured, readable format.
  • Output includes a normalized URL, provider attribution, warnings, and LLM-friendly content for downstream processing.

Quick Start

Use the CLI to read a post URL and specify the output format to get readable content immediately.

Frequently Asked Questions about x-readable

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert X post URLs into clean Markdown for AI copilots?

You can convert X post URLs into clean Markdown by using a CLI to fetch the content, which outputs readable Markdown, text, or JSON. It prefers the official X API and uses jina.ai and oembed as fallbacks for delivery.

Can I expand an entire X thread into a structured readable format?

Yes, you can expand X threads into a structured readable format. The tool processes both single posts and threads, delivering the conversation in a structured Markdown or JSON format suitable for downstream AI processing.

What is the best way to get LLM-friendly content from an X post?

The best way to get LLM-friendly content from an X post is to parse the URL into Markdown or JSON. This ensures the output includes normalized URLs, provider attribution, warnings, and content structured specifically for AI consumption.

Does the X post reader work without direct access to the official X API?

Yes, the tool works without direct access to the official X API by utilizing jina.ai and oembed as fallback mechanisms. This ensures you can still fetch and render X post content into readable Markdown or JSON formats.

How do I output X post data as JSON using a command line interface?

You can output X post data as JSON by using the CLI to specify JSON as your desired output format. The tool fetches the post or thread and returns structured LLM-friendly JSON data complete with normalized URLs and provider attribution.