obsidian-clip

# Obsidian Clip Turn a URL into a **readable, reusable Clip note** in an Obsidian vault. ## Storage - Vault: `${OBSIDIAN_VAULT}` (recommended to set; fallback supported by script) - Folder: `Clip/YYYY-MM/` - Filename: `YYYY-MM-DD_标题_关键词.md` ## Output standard (must follow) The skill supports **Chinese and English** notes. - Default language: **auto-detect** (based on your system locale and whether the content contains CJK characters) - Override language: set `OBSIDIAN_CLIP_LANG=zh` or `OBSIDIAN_CLIP_LANG=en` Structure: 1) **Theme / 主题一句话** (1 sentence, plain) 2) **Takeaways / 要点** (5–10 bullets, each ≤ 1 line) 3) **How I’ll use it / 我怎么用** (1–3 bullets; actions / why it matters) 4) **Limits / 规则/限制** (optional; paywall/login required, license, caveats) ## Workflow 1) **Fetch the page** - Prefer lightweight extraction tools (e.g., `web_fetch`) first. - Use a real browser only when needed (JS-heavy sites / WeChat / login / extraction fails). - If blocked by login/paywall, ask the user to log in, then retry. 2) **Rewrite for readability** - Don’t make the output about tool limitations. - If details are still inaccessible, produce a useful clip anyway: page定位 + 可用信息 + what you need to finish. - Do **not** send screenshots/images unless the user explicitly requests. 3) **Save to Obsidian** using the bundled script. ## Bundled script Path: `scripts/clip_save.sh` Example: ```bash bash scripts/clip_save.sh \ --url "https://example.com" \ --title "页面标题" \ --theme "一句话主题" \ --bullets "要点1" --bullets "要点2" \ --actions "我怎么用1" \ --limits "规则/限制（可选）" \ --tags "clip" --tags "ai" \ --keywords "keyword1-keyword2" \ --date "YYYY-MM-DD" ``` Notes: - `--bullets` / `--actions` / `--limits` / `--tags` can be repeated. - Keep `--keywords` short (2–5 tokens joined by `-`).