diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md
index ae21803..c7d82e5 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,7 +14,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands
---
-## Frontmatter Fields (14)
+## Frontmatter Fields (15)
| Field | Type | Required | Description |
|-------|------|----------|-------------|
@@ -22,6 +22,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| `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]`) |
+| `arguments` | string/list | No | Named positional arguments for `$name` substitution in command content. Accepts a space-separated string or YAML list — names map to argument positions in order |
| `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 |
| `paths` | string/list | No | Glob patterns that limit when this skill is activated. Accepts a comma-separated string or a YAML list. When set, Claude loads the skill automatically only when working with files matching the patterns |
@@ -53,17 +54,17 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| 12 | `/sandbox` |  | Toggle sandbox mode. Available on supported platforms only |
| 13 | `/statusline` |  | Configure Claude Code's status line. Describe what you want, or run without arguments to auto-configure from your shell prompt |
| 14 | `/stickers` |  | Order Claude Code stickers |
-| 15 | `/terminal-setup` |  | Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Alacritty, or Warp |
-| 16 | `/theme` |  | Change the color theme. Includes light and dark variants, colorblind-accessible (daltonized) themes, ANSI themes that use your terminal's color palette, and an "Auto (match terminal)" option that follows your terminal's light/dark mode |
+| 15 | `/terminal-setup` |  | Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Cursor, Windsurf, Alacritty, or Zed |
+| 16 | `/theme` |  | Change the color theme. Includes light and dark variants, colorblind-accessible (daltonized) themes, ANSI themes that use your terminal's color palette, an "Auto (match terminal)" option that follows your terminal's light/dark mode, and custom themes loaded from `~/.claude/themes/` or plugins. Select "New custom theme…" to create your own |
| 17 | `/tui [default\|fullscreen]` |  | Set the terminal UI renderer and relaunch Claude Code with the current conversation intact. `default` uses inline rendering; `fullscreen` uses an alt-screen TUI |
-| 18 | `/voice` |  | Toggle push-to-talk voice dictation. Requires a Claude.ai account |
+| 18 | `/voice [hold\|tap\|off]` |  | Toggle voice dictation, or enable it in a specific mode. Requires a Claude.ai account |
| 19 | `/context` |  | Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings |
-| 20 | `/cost` |  | Show token usage statistics. See cost tracking guide for subscription-specific details |
+| 20 | `/cost` |  | Alias for `/usage` |
| 21 | `/extra-usage` |  | Configure extra usage to keep working when rate limits are hit |
| 22 | `/insights` |  | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points |
-| 23 | `/stats` |  | Visualize daily usage, session history, streaks, and model preferences |
+| 23 | `/stats` |  | Alias for `/usage`. Opens on the Stats tab |
| 24 | `/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 |
-| 25 | `/usage` |  | Show plan usage limits and rate limit status |
+| 25 | `/usage` |  | Show session cost, plan usage limits, and activity stats. `/cost` and `/stats` are aliases |
| 26 | `/doctor` |  | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press `f` to have Claude fix any reported issues |
| 27 | `/feedback [report]` |  | Submit feedback about Claude Code. Alias: `/bug` |
| 28 | `/heapdump` |  | Write a JavaScript heap snapshot and memory breakdown to `~/Desktop` for diagnosing high memory usage. Useful when filing bug reports about memory growth |
@@ -82,7 +83,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| 41 | `/reload-plugins` |  | Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors |
| 42 | `/skills` |  | List available skills |
| 43 | `/memory` |  | Edit `CLAUDE.md` memory files, enable or disable auto-memory, and view auto-memory entries |
-| 44 | `/effort [low\|medium\|high\|xhigh\|max\|auto]` |  | Set the model effort level. Available levels depend on the model and include `low`, `medium`, `high`, `xhigh`, and `max`. Without an argument, opens an interactive slider to pick the level. `auto` resets to the model default. Takes effect immediately without waiting for the current response to finish |
+| 44 | `/effort [low\|medium\|high\|xhigh\|max\|auto]` |  | Set the model effort level. Available levels depend on the model and include `low`, `medium`, `high`, `xhigh`, and `max` (session-only). Without an argument, opens an interactive slider to pick the level. `auto` resets to the model default. Takes effect immediately without waiting for the current response to finish |
| 45 | `/fast [on\|off]` |  | Toggle fast mode on or off |
| 46 | `/model [model]` |  | Select or change the AI model. For models that support it, use left/right arrows to adjust effort level. The change takes effect immediately without waiting for the current response to finish. When switching mid-conversation after prior output, Claude warns before applying the change |
| 47 | `/passes` |  | Share a free week of Claude Code with friends. Only visible if your account is eligible |