---
name: obsid-link-builder
description: Create and normalize shareable obsid.net links for Obsidian notes. Use when asked to generate links like https://obsid.net/?vault=...&file=... for chat/messages, convert obsidian://open links to obsid.net links, or verify URL encoding of vault/file parameters.
---

# Obsid Link Builder

Create canonical links in this format:

https://obsid.net/?vault=<ENCODED_VAULT>&file=<ENCODED_FILE_PATH>

## Workflow

1. Gather input in one of these forms:
- vault + file values
- existing obsidian://open?vault=...&file=... URL

2. Normalize file separators to '/'.
3. URL-encode vault and file values.
4. Output only the final obsid.net URL unless explanation is requested.

## CLI Helper

"$CODEX_HOME/skills/obsid-link-builder/scripts/build_obsid_link.sh" \
  --vault "Obsidian" \
  --file "Sites/Joost.blog/Posts"

"$CODEX_HOME/skills/obsid-link-builder/scripts/build_obsid_link.sh" \
  --obsidian-url "obsidian://open?vault=Obsidian&file=Sites%2FJoost.blog%2FPosts"