repo-help

Codex form of the /repo:help command. Other commands appear as $repo-<verb> skills. Helper scripts and .claude/ paths below are relative to the repository root and exist when the Claude Code surface is installed alongside this one.

$repo-help — How to Use Repo Skills

Explain the repo skills installed in this repository. Introspect the actual install rather than assuming — installs can be filtered to a subset of commands.

Usage

$repo-help                     # Overview of all installed commands
$repo-help reset               # Detailed help for one command

Steps — no argument (overview)

1. Read the actual install

ls .claude/commands/repo/*.md
cat .claude/skills/repo/install-metadata.json
cat .claude/skills/repo/.install-local.json 2>/dev/null   # machine-local, gitignored

Build the command list from the files present. For each, pull the one-line description: from its frontmatter. Do not list commands that are not installed here.

install-metadata.json (tracked) carries version, commands, and dev. The install date lives in the gitignored .install-local.json sidecar (installed_at), so it is present only on the machine that ran the install; older installs still keep installed_at inline in install-metadata.json. Use whichever is present for the date below, and simply omit "(installed )" when neither has it (e.g. a fresh clone on another machine) — its absence is expected, not an error.

2. Present the overview

Structure it like this:

## Repo Skills v<version> (installed <date>)

General repository hygiene and environment tools. Commands **apply their
safe, reversible fixes by default** and report each change; add `--ask`
to review and confirm first. Irreversible removals (branches, worktrees,
stashes, untracked files) always need an explicit opt-in.

### Everyday
| Command | When to reach for it |
|---------|----------------------|
| $repo-reset | Done with a task — get back on main, synced, stale state reviewed |
| $repo-followups | End of session — file follow-on work surfaced this session as issues, here or in the right upstream tool repo |
| $repo-decide | Blocked on the operator — put the decision as ranked options (best to worst, each with why) they can answer with a number |
| $repo-handoff | Rolling the session (context full, CLI update) — preserve what only the session knows, then restart |
| $repo-tidy  | Working tree cluttered with build artifacts and temp files |
| $repo-remote | Need a cloud dev box (GCP/AWS) with this repo ready to go |
| $repo-browser | Set up or check browser automation (Browser Use CLI, agent skill, auth, cloud credits) — report-first, installs only on confirm |
| $repo-sudo | One-time machine setup — grant passwordless sudo (validated drop-in) so an agent over SSH isn't blocked on password prompts |
| $repo-release | Cut a release — pre-flight, semver, CHANGELOG, version bump, tag, GitHub Release. Supports per-project release policy via named phase-boundary seams in `.repo/release-policy.md` |

### Periodic maintenance
| $repo-all | The whole hygiene pass in order — audit, scrub, docs, tidy, update-tools, deps check, reset |
| $repo-audit | Monthly sweep, or after a big refactor/import |
| $repo-scrub | What does the public surface expose? Code, history, issues, PRs, forks — report-only |
| $repo-host-optimize | Prep/re-check a Mac (or Linux box) for heavy Loom/agent build use — Gatekeeper churn, backup-agent interference, build-tree bloat |
| $repo-update-tools | Keep Loom/Anvil/Repo Skills installs current |
| $repo-deps | Keep third-party deps current — reconcile organization policy, Dependabot-first setup (Renovate opt-in), and bot PRs |
| $repo-optimize-ci | CI slow or expensive — find unfiltered jobs, broken cache keys, superseded runs; ranked by measured minutes saved |
| $repo-org-policy | Preview/install canonical organization preferences from the current client repo |

### Focused checks
| $repo-docs | Documentation health — content, README structure, cross-refs |
| $repo-branches | ... |
| $repo-gitignore | ... |
| $repo-links | ... |
| $repo-orphans | ... |
| $repo-readme | ... |