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