imhcode 1.0.0

package/skills/best-practice/claude-cli-startup-flags.md

@@ -0,0 +1,231 @@
+# CLI Startup Flags Best Practice
+
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2002%2C%202026-white?style=flat&labelColor=555)
+
+Reference for Claude Code startup flags, top-level subcommands, and startup environment variables when launching Claude Code from the terminal.
+
+<table width="100%">
+<tr>
+<td><a href="../">← Back to Claude Code Best Practice</a></td>
+<td align="right"><img src="../!/claude-jumping.svg" alt="Claude" width="60" /></td>
+</tr>
+</table>
+
+---
+
+## Table of Contents
+
+1. [Session Management](#session-management)
+2. [Model & Configuration](#model--configuration)
+3. [Permissions & Security](#permissions--security)
+4. [Output & Format](#output--format)
+5. [System Prompt](#system-prompt)
+6. [Agent & Subagent](#agent--subagent)
+7. [MCP & Plugins](#mcp--plugins)
+8. [Directory & Workspace](#directory--workspace)
+9. [Budget & Limits](#budget--limits)
+10. [Integration](#integration)
+11. [Initialization & Maintenance](#initialization--maintenance)
+12. [Debug & Diagnostics](#debug--diagnostics)
+13. [Settings Override](#settings-override)
+14. [Version & Help](#version--help)
+15. [Subcommands](#subcommands)
+16. [Environment Variables](#environment-variables)
+
+---
+
+## Session Management
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--continue` | `-c` | Continue the most recent conversation in the current directory |
+| `--resume` | `-r` | Resume a specific session by ID or name, or show interactive picker |
+| `--from-pr <NUMBER\|URL>` | | Resume sessions linked to a specific GitHub PR |
+| `--fork-session` | | Create a new session ID when resuming (use with `--resume` or `--continue`) |
+| `--session-id <UUID>` | | Use a specific session ID (must be valid UUID) |
+| `--no-session-persistence` | | Disable session persistence (print mode only) |
+| `--remote` | | Create a new web session on claude.ai |
+| `--teleport` | | Resume a web session in your local terminal |
+
+---
+
+## Model & Configuration
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--model <NAME>` | | Set model with alias (`sonnet`, `opus`, `haiku`) or full model ID |
+| `--fallback-model <NAME>` | | Auto-fallback model when default is overloaded (print mode only) |
+| `--betas <LIST>` | | Beta headers to include in API requests (API key users only) |
+
+---
+
+## Permissions & Security
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--dangerously-skip-permissions` | | Skip ALL permission prompts. Use with extreme caution |
+| `--allow-dangerously-skip-permissions` | | Enable permission bypassing as an option without activating it |
+| `--permission-mode <MODE>` | | Begin in specified permission mode: `default`, `plan`, `acceptEdits`, `bypassPermissions` |
+| `--allowedTools <TOOLS>` | | Tools that execute without prompting (permission rule syntax) |
+| `--disallowedTools <TOOLS>` | | Tools removed from model context entirely |
+| `--tools <TOOLS>` | | Restrict which built-in tools Claude can use (use `""` to disable all) |
+| `--permission-prompt-tool <TOOL>` | | Specify MCP tool to handle permission prompts in non-interactive mode |
+
+---
+
+## Output & Format
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--print` | `-p` | Print response without interactive mode (headless/SDK mode) |
+| `--output-format <FORMAT>` | | Output format: `text`, `json`, `stream-json` |
+| `--input-format <FORMAT>` | | Input format: `text`, `stream-json` |
+| `--json-schema <SCHEMA>` | | Get validated JSON matching schema (print mode only) |
+| `--include-partial-messages` | | Include partial streaming events (requires `--print` and `--output-format=stream-json`) |
+| `--verbose` | | Enable verbose logging with full turn-by-turn output |
+
+---
+
+## System Prompt
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--system-prompt <TEXT>` | | Replace entire system prompt with custom text |
+| `--system-prompt-file <PATH>` | | Load system prompt from file, replacing default (print mode only) |
+| `--append-system-prompt <TEXT>` | | Append custom text to default system prompt |
+| `--append-system-prompt-file <PATH>` | | Append file contents to default prompt (print mode only) |
+
+---
+
+## Agent & Subagent
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--agent <NAME>` | | Specify an agent for the current session |
+| `--agents <JSON>` | | Define custom subagents dynamically via JSON |
+| `--teammate-mode <MODE>` | | Set agent team display: `auto`, `in-process`, `tmux` |
+
+---
+
+## MCP & Plugins
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--mcp-config <PATH\|JSON>` | | Load MCP servers from JSON file or string |
+| `--strict-mcp-config` | | Only use MCP servers from `--mcp-config`, ignore all others |
+| `--plugin-dir <PATH>` | | Load plugins from directory for this session only (repeatable) |
+
+---
+
+## Directory & Workspace
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--add-dir <PATH>` | | Add additional working directories for Claude to access |
+| `--worktree` | `-w` | Start Claude in an isolated git worktree (branched from HEAD) |
+
+---
+
+## Budget & Limits
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--max-budget-usd <AMOUNT>` | | Maximum dollar amount for API calls before stopping (print mode only) |
+| `--max-turns <NUMBER>` | | Limit number of agentic turns (print mode only) |
+
+---
+
+## Integration
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--chrome` | | Enable Chrome browser integration for web automation |
+| `--no-chrome` | | Disable Chrome browser integration for this session |
+| `--ide` | | Automatically connect to IDE on startup if exactly one valid IDE available |
+
+---
+
+## Initialization & Maintenance
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--init` | | Run initialization hooks and start interactive mode |
+| `--init-only` | | Run initialization hooks and exit (no interactive session) |
+| `--maintenance` | | Run maintenance hooks and exit |
+
+---
+
+## Debug & Diagnostics
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--debug <CATEGORIES>` | | Enable debug mode with optional category filtering (e.g., `"api,hooks"`) |
+
+---
+
+## Settings Override
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--settings <PATH\|JSON>` | | Path to settings JSON file or JSON string to load |
+| `--setting-sources <LIST>` | | Comma-separated list of sources to load: `user`, `project`, `local` |
+| `--disable-slash-commands` | | Disable all skills and slash commands for this session |
+
+---
+
+## Version & Help
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--version` | `-v` | Output the version number |
+| `--help` | `-h` | Show help information |
+
+---
+
+## Subcommands
+
+These are top-level commands run as `claude <subcommand>`:
+
+| Subcommand | Description |
+|------------|-------------|
+| `claude` | Start interactive REPL |
+| `claude "query"` | Start REPL with initial prompt |
+| `claude agents` | List configured agents |
+| `claude auth` | Manage Claude Code authentication |
+| `claude doctor` | Run diagnostics from the command line |
+| `claude install` | Install or switch Claude Code native builds |
+| `claude mcp` | Configure MCP servers (`add`, `remove`, `list`, `get`, `enable`) |
+| `claude plugin` | Manage Claude Code plugins |
+| `claude remote-control` | Manage remote control sessions |
+| `claude setup-token` | Create a long-lived token for subscription usage |
+| `claude update` / `claude upgrade` | Update to the latest version |
+
+---
+
+## Environment Variables
+
+These startup-only environment variables are set in your shell before launching Claude Code (they cannot be configured via `settings.json`):
+
+| Variable | Description |
+|----------|-------------|
+| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | Enable experimental agent teams |
+| `CLAUDE_CODE_TMPDIR` | Override temp directory for internal files. Also configurable via `env` key — see [Settings Reference](./claude-settings.md#environment-variables-via-env) |
+| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` | Enable additional directory CLAUDE.md loading |
+| `DISABLE_AUTOUPDATER=1` | Disable auto-updates. Also configurable via `env` key — see [Settings Reference](./claude-settings.md#environment-variables-via-env) |
+| `CLAUDE_CODE_EFFORT_LEVEL` | Control thinking depth — see [Settings Reference](./claude-settings.md#environment-variables-via-env) |
+| `USE_BUILTIN_RIPGREP=0` | Use system ripgrep instead of built-in (Alpine Linux) |
+| `CLAUDE_CODE_SIMPLE` | Enable simple mode (Bash + Edit tools only). Also configurable via `env` key — see [Settings Reference](./claude-settings.md#environment-variables-via-env) |
+| `CLAUDE_BASH_NO_LOGIN=1` | Skip login shell for BashTool |
+| `CCR_FORCE_BUNDLE=1` | Force bundling/uploading local repository when using `claude --remote`. Also configurable via `env` key — see [Settings Reference](./claude-settings.md#environment-variables-via-env) |
+
+For environment variables configurable via the `"env"` key in `settings.json` (including `MAX_THINKING_TOKENS`, `CLAUDE_CODE_SHELL`, `CLAUDE_CODE_ENABLE_TASKS`, `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`, `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`, and more), see the [Claude Settings Reference](./claude-settings.md#environment-variables-via-env).
+
+---
+
+## Sources
+
+- [Claude Code CLI Reference](https://code.claude.com/docs/en/cli-reference)
+- [Claude Code Headless Mode](https://code.claude.com/docs/en/headless)
+- [Claude Code Setup](https://code.claude.com/docs/en/setup)
+- [Claude Code CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
+- [Claude Code Common Workflows](https://code.claude.com/docs/en/common-workflows)

package/skills/best-practice/claude-commands.md

@@ -0,0 +1,132 @@
+# Commands Best Practice
+
+![Last Updated](https://img.shields.io/badge/Last_Updated-May%2012%2C%202026%2011%3A39%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.139-blue?style=flat&labelColor=555)<br>
+[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-commands-implementation.md)
+
+Claude Code commands — frontmatter fields and official built-in slash commands.
+
+<table width="100%">
+<tr>
+<td><a href="../">← Back to Claude Code Best Practice</a></td>
+<td align="right"><img src="../!/claude-jumping.svg" alt="Claude" width="60" /></td>
+</tr>
+</table>
+
+---
+
+## Frontmatter Fields (15)
+
+| 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]`) |
+| `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 |
+| `allowed-tools` | string | No | Tools allowed without permission prompts when this command is active |
+| `model` | string | No | Model to use when this command runs (e.g., `haiku`, `sonnet`, `opus`) |
+| `effort` | string | No | Override the model effort level when invoked (`low`, `medium`, `high`, `max`) |
+| `context` | string | No | Set to `fork` to run the command in an isolated subagent context |
+| `agent` | string | No | Subagent type when `context: fork` is set (default: `general-purpose`) |
+| `shell` | string | No | Shell for `` !`command` `` blocks — accepts `bash` (default) or `powershell`. Requires `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` |
+| `hooks` | object | No | Lifecycle hooks scoped to this command |
+
+---
+
+## ![Official](../!/tags/official.svg) **(80)**
+
+| # | Command | Tag | Description |
+|---|---------|-----|-------------|
+| 1 | `/login` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Sign in to your Anthropic account |
+| 2 | `/logout` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Sign out from your Anthropic account |
+| 3 | `/setup-bedrock` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Configure Amazon Bedrock authentication, region, and model pins through an interactive wizard. Only visible when `CLAUDE_CODE_USE_BEDROCK=1` is set. First-time Bedrock users can also access this wizard from the login screen |
+| 4 | `/setup-vertex` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Configure Google Vertex AI authentication, project, region, and model pins through an interactive wizard. Only visible when `CLAUDE_CODE_USE_VERTEX=1` is set. First-time Vertex AI users can also access this wizard from the login screen |
+| 5 | `/upgrade` | ![Auth](https://img.shields.io/badge/Auth-2980B9?style=flat) | Open the upgrade page to switch to a higher plan tier |
+| 6 | `/color [color\|default]` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Set the prompt bar color for the current session. Available colors: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Use `default` to reset |
+| 7 | `/config` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Open the Settings interface to adjust theme, model, output style, and other preferences. Alias: `/settings` |
+| 8 | `/focus` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Toggle the focus view, which shows only the last prompt, a summary of tool calls, and the final response. Useful for reducing visual noise during long sessions. Only available in fullscreen rendering |
+| 9 | `/keybindings` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Open or create your keybindings configuration file |
+| 10 | `/permissions` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Manage allow, ask, and deny rules for tool permissions. Opens an interactive dialog where you can view rules by scope, add or remove rules, manage working directories, and review recent auto mode denials. Alias: `/allowed-tools` |
+| 11 | `/privacy-settings` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | View and update your privacy settings. Only available for Pro and Max plan subscribers |
+| 12 | `/radio` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Open Claude FM lo-fi radio in your browser |
+| 13 | `/sandbox` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Toggle sandbox mode. Available on supported platforms only |
+| 14 | `/scroll-speed` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Adjust mouse wheel scroll speed interactively |
+| 15 | `/statusline` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Configure Claude Code's status line. Describe what you want, or run without arguments to auto-configure from your shell prompt |
+| 16 | `/stickers` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Order Claude Code stickers |
+| 17 | `/terminal-setup` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Cursor, Windsurf, Alacritty, or Zed |
+| 18 | `/theme` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | 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 |
+| 19 | `/tui [default\|fullscreen]` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Set the terminal UI renderer and relaunch Claude Code with the current conversation intact. `default` uses inline rendering; `fullscreen` uses an alt-screen TUI |
+| 20 | `/voice [hold\|tap\|off]` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Toggle voice dictation, or enable it in a specific mode. Requires a Claude.ai account |
+| 21 | `/context` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings |
+| 22 | `/cost` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Alias for `/usage` |
+| 23 | `/extra-usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Configure extra usage to keep working when rate limits are hit |
+| 24 | `/insights` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points |
+| 25 | `/stats` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Alias for `/usage`. Opens on the Stats tab |
+| 26 | `/status` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | 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 |
+| 27 | `/usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show session cost, plan usage limits, and activity stats. `/cost` and `/stats` are aliases |
+| 28 | `/doctor` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press `f` to have Claude fix any reported issues |
+| 29 | `/feedback [report]` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Submit feedback about Claude Code. Alias: `/bug` |
+| 30 | `/heapdump` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Write a JavaScript heap snapshot and memory breakdown to `~/Desktop` for diagnosing high memory usage. Useful when filing bug reports about memory growth |
+| 31 | `/help` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Show help and available commands |
+| 32 | `/powerup` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Discover Claude Code features through quick interactive lessons with animated demos |
+| 33 | `/release-notes` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | View the changelog in an interactive version picker. Select a specific version to see its release notes, or choose to show all versions |
+| 34 | `/tasks` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | List and manage background tasks. Alias: `/bashes` |
+| 35 | `/copy [N]` | ![Export](https://img.shields.io/badge/Export-7F8C8D?style=flat) | Copy the last assistant response to clipboard. Pass a number `N` to copy the Nth-latest response: `/copy 2` copies the second-to-last. When code blocks are present, shows an interactive picker to select individual blocks or the full response. Press `w` in the picker to write the selection to a file instead of the clipboard, which is useful over SSH |
+| 36 | `/export [filename]` | ![Export](https://img.shields.io/badge/Export-7F8C8D?style=flat) | Export the current conversation as plain text. With a filename, writes directly to that file. Without, opens a dialog to copy to clipboard or save to a file |
+| 37 | `/agents` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage agent configurations |
+| 38 | `/chrome` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Configure Claude in Chrome settings |
+| 39 | `/hooks` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | View hook configurations for tool events |
+| 40 | `/ide` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage IDE integrations and show status |
+| 41 | `/mcp` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage MCP server connections and OAuth authentication |
+| 42 | `/plugin` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage Claude Code plugins |
+| 43 | `/reload-plugins` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors |
+| 44 | `/skills` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | List available skills. Press `t` to sort by token count |
+| 45 | `/memory` | ![Memory](https://img.shields.io/badge/Memory-3498DB?style=flat) | Edit `CLAUDE.md` memory files, enable or disable auto-memory, and view auto-memory entries |
+| 46 | `/effort [low\|medium\|high\|xhigh\|max\|auto]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | 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 |
+| 47 | `/fast [on\|off]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Toggle fast mode on or off |
+| 48 | `/model [model]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | 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 |
+| 49 | `/passes` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Share a free week of Claude Code with friends. Only visible if your account is eligible |
+| 50 | `/plan [description]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Enter plan mode directly from the prompt. Pass an optional description to enter plan mode and immediately start with that task, for example `/plan fix the auth bug` |
+| 51 | `/ultraplan <prompt>` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Draft a plan in an ultraplan session, review it in your browser, then execute remotely or send it back to your terminal |
+| 52 | `/add-dir <path>` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Add a working directory for file access during the current session. Most `.claude/` configuration is not discovered from the added directory |
+| 53 | `/diff` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use left/right arrows to switch between the current git diff and individual Claude turns, and up/down to browse files |
+| 54 | `/init` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | 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 |
+| 55 | `/review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review a pull request locally in your current session. For a deeper cloud-based review, see `/ultrareview` |
+| 56 | `/security-review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Analyze pending changes on the current branch for security vulnerabilities. Reviews the git diff and identifies risks like injection, auth issues, and data exposure |
+| 57 | `/team-onboarding` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Generate a team onboarding guide from your Claude Code usage history. Analyzes sessions, commands, and MCP server usage from the past 30 days |
+| 58 | `/ultrareview [PR]` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Run a deep, multi-agent code review of the given pull request in a cloud sandbox. Produces a structured review with prioritized findings; complements the local `/review` command |
+| 59 | `/autofix-pr [prompt]` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | 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 |
+| 60 | `/desktop` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: `/app` |
+| 61 | `/install-github-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration |
+| 62 | `/install-slack-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Install the Claude Slack app. Opens a browser to complete the OAuth flow |
+| 63 | `/mobile` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Show QR code to download the Claude mobile app. Aliases: `/ios`, `/android` |
+| 64 | `/remote-control` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Make this session available for remote control from claude.ai. Alias: `/rc` |
+| 65 | `/remote-env` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Configure the default remote environment for web sessions started with `--remote` |
+| 66 | `/schedule [description]` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Create, update, list, or run routines. Claude walks you through the setup conversationally. Alias: `/routines` |
+| 67 | `/teleport` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | 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 |
+| 68 | `/web-setup` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | 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 |
+| 69 | `/background [prompt]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Detach the current session to run as a background agent and free this terminal. Alias: `/bg` |
+| 70 | `/branch [name]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Create a branch of the current conversation at this point. Alias: `/fork`. When `CLAUDE_CODE_FORK_SUBAGENT` is set, `/fork` instead spawns a forked subagent and is no longer an alias for this command |
+| 71 | `/btw <question>` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Ask a quick side question without adding to the conversation |
+| 72 | `/clear` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Start a new conversation with empty context. The previous conversation stays available in `/resume`. To free up context while continuing the same conversation, use `/compact` instead. Aliases: `/reset`, `/new` |
+| 73 | `/compact [instructions]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Compact conversation with optional focus instructions |
+| 74 | `/exit` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Exit the CLI. Alias: `/quit` |
+| 75 | `/goal [condition\|clear]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Set a goal — Claude keeps working across turns until the condition is met. Pass `clear` to remove an existing goal |
+| 76 | `/recap` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Generate a one-line summary of the current session on demand, without affecting the ongoing conversation |
+| 77 | `/rename [name]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history |
+| 78 | `/resume [session]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Resume a conversation by ID or name, or open the session picker. Alias: `/continue` |
+| 79 | `/rewind` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rewind the conversation and/or code to a previous point, or summarize from a selected message. See checkpointing. Alias: `/checkpoint`, `/undo` |
+| 80 | `/stop` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Stop the current background session. The transcript and worktree are kept |
+
+Bundled skills such as `/debug` can also appear in the slash-command menu, but they are not built-in commands.
+
+---
+
+## Sources
+
+- [Claude Code Slash Commands](https://code.claude.com/docs/en/slash-commands)
+- [Claude Code Interactive Mode](https://code.claude.com/docs/en/interactive-mode)
+- [Claude Code CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)

package/skills/best-practice/claude-mcp.md

@@ -0,0 +1,132 @@
+# MCP Servers Best Practice
+
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2002%2C%202026%2012%3A30%20PM%20PKT-white?style=flat&labelColor=555)<br>
+[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../.mcp.json)
+
+MCP (Model Context Protocol) servers extend Claude Code with connections to external tools, databases, and APIs. This guide covers recommended servers for daily use and configuration best practices.
+
+<table width="100%">
+<tr>
+<td><a href="../">← Back to Claude Code Best Practice</a></td>
+<td align="right"><img src="../!/claude-jumping.svg" alt="Claude" width="60" /></td>
+</tr>
+</table>
+
+---
+
+## MCP Servers for Daily Use
+
+> *"Went overboard with 15 MCP servers thinking more = better. Ended up using only 4 daily."* — [r/mcp](https://reddit.com/r/mcp/comments/1mj0fxs/) (682 upvotes)
+
+| MCP Server | What It Does | Resources |
+|------------|-------------|-----------|
+| [**Context7**](https://github.com/upstash/context7) | Fetches up-to-date library docs into context. Prevents hallucinated APIs from outdated training data | [Reddit: "by far the best MCP for coding"](https://reddit.com/r/mcp/comments/1qarjqm/) · [npm](https://www.npmjs.com/package/@upstash/context7-mcp) |
+| [**Playwright**](https://github.com/microsoft/playwright-mcp) | Browser automation — implement, test, and verify UI features autonomously. Screenshots, navigation, form testing | [Reddit: essential for frontend](https://reddit.com/r/mcp/comments/1m59pk0/) · [Docs](https://playwright.dev/) |
+| [**Claude in Chrome**](https://github.com/nicobailon/claude-code-in-chrome-mcp) | Connects Claude to your real Chrome browser — inspect console, network, DOM. Debug what users actually see | [Reddit: "game changer" for debugging](https://reddit.com/r/mcp/comments/1qarjqm/5_mcps_that_have_genuinely_made_me_10x_faster/nza0i7t/) · [Comparison Report](../reports/claude-in-chrome-v-chrome-devtools-mcp.md) |
+| [**DeepWiki**](https://github.com/devanshusemwal/deepwiki-mcp) | Fetches structured wiki-style documentation for any GitHub repo — architecture, API surface, relationships | [Reddit: "put it behind a gateway with Context7"](https://reddit.com/r/mcp/comments/1qarjqm/) |
+| [**Excalidraw**](https://github.com/antonpk1/excalidraw-mcp-app) | Generate architecture diagrams, flowcharts, and system designs as hand-drawn Excalidraw sketches from prompts | [GitHub](https://github.com/antonpk1/excalidraw-mcp-app) |
+
+Research (Context7/DeepWiki) -> Debug (Playwright/Chrome) -> Document (Excalidraw)
+
+---
+
+## Configuration
+
+MCP servers are configured in `.mcp.json` at the project root (project-scoped) or in `~/.claude.json` (user-scoped).
+
+### Server Types
+
+| Type | Transport | Example |
+|------|-----------|---------|
+| **stdio** | Spawns a local process | `npx`, `python`, binary |
+| **http** | Connects to a remote URL | HTTP/SSE endpoint |
+
+### Example `.mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp"]
+    },
+    "deepwiki": {
+      "command": "npx",
+      "args": ["-y", "deepwiki-mcp"]
+    },
+    "remote-api": {
+      "type": "http",
+      "url": "https://mcp.example.com/mcp"
+    }
+  }
+}
+```
+
+Use environment variable expansion for secrets instead of committing API keys in `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "remote-api": {
+      "type": "http",
+      "url": "https://mcp.example.com/mcp?token=${MCP_API_TOKEN}"
+    }
+  }
+}
+```
+
+### Settings for MCP Servers
+
+These settings in `.claude/settings.json` control MCP server approval:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `enableAllProjectMcpServers` | boolean | Auto-approve all `.mcp.json` servers without prompting |
+| `enabledMcpjsonServers` | array | Allowlist of specific server names to auto-approve |
+| `disabledMcpjsonServers` | array | Blocklist of specific server names to reject |
+
+### Permission Rules for MCP Tools
+
+MCP tools follow the `mcp__<server>__<tool>` naming convention in permission rules:
+
+```json
+{
+  "permissions": {
+    "allow": [
+      "mcp__*",
+      "mcp__context7__*",
+      "mcp__playwright__browser_snapshot"
+    ],
+    "deny": [
+      "mcp__dangerous-server__*"
+    ]
+  }
+}
+```
+
+---
+
+## MCP Scopes
+
+MCP servers can be defined at three levels:
+
+| Scope | Location | Purpose |
+|-------|----------|---------|
+| **Project** | `.mcp.json` (repo root) | Team-shared servers, committed to git |
+| **User** | `~/.claude.json` (`mcpServers` key) | Personal servers across all projects |
+| **Subagent** | Agent frontmatter (`mcpServers` field) | Servers scoped to a specific subagent |
+
+Precedence: Subagent > Project > User
+
+---
+
+## Sources
+
+- [MCP Servers — Claude Code Docs](https://code.claude.com/docs/en/mcp)
+- [Model Context Protocol Specification](https://modelcontextprotocol.io/)
+- [5 MCPs that have genuinely made me 10x faster — r/mcp](https://reddit.com/r/mcp/comments/1qarjqm/)
+- [MCP Server Overload Discussion — r/mcp](https://reddit.com/r/mcp/comments/1mj0fxs/)

package/skills/best-practice/claude-memory.md

@@ -0,0 +1,121 @@
+# Claude Memory
+
+Persistent context via CLAUDE.md files — how to write them and how they load in monorepos.
+
+<table width="100%">
+<tr>
+<td><a href="../">← Back to Claude Code Best Practice</a></td>
+<td align="right"><img src="../!/claude-jumping.svg" alt="Claude" width="60" /></td>
+</tr>
+</table>
+
+---
+
+## 1. Writing a Good CLAUDE.md
+
+A well-structured CLAUDE.md is the single most impactful way to improve Claude Code's output for your project. Humanlayer has an excellent guide covering what to include, how to structure it, and common pitfalls.
+
+- [Humanlayer - Writing a good Claude.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md)
+
+---
+
+## 2. CLAUDE.md in Large Monorepos
+
+When working with Claude Code in a monorepo, understanding how CLAUDE.md files are loaded into context is crucial for organizing your project instructions effectively.
+
+<p align="center">
+  <a href="https://x.com/bcherny/status/2016339448863355206"><img src="assets/claude-memory/claude-memory-monorepo.jpg" alt="CLAUDE.md loading in monorepos" width="600"></a>
+</p>
+
+### The Two Loading Mechanisms
+
+Claude Code uses two distinct mechanisms for loading CLAUDE.md files:
+
+#### Ancestor Loading (UP the directory tree)
+
+When you start Claude Code, it walks **upward** from your current working directory toward the filesystem root and loads every CLAUDE.md it finds along the way. These files are loaded **immediately at startup**.
+
+#### Descendant Loading (DOWN the directory tree)
+
+CLAUDE.md files in subdirectories below your current working directory are **NOT loaded at launch**. They are only included when Claude reads files in those subdirectories during your session. This is known as **lazy loading**.
+
+### Example Monorepo Structure
+
+Consider a typical monorepo with separate directories for different components:
+
+```
+/mymonorepo/
+├── CLAUDE.md          # Root-level instructions (shared across all components)
+├── frontend/
+│   └── CLAUDE.md      # Frontend-specific instructions
+├── backend/
+│   └── CLAUDE.md      # Backend-specific instructions
+└── api/
+    └── CLAUDE.md      # API-specific instructions
+```
+
+### Scenario 1: Running Claude Code from the Root Directory
+
+When you run Claude Code from `/mymonorepo/`:
+
+```bash
+cd /mymonorepo
+claude
+```
+
+| File | Loaded at Launch? | Reason |
+|------|-------------------|--------|
+| `/mymonorepo/CLAUDE.md` | Yes | It's your current working directory |
+| `/mymonorepo/frontend/CLAUDE.md` | No | Loaded only when you read/edit files in `frontend/` |
+| `/mymonorepo/backend/CLAUDE.md` | No | Loaded only when you read/edit files in `backend/` |
+| `/mymonorepo/api/CLAUDE.md` | No | Loaded only when you read/edit files in `api/` |
+
+### Scenario 2: Running Claude Code from a Component Directory
+
+When you run Claude Code from `/mymonorepo/frontend/`:
+
+```bash
+cd /mymonorepo/frontend
+claude
+```
+
+| File | Loaded at Launch? | Reason |
+|------|-------------------|--------|
+| `/mymonorepo/CLAUDE.md` | Yes | It's an ancestor directory |
+| `/mymonorepo/frontend/CLAUDE.md` | Yes | It's your current working directory |
+| `/mymonorepo/backend/CLAUDE.md` | No | Different branch of the directory tree |
+| `/mymonorepo/api/CLAUDE.md` | No | Different branch of the directory tree |
+
+### Key Takeaways
+
+1. **Ancestors always load at startup** — Claude walks UP the directory tree and loads all CLAUDE.md files it finds. This ensures you always have access to root-level, repository-wide instructions.
+
+2. **Descendants load lazily** — Subdirectory CLAUDE.md files only load when you interact with files in those subdirectories. This prevents irrelevant context from bloating your session.
+
+3. **Siblings never load** — If you're working in `frontend/`, you won't get `backend/CLAUDE.md` or `api/CLAUDE.md` loaded into context.
+
+4. **Global CLAUDE.md** — You can also place a CLAUDE.md at `~/.claude/CLAUDE.md` in your home folder, which applies to ALL Claude Code sessions regardless of project.
+
+### Why This Design Works for Monorepos
+
+- **Shared instructions propagate down** — Root-level CLAUDE.md contains repository-wide conventions, coding standards, and common patterns that apply everywhere.
+
+- **Component-specific instructions stay isolated** — Frontend developers don't need backend-specific instructions cluttering their context, and vice versa.
+
+- **Context is optimized** — By lazily loading descendant CLAUDE.md files, Claude Code avoids loading potentially hundreds of kilobytes of irrelevant instructions at startup.
+
+### Best Practices
+
+1. **Put shared conventions in root CLAUDE.md** — Coding standards, commit message formats, PR templates, and other repository-wide guidelines.
+
+2. **Put component-specific instructions in component CLAUDE.md** — Framework-specific patterns, component architecture, testing conventions unique to that component.
+
+3. **Use CLAUDE.local.md for personal preferences** — Add it to `.gitignore` for instructions that shouldn't be shared with the team.
+
+---
+
+## Sources
+
+- [Claude Code Documentation - How Claude Looks Up Memories](https://code.claude.com/docs/en/memory#how-claude-looks-up-memories)
+- [Boris Cherny on X - Clarification on CLAUDE.md Loading](https://x.com/bcherny/status/2016339448863355206)
+- [Humanlayer - Writing a good Claude.md](https://www.humanlayer.dev/blog/writing-a-good-claude-md)