PaperclipOrg
Claude Agent Skill · by Jimliu

Baoyu Danger X To Markdown

baoyu-danger-x-to-markdown converts tweets, threads, and X articles into markdown files with YAML front matter, enabling users to save and archive social media

Install
Terminal · npx
$npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-danger-x-to-markdown
Works with Paperclip

How Baoyu Danger X To Markdown fits into a Paperclip company.

Baoyu Danger X To Markdown drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md224 lines
Expand
---name: baoyu-danger-x-to-markdowndescription: 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.version: 1.56.1metadata:  openclaw:    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-danger-x-to-markdown    requires:      anyBins:        - bun        - npx--- # X to Markdown Converts X content to markdown:- Tweets/threads → Markdown with YAML front matter- X Articles → Full content extraction ## Script Directory Scripts located in `scripts/` subdirectory. **Path Resolution**:1. `{baseDir}` = this SKILL.md's directory2. Script path = `{baseDir}/scripts/main.ts`3. Resolve `${BUN_X}` 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 ```bash# macOScat ~/Library/Application\ Support/baoyu-skills/x-to-markdown/consent.json # Linuxcat ~/.local/share/baoyu-skills/x-to-markdown/consent.json``` **Step 2**: If `accepted: true` and `disclaimerVersion: "1.0"` → print warning and proceed:```Warning: Using reverse-engineered X API. Accepted on: <acceptedAt>``` **Step 3**: If missing or version mismatch → display disclaimer:```DISCLAIMER This tool uses a reverse-engineered X API, NOT official. Risks:- May break if X changes API- No guarantees or support- Possible account restrictions- Use at your own risk Accept terms and continue?``` Use `AskUserQuestion` with options: "Yes, I accept" | "No, I decline" **Step 4**: On accept → create consent file:```json{  "version": 1,  "accepted": true,  "acceptedAt": "<ISO timestamp>",  "disclaimerVersion": "1.0"}``` **Step 5**: On decline → output "User declined. Exiting." and stop. ## Preferences (EXTEND.md) Check EXTEND.md existence (priority order): ```bash# macOS, Linux, WSL, Git Bashtest -f .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md && echo "project"test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md" && echo "xdg"test -f "$HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md" && echo "user"``` ```powershell# PowerShell (Windows)if (Test-Path .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md) { "project" }$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }if (Test-Path "$xdg/baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md") { "xdg" }if (Test-Path "$HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md") { "user" }``` ┌────────────────────────────────────────────────────────────┬───────────────────┐│                            Path                            │     Location      │├────────────────────────────────────────────────────────────┼───────────────────┤│ .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md         │ Project directory │├────────────────────────────────────────────────────────────┼───────────────────┤│ $HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md   │ User home         │└────────────────────────────────────────────────────────────┴───────────────────┘ ┌───────────┬───────────────────────────────────────────────────────────────────────────┐│  Result   │                                  Action                                   │├───────────┼───────────────────────────────────────────────────────────────────────────┤│ Found     │ Read, parse, apply settings                                               │├───────────┼───────────────────────────────────────────────────────────────────────────┤│ Not found │ **MUST** run first-time setup (see below) — do NOT silently create defaults │└───────────┴───────────────────────────────────────────────────────────────────────────┘ **EXTEND.md Supports**: Download media by default | Default output directory ### First-Time Setup (BLOCKING) **CRITICAL**: When EXTEND.md is not found, you **MUST use `AskUserQuestion`** to ask the user for their preferences before creating EXTEND.md. **NEVER** create EXTEND.md with defaults without asking. This is a **BLOCKING** operation — do NOT proceed with any conversion until setup is complete. Use `AskUserQuestion` with ALL questions in ONE call: **Question 1** — header: "Media", question: "How to handle images and videos in tweets?"- "Ask each time (Recommended)" — After saving markdown, ask whether to download media- "Always download" — Always download media to local imgs/ and videos/ directories- "Never download" — Keep original remote URLs in markdown **Question 2** — header: "Output", question: "Default output directory?"- "x-to-markdown (Recommended)" — Save to ./x-to-markdown/{username}/{tweet-id}.md- (User may choose "Other" to type a custom path) **Question 3** — header: "Save", question: "Where to save preferences?"- "User (Recommended)" — ~/.baoyu-skills/ (all projects)- "Project" — .baoyu-skills/ (this project only) After user answers, create EXTEND.md at the chosen location, confirm "Preferences saved to [path]", then continue. Full reference: [references/config/first-time-setup.md](references/config/first-time-setup.md) ### Supported Keys | Key | Default | Values | Description ||-----|---------|--------|-------------|| `download_media` | `ask` | `ask` / `1` / `0` | `ask` = prompt each time, `1` = always download, `0` = never || `default_output_dir` | empty | path or empty | Default output directory (empty = `./x-to-markdown/`) | **Value priority**:1. CLI arguments (`--download-media`, `-o`)2. EXTEND.md3. Skill defaults ## Usage ```bash${BUN_X} {baseDir}/scripts/main.ts <url>${BUN_X} {baseDir}/scripts/main.ts <url> -o output.md${BUN_X} {baseDir}/scripts/main.ts <url> --download-media${BUN_X} {baseDir}/scripts/main.ts <url> --json``` ## Options | Option | Description ||--------|-------------|| `<url>` | Tweet or article URL || `-o <path>` | Output path || `--json` | JSON output || `--download-media` | Download image/video assets to local `imgs/` and `videos/`, and rewrite markdown links to local relative paths || `--login` | Refresh cookies only | ## Supported URLs - `https://x.com/<user>/status/<id>`- `https://twitter.com/<user>/status/<id>`- `https://x.com/i/article/<id>` ## Output ```markdown---url: "https://x.com/user/status/123"author: "Name (@user)"tweetCount: 3coverImage: "https://pbs.twimg.com/media/example.jpg"--- Content...``` **File structure**: `x-to-markdown/{username}/{tweet-id}/{content-slug}.md` When `--download-media` is enabled:- Images are saved to `imgs/` next to the markdown file- Videos are saved to `videos/` next to the markdown file- Markdown media links are rewritten to local relative paths ## Media Download Workflow Based on `download_media` setting in EXTEND.md: | Setting | Behavior ||---------|----------|| `1` (always) | Run script with `--download-media` flag || `0` (never) | Run script without `--download-media` flag || `ask` (default) | Follow the ask-each-time flow below | ### Ask-Each-Time Flow 1. Run script **without** `--download-media` → markdown saved2. Check saved markdown for remote media URLs (`https://` in image/video links)3. **If no remote media found** → done, no prompt needed4. **If remote media found** → use `AskUserQuestion`:   - header: "Media", question: "Download N images/videos to local files?"   - "Yes" — Download to local directories   - "No" — Keep remote URLs5. If user confirms → run script **again** with `--download-media` (overwrites markdown with localized links) ## Authentication 1. **Environment variables** (preferred): `X_AUTH_TOKEN`, `X_CT0`2. **Chrome login** (fallback): Auto-opens Chrome, caches cookies locally ## Extension Support Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.