Agent skill · writing content · jimliu
baoyu-danger-x-to-markdown
Converts X (Twitter) tweets and articles to markdown with YAML front matter. Uses reverse-engineered API requiring user consent. Use when user mentions "X to markdown", "tweet to markdown", "save tweet", or provides x.com/twitter.com URLs for conversion.
Why this skill is useful
Adds a specific workflow for converting X content to markdown with user consent and error handling that the AI wouldn't reliably generate on its own.
What it needs
Requires bun, npx installed locally. About 4k tokens when loaded. Last updated 2026-07-04. 24,677 stars on the source repository.
What this skill does
X to Markdown Converts X content to markdown: Tweets/threads → Markdown with YAML front matter X Articles → Full content extraction User Input Tools When this skill prompts the user, follow this tool-selection rule (priority order): 1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, requestuserinput, clarify, askuser, or any equivalent. 2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question. 3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order. Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes. Script Directory Scripts located in scripts/ subdirectory. Path Resolution: 1. {baseDir} = this SKILL.md's directory 2. Script path = {baseDir}/scripts/main.ts 3. Resolve ${BUNX} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun Consent Requirement Before any conversion, check and obtain consent. Consent Flow Step 1: Check consent file Step 2: If accepted: true and disclaimerVersion: "1.0" → print warning and proceed: Step 3: If missing or version mismatch → display disclaimer: Use AskUserQuestion with options: "Yes, I accept" "No, I decline" Step 4: On accept → create consent file: Step 5: On decline → output "User declined. Exiting." and stop. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jimliu/baoyu-danger-x-to-markdown