Quickie — URL to Markdown#

Grab any URL and save it as beautifully formatted Obsidian-style Markdown. Powered by x-reader for content extraction.

Usage#

text

/1coos-quickie <text-containing-url> [--output-dir path] [--raw]

Parameters#

ParameterRequiredDescription<text>YesAny text containing a URL to fetch--output-dirNoOutput directory (default: from config.json)--rawNoSkip formatting, output raw x-reader result--configNoPath to config.json

Supported Platforms#

• Video: YouTube, Bilibili
• Social: Twitter/X, WeChat, Xiaohongshu (Little Red Book), Telegram
• Feeds: RSS/Atom
• General: Any HTTP/HTTPS URL

Configuration#

Core parameters are configurable via config.json in the skill directory:

json

{
  "outputDir": "~/Documents/quickie",
  "formatting": {
    "maxWidth": 80,
    "listMarker": "-"
  },
  "reader": {
    "timeout": 120000
  }
}

CLI arguments always override config.json values.

Security Notice#

This skill runs third-party code at runtime:

• uvx fetches and executes x-reader from GitHub on each invocation
• x-reader makes network requests to the target URL and platform-specific APIs (FxTwitter, etc.)
• Output is written only to the configured local directory

Execution Instructions#

When the user invokes this skill:

1. Check prerequisites: Verify uvx is available by running which uvx. If missing, tell the user: "uvx is required but not found. Please install uv from https://docs.astral.sh/uv/getting-started/installation/ and try again." Do NOT run any install commands on behalf of the user.

2. Run extraction: Execute the script using the skill's absolute path: bash

   bun run /path/to/skills/1coos-quickie/scripts/main.ts <user-arguments>
   
   

3. Report results: Show the output file path, the extracted title, and a brief content summary.

4. Handle errors:

   • Exit code 2: argument error (no URL found, invalid options)
   • Exit code 3: missing dependency (uvx not installed)
   • Exit code 4: x-reader fetch failure
   • Exit code 5: output write failure

Examples#

bash

# Grab a YouTube video transcript
/1coos-quickie https://www.youtube.com/watch?v=dQw4w9WgXcQ

# Save a tweet thread
/1coos-quickie 看看这条推特 https://x.com/user/status/123456 很有意思

# Clip an article with custom output
/1coos-quickie https://example.com/article --output-dir ~/notes/inbox

# Raw output without formatting
/1coos-quickie https://example.com/page --raw

Notes#

• First run caches x-reader dependencies; subsequent runs are faster
• Output filename is derived from the content title or URL domain + date
• Obsidian-style formatting includes: wikilinks, callout normalization, highlight syntax, table alignment, frontmatter formatting
• Uses x-reader[all] for full platform support