docs: Document skills CLI install path

Author: smcllns

.agents/plans/2026-05-14-authoring-skill-release.md

@@ -10,12 +10,15 @@ Scope:
 - [x] Mirror skill to `smcllns/skills`.
 - [x] Run build/lint/test checks.
 - [x] Push PR branches.
+- [x] Merge `smcllns/skills` mirror first so PR #7 docs can point at a real install URL.
+- [x] Add `skills.sh` install command to README.
 
 Decisions:
 - Plugin repo is canonical source.
 - `smcllns/skills` is the installable mirror.
 - Obsidian plugin install does not install agent skills.
 - Plugin runtime must not write to `~/.claude`, `~/.agents`, `~/.codex`, or dotfiles.
+- Merge/install order matters: public skills mirror first, plugin docs/release second.
 
 Unresolved questions:
 - None.

README.md

@@ -36,6 +36,12 @@ The plugin repo keeps the canonical source skill at `.agents/SKILL.md`, and rele
 
 Installing or updating the Obsidian plugin does **not** automatically install an agent skill. Claude, Codex, and other agents discover skills from their own configured roots, not from `<vault>/.obsidian/plugins/html-docs/`. The installable mirror lives in [smcllns/skills](https://github.com/smcllns/skills) as `obsidian-html-docs`; install it with your agent's normal skill installer, or ask your agent to read the bundled `SKILL.md` and integrate the guidance into your workflow.
 
+With the `skills.sh` CLI:
+
+```bash
+bunx skills add https://github.com/smcllns/skills/tree/main/skills/obsidian-html-docs
+```
+
 ### Build and install from source
 
 ```bash

docs/handoffs/authoring-skill-release.md

@@ -11,9 +11,11 @@ Implemented shape:
 - The release workflow uploads and attests `dist/html-docs/SKILL.md` alongside runtime files.
 - README has an optional agent-skill note explaining discovery roots and the `smcllns/skills` mirror.
 - `/Users/smcllns/Projects/agent-skills/skills/obsidian-html-docs/SKILL.md` mirrors the canonical skill.
+- `smcllns/skills` PR #1 was merged first so README can point to the real `skills.sh` install URL.
 
 Important constraint:
 - Plugin runtime must not write to `~/.claude`, `~/.agents`, `~/.codex`, dotfiles, or any other agent install root. Agent skill activation belongs to the user's agent tooling, not the Obsidian plugin.
+- Merge order matters: public skills mirror first, then plugin docs/release work.
 
 Verification target:
 - `bun run build`