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.comortwitter.comtotweet.md - Programmatic API usage with API keys
Skill file
See SKILL.md.
Links
- Website: https://tweet.md
- Docs: https://tweet.md/i/docs
- Credits: https://tweet.md/i/topup
- API key dashboard: https://tweet.md/i/dashboard
License
MIT
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add tweet-md/skill