// Audit all documentation for staleness after code changes. Checks README, CLAUDE.md, init presets, and release docs. Use after completing a feature, merging a PR, or when asked to check docs.
Manage dev ports with Outport. Use when setting up a new project, adding services, resolving port conflicts, configuring monorepo cross-service URLs, or working with worktrees and multiple instances. Triggers on "outport", "port conflict", "port allocation", "dev ports", "outport.yml", "port management", "env var ports", "computed values", "cross-service URLs", "CORS origins from ports", ".test domains", "local DNS", "reverse proxy", "cookie isolation", "tunnel", "share localhost", "public URL", "cloudflare tunnel", "outport doctor", "health check", "diagnose outport", "QR code", "mobile access", "phone testing", "LAN IP", "hostname aliases", "multiple hostnames", "subdomain routing". Also use when the user mentions running multiple instances of a project, worktree port setup, or when services need to discover each other's URLs.
Release a new version of outport. Use when the user says "release", "let's release", "tag a release", "ship it", "cut a release", "push a new version", or asks about the release process. Also use when the user asks to deploy docs after a release.
| name | update-docs |
| description | Audit all documentation for staleness after code changes. Checks README, CLAUDE.md, init presets, and release docs. Use after completing a feature, merging a PR, or when asked to check docs. |
Run this after any meaningful change to the codebase. It checks every documentation location, determines what's stale, and updates it.
# Changes on the current branch vs master
git log --oneline master..HEAD
git diff --stat master..HEAD
# Or if working on master, recent commits
git log --oneline -10
Summarize the changes in one sentence. Classify:
| Type | Example |
|---|---|
| New command | Added outport open |
| Command change | New flag, changed output format |
| Config change | New field in outport.yml |
| Infrastructure | Build, CI, dependency changes |
| Bug fix | Fixed registry save race condition |
Go through every location below. For each one, check whether it's current.
| Check | What to look for |
|---|---|
| Commands list | Does it match actual commands in cmd/*.go? |
| Config example | Does outport.yml example match current schema? |
| "How It Works" section | Does it reflect current allocation behavior? |
| Install instructions | Are they still accurate? |
| Check | What to look for |
|---|---|
| Architecture section | Do package descriptions match current code? |
| CLI commands list | Does it include all commands in cmd/*.go? |
| Key design decisions | Do they reflect current behavior? |
| Development commands | Does the justfile have new/changed recipes? |
| Check | What to look for |
|---|---|
| Service presets | Does the presets slice include all standard services? |
| Preset fields | Do presets use the current config field names? |
| Check | What to look for |
|---|---|
| Build targets | Do platforms match what's documented? |
| Homebrew formula | Is the tap config current? |
| Check | What to look for |
|---|---|
docs/reference/commands.md | Does it list all commands in cmd/*.go? |
docs/reference/configuration.md | Does it cover all outport.yml fields? |
docs/guide/getting-started.md | Does it reflect current workflow? |
docs/guide/examples.md | Are examples using current config syntax? |
docs/guide/tips.md | Are troubleshooting tips still accurate? |
This is the Outport skill that users download and install in their own projects. It lives at skills/outport/SKILL.md in the repo root — not in .claude/skills/ which is for Claude Code's internal skills.
| Check | What to look for |
|---|---|
| Quick Reference commands | Does it list all commands? |
| Common Tasks section | Does it cover current capabilities? |
| Trigger keywords | Do they cover all features? |
Present as a table, only showing items that need attention:
| Status | File | What needs updating |
|--------|------|---------------------|
| STALE | README.md | Commands list missing `open` |
| OK | CLAUDE.md | — |
For each STALE item, update the file. Rules:
| Change type | Always update | Check if needed |
|---|---|---|
| New command | README commands, CLAUDE.md commands, docs/reference/commands.md, skills/outport/SKILL.md | init presets, docs/guide/getting-started.md, docs/guide/tips.md |
| Config schema change | README config example, CLAUDE.md config description, docs/reference/configuration.md | init presets, docs/guide/examples.md |
| New convention | CLAUDE.md | — |
| Infrastructure | — | CLAUDE.md dev commands |
| Bug fix | — | README (if workaround documented), docs/guide/tips.md |