1coos-quickie

# Quickie — URL to Markdown Grab any URL and save it as beautifully formatted Obsidian-style Markdown. Powered by [x-reader](https://github.com/runesleo/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: ```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](https://github.com/runesleo/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