diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md
index 39bfc8d..9d70ab1 100644
--- a/best-practice/claude-commands.md
+++ b/best-practice/claude-commands.md
@@ -1,6 +1,6 @@
# Commands Best Practice
- 
+ 
[](../implementation/claude-commands-implementation.md)
Claude Code commands — frontmatter fields and official built-in slash commands.
@@ -14,12 +14,13 @@ Claude Code commands — frontmatter fields and official built-in slash commands
---
-## Frontmatter Fields (13)
+## Frontmatter Fields (14)
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | No | Display name and `/slash-command` identifier. Defaults to the directory name if omitted |
| `description` | string | Recommended | What the command does. Shown in autocomplete and used by Claude for auto-discovery |
+| `when_to_use` | string | No | Additional context for when Claude should invoke the skill — trigger phrases or example requests. Appended to `description` in the listing and counts toward the 1,536-character cap |
| `argument-hint` | string | No | Hint shown during autocomplete (e.g., `[issue-number]`, `[filename]`) |
| `disable-model-invocation` | boolean | No | Set `true` to prevent Claude from automatically invoking this command |
| `user-invocable` | boolean | No | Set `false` to hide from the `/` menu — command becomes background knowledge only |
@@ -34,7 +35,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands
---
-##  **(69)**
+##  **(70)**
| # | Command | Tag | Description |
|---|---------|-----|-------------|
@@ -61,7 +62,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| 21 | `/stats` |  | Visualize daily usage, session history, streaks, and model preferences |
| 22 | `/status` |  | Open the Settings interface (Status tab) showing version, model, account, and connectivity. Works while Claude is responding, without waiting for the current response to finish |
| 23 | `/usage` |  | Show plan usage limits and rate limit status |
-| 24 | `/doctor` |  | Diagnose and verify your Claude Code installation and settings |
+| 24 | `/doctor` |  | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press `f` to have Claude fix any reported issues |
| 25 | `/feedback [report]` |  | Submit feedback about Claude Code. Alias: `/bug` |
| 26 | `/help` |  | Show help and available commands |
| 27 | `/powerup` |  | Discover Claude Code features through quick interactive lessons with animated demos |
@@ -89,24 +90,25 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| 49 | `/init` |  | Initialize project with a `CLAUDE.md` guide. Set `CLAUDE_CODE_NEW_INIT=1` for an interactive flow that also walks through skills, hooks, and personal memory files |
| 50 | `/review` |  | Deprecated. Install the `code-review` plugin instead: `claude plugin install code-review@claude-plugins-official` |
| 51 | `/security-review` |  | Analyze pending changes on the current branch for security vulnerabilities. Reviews the git diff and identifies risks like injection, auth issues, and data exposure |
-| 52 | `/autofix-pr [prompt]` |  | Spawn a Claude Code on the web session that watches the current branch's PR and pushes fixes when CI fails or reviewers leave comments. Detects the open PR from your checked-out branch with `gh pr view`; to watch a different PR, check out its branch first. Requires the `gh` CLI and access to Claude Code on the web |
-| 53 | `/desktop` |  | Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: `/app` |
-| 54 | `/install-github-app` |  | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration |
-| 55 | `/install-slack-app` |  | Install the Claude Slack app. Opens a browser to complete the OAuth flow |
-| 56 | `/mobile` |  | Show QR code to download the Claude mobile app. Aliases: `/ios`, `/android` |
-| 57 | `/remote-control` |  | Make this session available for remote control from claude.ai. Alias: `/rc` |
-| 58 | `/remote-env` |  | Configure the default remote environment for web sessions started with `--remote` |
-| 59 | `/schedule [description]` |  | Create, update, list, or run Cloud scheduled tasks. Claude walks you through the setup conversationally |
-| 60 | `/teleport` |  | Pull a Claude Code on the web session into this terminal: opens a picker, then fetches the branch and conversation. Also available as `/tp`. Requires a claude.ai subscription |
-| 61 | `/web-setup` |  | Connect your GitHub account to Claude Code on the web using your local `gh` CLI credentials. `/schedule` prompts for this automatically if GitHub is not connected |
-| 62 | `/branch [name]` |  | Create a branch of the current conversation at this point. Alias: `/fork` |
-| 63 | `/btw ` |  | Ask a quick side question without adding to the conversation |
-| 64 | `/clear` |  | Clear conversation history and free up context. Aliases: `/reset`, `/new` |
-| 65 | `/compact [instructions]` |  | Compact conversation with optional focus instructions |
-| 66 | `/exit` |  | Exit the CLI. Alias: `/quit` |
-| 67 | `/rename [name]` |  | Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history |
-| 68 | `/resume [session]` |  | Resume a conversation by ID or name, or open the session picker. Alias: `/continue` |
-| 69 | `/rewind` |  | Rewind the conversation and/or code to a previous point, or summarize from a selected message. See checkpointing. Alias: `/checkpoint` |
+| 52 | `/team-onboarding` |  | Generate a team onboarding guide from your Claude Code usage history. Analyzes sessions, commands, and MCP server usage from the past 30 days |
+| 53 | `/autofix-pr [prompt]` |  | Spawn a Claude Code on the web session that watches the current branch's PR and pushes fixes when CI fails or reviewers leave comments. Detects the open PR from your checked-out branch with `gh pr view`; to watch a different PR, check out its branch first. Requires the `gh` CLI and access to Claude Code on the web |
+| 54 | `/desktop` |  | Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: `/app` |
+| 55 | `/install-github-app` |  | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration |
+| 56 | `/install-slack-app` |  | Install the Claude Slack app. Opens a browser to complete the OAuth flow |
+| 57 | `/mobile` |  | Show QR code to download the Claude mobile app. Aliases: `/ios`, `/android` |
+| 58 | `/remote-control` |  | Make this session available for remote control from claude.ai. Alias: `/rc` |
+| 59 | `/remote-env` |  | Configure the default remote environment for web sessions started with `--remote` |
+| 60 | `/schedule [description]` |  | Create, update, list, or run routines. Claude walks you through the setup conversationally |
+| 61 | `/teleport` |  | Pull a Claude Code on the web session into this terminal: opens a picker, then fetches the branch and conversation. Also available as `/tp`. Requires a claude.ai subscription |
+| 62 | `/web-setup` |  | Connect your GitHub account to Claude Code on the web using your local `gh` CLI credentials. `/schedule` prompts for this automatically if GitHub is not connected |
+| 63 | `/branch [name]` |  | Create a branch of the current conversation at this point. Alias: `/fork` |
+| 64 | `/btw ` |  | Ask a quick side question without adding to the conversation |
+| 65 | `/clear` |  | Clear conversation history and free up context. Aliases: `/reset`, `/new` |
+| 66 | `/compact [instructions]` |  | Compact conversation with optional focus instructions |
+| 67 | `/exit` |  | Exit the CLI. Alias: `/quit` |
+| 68 | `/rename [name]` |  | Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history |
+| 69 | `/resume [session]` |  | Resume a conversation by ID or name, or open the session picker. Alias: `/continue` |
+| 70 | `/rewind` |  | Rewind the conversation and/or code to a previous point, or summarize from a selected message. See checkpointing. Alias: `/checkpoint` |
Bundled skills such as `/debug` can also appear in the slash-command menu, but they are not built-in commands.