Agent skill
Works with the CLI alone. No gander.md account.
The Gander skill is a SKILL.md plus two helper scripts that your coding agent can load. It does not need a gander.md account. Its job is to teach the agent: when you save a plan as markdown, offer to preview or watch it.
Without the skill, you run gander yourself. With the skill, the agent can save ./plans/YYYY-MM-DD-slug.md and ask whether to gander it, or watch a directory for new .md files and prompt on each one.
gander skill
gander skill install is the same command. The recommended one-liner already runs this. Run it yourself after Homebrew or a source build, because those paths do not.
What it installs
The command downloads gandermd/gander-skill into ~/.gander/skill and symlinks that directory into the skill roots agents already search:
| Path | Picked up by |
|---|---|
~/.agents/skills/gander |
OpenCode, Codex CLI, and anything else that reads ~/.agents/skills/ |
~/.claude/skills/gander |
Claude Code, and Grok Build via Claude-compatible skill dirs |
~/.cursor/skills/gander |
Cursor |
~/.grok/skills/gander |
Grok Build |
You do not copy files per agent. One install covers the dests above. Many other agents also read ~/.agents/skills/ or ~/.claude/skills/. If yours does not, symlink ~/.gander/skill into that agent's skills directory. Step-by-step per agent: Use with your agent. Marketing pages for the featured agents live on Use with your agent.
Clone the skill repo only if you want to edit SKILL.md or the scripts and have the symlinks point at your checkout.
Bundled scripts
After install, the scripts live under ~/.gander/skill (and the dest symlinks). Agents call them. You can too.
Save an agent-produced plan as markdown, then offer to gander it:
cat plan.txt | scripts/save-plan.sh "Add token rotation"
scripts/save-plan.sh "Refactor share rendering" plan.md
PLAN_SOURCE=opencode scripts/save-plan.sh "Plan title here"
The file lands at ./plans/YYYY-MM-DD-<slug>.md with a title heading and a short metadata block. Override the directory with PLAN_DIR=/some/path.
Watch a directory for new .md files and prompt (y preview, s share, N skip):
scripts/watch-markdown.sh
scripts/watch-markdown.sh ~/projects/notes
scripts/watch-markdown.sh ~/notes --share
scripts/watch-markdown.sh ~/notes --background
scripts/watch-markdown.sh --stop
--share defaults each prompt to a hosted share (needs signup). --background daemonizes. --stop kills that watcher. The script needs gander on PATH, plus fswatch on macOS or inotifywait on Linux.
Skill vs MCP
These are different jobs. Install both for the full loop.
| Skill | MCP | |
|---|---|---|
| Command | gander skill |
gander mcp install |
| Account | not required | the install is local; listing @agent comments needs signup |
| Job | agent offers to gander a file it wrote | agent hears @agent comments without paste |
| When it runs | when the agent finishes a plan or sees a new .md |
after a gander, on a schedule or per-turn backoff |
See MCP. gander --upgrade refreshes ~/.gander/skill when the skill is already installed, and re-links the dests.