TM

tweet-md/skill

Developer tools
1 stars Quality 52 Trend 9MIT

Agent skill for converting X/Twitter posts, threads, and articles to clean Markdown via tweet.md

Overview

Agent skill for using tweet.md to convert X/Twitter posts, threads, and articles into clean Markdown for LLMs, agents, RAG, research, and Obsidian. The skill teaches compatible AI agents when and how to call tweet.md, including URL rewriting, API usage, authentication, thread handling, Obsidian output, and common error handling. After installation, ask your agent things like: The agent should use tweet.md to return clean Markdown instead of messy copied text, screenshots, embeds, or HTML. * Single X/Twitter posts * Threads * Quoted posts * X Articles / long-form posts * Profile fetching (bio, stats, pinned post, and a timeline of recent posts — replies and reposts optional) * Markdown output * Obsidian-friendly Markdown * Browser URL rewriting from x.com or twitter.com to tweet.md * Programmatic API usage with API keys * Website: https://tweet.md * Docs: https://tweet.md/i/docs * Credits: https://tweet.md/i/topup * API key dashboard: https://tweet.md/i/dashboard

README

tweet.md Skill

Agent skill for using tweet.md to convert X/Twitter posts, threads, and articles into clean Markdown for LLMs, agents, RAG, research, and Obsidian.

The skill teaches compatible AI agents when and how to call tweet.md, including URL rewriting, API usage, authentication, thread handling, Obsidian output, and common error handling.

Install

npx skills add tweet-md/skill

Or install directly from GitHub:

gh skill install tweet-md/skill

Usage

After installation, ask your agent things like:

Read this X thread and summarize it:
https://x.com/jack/status/20
Convert this tweet to Markdown:
https://x.com/jack/status/20
Fetch this thread for my RAG pipeline:
https://x.com/jack/status/20

The agent should use tweet.md to return clean Markdown instead of messy copied text, screenshots, embeds, or HTML.

What tweet.md supports

  • Single X/Twitter posts
  • Threads
  • Quoted posts
  • X Articles / long-form posts
  • Profile fetching (bio, stats, pinned post, and a timeline of recent posts — replies and reposts optional)
  • Markdown output
  • Obsidian-friendly Markdown
  • Browser URL rewriting from x.com or twitter.com to tweet.md
  • Programmatic API usage with API keys

Skill file

See SKILL.md.

License

MIT

View the full README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add tweet-md/skill
New to MCP? Start with the mcpskill.org guide →