Quickie — URL to Markdown
Grab any URL and save it as beautifully formatted Obsidian-style Markdown. Powered by x-reader for content extraction.
Usage
/1coos-quickie <text-containing-url> [--output-dir path] [--raw]
Parameters
| Parameter | Required | Description |
|---|---|---|
<text> | Yes | Any text containing a URL to fetch |
--output-dir | No | Output directory (default: from config.json) |
--raw | No | Skip formatting, output raw x-reader result |
--config | No | Path 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:
{
"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:
- Check prerequisites: Verify
uvxis available by runningwhich 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. - Run extraction: Execute the script using the skill's absolute path:
bun run /path/to/skills/1coos-quickie/scripts/main.ts <user-arguments> - Report results: Show the output file path, the extracted title, and a brief content summary.
- 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
# 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