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.

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