From 5db47ea624068b9c8ba2558838b5aaac2a6034d1 Mon Sep 17 00:00:00 2001 From: Wyatt Johnson Date: Tue, 21 Apr 2026 09:47:45 -0600 Subject: [PATCH] docs(skill): document --all flag on clerk update The clerk update command supports --all (update every clerk install on PATH) but the bundled agent skill's command reference table omitted it, so agents couldn't surface the flag to users with multiple installs. --- .changeset/skill-document-update-all-flag.md | 5 +++++ skills/clerk/SKILL.md | 2 +- 2 files changed, 6 insertions(+), 1 deletion(-) create mode 100644 .changeset/skill-document-update-all-flag.md diff --git a/.changeset/skill-document-update-all-flag.md b/.changeset/skill-document-update-all-flag.md new file mode 100644 index 00000000..75e66ae3 --- /dev/null +++ b/.changeset/skill-document-update-all-flag.md @@ -0,0 +1,5 @@ +--- +"clerk": patch +--- + +Document the `--all` flag for `clerk update` in the bundled Clerk agent skill's command reference table. The flag was already implemented but missing from the skill, so agents couldn't help users with multiple clerk installs on PATH. diff --git a/skills/clerk/SKILL.md b/skills/clerk/SKILL.md index 0ce9f6f3..6e263358 100644 --- a/skills/clerk/SKILL.md +++ b/skills/clerk/SKILL.md @@ -138,7 +138,7 @@ See [references/recipes.md](references/recipes.md) for concrete patterns: listin | `clerk api [path]` | Authenticated HTTP to Backend/Platform API. | `-X`, `-d`, `--file`, `--dry-run`, `--yes`, `--include`, `--app`, `--secret-key`, `--instance`, `--platform` | | `clerk api ls [filter]` | Discover endpoints from the bundled OpenAPI catalog. | `--platform` | | `clerk completion [shell]` | Print a shell completion script (`bash`, `zsh`, `fish`, `powershell`). | — | -| `clerk update` | Update the CLI to the latest version. | `--channel`, `-y` | +| `clerk update` | Update the CLI to the latest version. | `--channel`, `-y`, `--all` | | `clerk skill install` | Reinstall the bundled `clerk` skill. Run after upgrading the CLI so the skill matches the new binary. | `-y`, `--pm` | **`clerk --help` is the source of truth for flags.** This table is a hint, not a spec. Before running an unfamiliar command or flag combination, run `clerk --help` once per session. Every command also defines `setExamples([...])` in source, which `--help` renders as a copy-pasteable Examples block, so you rarely need to guess syntax.