docs: integrate gander-skill for AI coding agent workflow (#66)

* docs(readme): restructure for AI coding agent workflow

Lead with the agentic framing ("share markdown from your agent to your
browser in real time"), add a For AI coding agents section pointing at
gandermd/gander-skill, and reframe the Live-reload preview + Share on
gander.md sections around the agent-as-writer workflow.

* docs(man): link gander-skill in SEE ALSO

Add a SEE ALSO entry pointing at gandermd/gander-skill so 'man gander'
surfaces the agent-skill discovery path (OpenCode, Claude Code, Codex
CLI, Cursor, Grok Build, Windsurf, and any agent that loads SKILL.md
files).

* docs(agents): note gander-skill for agents working on gander

Add a 'Using gander from an agent' addendum pointing at gandermd/gander-skill
so an agent iterating on this repo can 'gander share --watch' a doc and
let the human read along, or persist the agent's plan via
scripts/save-plan.sh. Also expand the source-layout table to cover the
share/api/signup/etc files that have accumulated since the original
table was written.

Author: scott

AGENTS.md

@@ -20,12 +20,20 @@ self-updates from GitHub Releases.
   | `config.go`           | `~/.gander` JSON loader and defaults; honors `GANDER_CONFIG=<name>` to use `~/.gander.<name>` instead (full isolation from the prod profile, with path-traversal guard) |
   | `render.go`           | Markdown → HTML, page builder, CSS, TOC + reload JS      |
   | `watch.go`            | HTTP server, SSE hub, fsnotify watcher, debounced reload |
+  | `share.go`            | `gander share [--watch]` upload + push-to-gandermd loop  |
+  | `api.go`              | gandermd HTTP client (signup, share CRUD, manage intent) |
+  | `signup.go`/`auth.go`/`list.go`/`remove.go`/`manage.go` | gandermd account subcommands |
   | `upgrade.go`          | `--upgrade` self-update via GitHub Releases API          |
+  | `completion.go`       | `gander completion {bash\|zsh}`                          |
   | `*_test.go`           | Unit tests                                               |
   | `install.sh`          | Installer: downloads the latest release, source fallback |
   | `scripts/release.sh`  | Release automation (see below)                           |
   | `.github/workflows/`  | CI (currently just `release.yml`)                        |
 
+### Using gander from an agent
+
+When working on gander (or any project with a Markdown surface — design docs, plans, postmortems), install [`gandermd/gander-skill`](https://github.com/gandermd/gander-skill) so your agent can `gander share --watch` a file it's iterating on; the human opens the URL once and reads along without copy-pasting. The skill's `scripts/save-plan.sh` is also a clean way to persist this plan (and others) as markdown under `./plans/` and gander or share it before any code changes. See the `## For AI coding agents` section of `README.md` for the full pitch.
+
 ## Build, test, lint
 
 ```bash

README.md

@@ -1,6 +1,24 @@
-# gander — Markdown Preview
+# gander — share markdown from your agent to your browser in real time
 
-A simple CLI tool that renders a Markdown file in your web browser on macOS and Linux.
+Render a Markdown file locally with `gander <file>`, or push it to a shareable URL with `gander share <file> --watch` that updates in place on every save. Built so humans and agents can read and collaborate on markdown at the same time.
+
+## For AI coding agents
+
+`gander` solves the problem of `cat`-ing a markdown file just to see what your agent wrote — open a browser tab once and the page updates in place on every save. Two workflows cover most of what you'll do:
+
+1. **`gander share README.md --watch`** — upload to `gander.md` and get a short URL. Every save hot-swaps the rendered page in every connected viewer's browser, so you can read along while your agent iterates on a design doc without copy-pasting or refreshing.
+
+2. **[`gandermd/gander-skill`](https://github.com/gandermd/gander-skill)** — a `SKILL.md` that wires all of this into your agent runner (OpenCode, Claude Code, Codex CLI, Cursor, Grok Build, Windsurf, and any other agent that loads `SKILL.md` files), plus two helper scripts:
+   - `scripts/save-plan.sh` — pipe the agent's plan into `./plans/YYYY-MM-DD-<slug>.md`, then gander or share it.
+   - `scripts/watch-markdown.sh` — watch a directory for new `.md` files and prompt to gander each one.
+
+Install the skill with one command:
+
+```bash
+git clone https://github.com/gandermd/gander-skill && cd gander-skill && ./install.sh
+```
+
+That symlinks the skill into `~/.agents/skills/`, `~/.claude/skills/`, and `~/.cursor/skills/` so every supported agent picks it up automatically.
 
 ## Installation
 
@@ -122,17 +140,15 @@ gander -outfile readme.html README.md
 gander --watch README.md
 ```
 
-Opens the preview in your browser and watches the file for changes. Each save hot-swaps the rendered HTML in place and rebuilds the TOC — scroll position is preserved. Press `Ctrl+C` to stop.
+Especially handy when an agent is writing the file — open the preview once and watch it grow without leaving your browser. On every save the rendered HTML hot-swaps in place and the TOC rebuilds; scroll position is preserved. Press `Ctrl+C` to stop.
 
 A local HTTP server is started on a random free port (printed in the output) so the browser can receive change notifications over Server-Sent Events.
 
 > `--watch` and `-outfile` cannot be combined.
 
 ### Share on gander.md
 
-`gander.md` is the public hosting service for gander. Once you sign up,
-you can `share`, `list`, and `remove` markdown from your terminal — and
-viewers see the same live-reload preview you'd see locally.
+If you're running an agent that streams markdown to a file, `gander share --watch` is the shortest path from the agent's writes to your browser — open the URL once and every connected viewer sees the latest version in real time. `gander.md` is the public hosting service for gander. Once you sign up, you can `share`, `list`, and `remove` markdown from your terminal, and viewers see the same live-reload preview you'd see locally.
 
 ```bash
 gander signup --email you@example.com   # opens browser form, polls for API token

man/man1/gander.1

@@ -239,6 +239,12 @@ GANDER_CONFIG=dev gander signup \-\-email dev@example.com
 .SH "SEE ALSO"
 Project home page:
 .RI \(la https://github.com/gandermd/gander-cli \(ra.
+.IP
+The gander agent skill (\(lqgander-skill\(rq) for OpenCode, Claude Code,
+Codex CLI, Cursor, Grok Build, Windsurf, and any agent that loads
+.SB SKILL.md
+files:
+.RI \(la https://github.com/gandermd/gander-skill \(ra.
 .SH AUTHORS
 .B gander
 is developed at