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 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 -).