@biggora/claude-plugins 1.1.0 → 1.2.0

package/src/skills/codex-cli/SKILL.md

@@ -39,17 +39,19 @@ codex e "Update CHANGELOG"         # Short alias for exec
 ## Core Concepts
 
 ### Approval Modes (`-a` / `--ask-for-approval`)
-Controls when Codex pauses to ask before executing:
+Controls when Codex pauses to ask before executing. The ONLY valid values are:
 
-| Mode | Flag | Behavior |
-|------|------|----------|
-| `untrusted` | `-a untrusted` | Max caution — approves almost everything |
-| `on-request` | `-a on-request` | Asks on sensitive actions (default for auto) |
-| `never` | `-a never` | Never asks — runs fully automated |
-| `reject` | `-a reject` | Blocks all tool use |
+| Mode | Flag | Config value | Behavior |
+|------|------|-------------|----------|
+| `untrusted` | `-a untrusted` | `approval_policy = "untrusted"` | Max caution — approves almost everything |
+| `on-request` | `-a on-request` | `approval_policy = "on-request"` | Asks on sensitive actions (default for auto) |
+| `never` | `-a never` | `approval_policy = "never"` | Never asks — runs fully automated |
+| `reject` | `-a reject` | `approval_policy = "reject"` | Blocks all tool use |
+
+Note: `--full-auto` is a CLI-only shortcut (equivalent to `-a on-request -s workspace-write`). It is NOT a valid `approval_policy` config value. Values like "suggest", "auto-edit", or "full-auto" do not exist as config values.
 
 ### Sandbox Modes (`-s` / `--sandbox`)
-Controls filesystem and network access:
+Controls filesystem and network access. The ONLY valid values are:
 
 | Mode | Flag | Access |
 |------|------|--------|
@@ -57,6 +59,8 @@ Controls filesystem and network access:
 | `workspace-write` | `-s workspace-write` | Write within working directory only |
 | `danger-full-access` | `-s danger-full-access` | Full system access (use with caution) |
 
+Note: There is no `--no-sandbox` flag or `sandbox = "none"` config option. To bypass the sandbox entirely, use `--dangerously-bypass-approvals-and-sandbox` (alias `--yolo`).
+
 ### Common Combinations
 ```bash
 # Safe daily development (recommended)
@@ -78,6 +82,8 @@ codex --dangerously-bypass-approvals-and-sandbox "task"
 
 ## Configuration (`~/.codex/config.toml`)
 
+Config uses **TOML format** (not JSON). The file is `config.toml`, never `config.json`.
+
 ### Minimal config
 ```toml
 model = "gpt-5-codex"
@@ -101,6 +107,9 @@ animations = true
 ```
 
 ### Profiles (for different workflows)
+
+Profiles use `[profiles.<name>]` (plural "profiles", not singular "profile"):
+
 ```toml
 [profiles.ci]
 model = "gpt-5-codex"
@@ -112,7 +121,7 @@ model_reasoning_effort = "high"
 approval_policy = "untrusted"
 ```
 
-Use a profile: `codex --profile ci "task"` or set `profile = "ci"` at the top level.
+Use a profile: `codex --profile ci "task"` or `codex -p ci "task"`, or set `profile = "ci"` at the top level as default.
 
 ### Config precedence (highest → lowest)
 1. CLI flags (`--model`, `-c key=value`)
@@ -124,7 +133,7 @@ Use a profile: `codex --profile ci "task"` or set `profile = "ci"` at the top le
 
 ## Non-Interactive Mode (`codex exec`)
 
-Ideal for CI pipelines and shell scripts:
+For CI pipelines and shell scripts, always use `codex exec` (not bare `codex`). The `exec` subcommand runs non-interactively and exits when done:
 
 ```bash
 # Basic
@@ -195,9 +204,10 @@ env = { GITHUB_TOKEN = "$GITHUB_TOKEN" }
 url = "https://my-server.example.com/mcp"
 ```
 
-Run Codex itself as an MCP server (for other agents to consume):
+Run Codex itself as an MCP server (for other agents to consume) using the `mcp` subcommand (not a flag):
 ```bash
 codex mcp
+# Note: this is a subcommand, NOT "codex --mcp-server"
 ```
 
 ---

package/src/skills/codex-cli/evals/evals.json

@@ -0,0 +1,47 @@
+{
+  "skill_name": "codex-cli",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "I want to set up OpenAI Codex CLI in my GitHub Actions pipeline to auto-fix lint errors on PRs. How do I configure it with full-auto mode and workspace-write sandbox? My OPENAI_API_KEY is stored in GitHub secrets.",
+      "expected_output": "Should provide a GitHub Actions workflow YAML with npm install -g @openai/codex, codex exec with --full-auto flag, OPENAI_API_KEY from secrets, and correct sandbox/approval behavior explanation.",
+      "files": [],
+      "assertions": [
+        {"id": "installs-globally", "text": "Shows npm install -g @openai/codex for global installation"},
+        {"id": "uses-exec-mode", "text": "Uses 'codex exec' for non-interactive CI mode (not bare 'codex')"},
+        {"id": "full-auto-flag", "text": "Uses --full-auto flag and correctly explains it equals -a on-request -s workspace-write"},
+        {"id": "api-key-from-secrets", "text": "Shows OPENAI_API_KEY set from ${{ secrets.OPENAI_API_KEY }} in env"},
+        {"id": "provides-workflow-yaml", "text": "Provides a complete GitHub Actions workflow YAML snippet"},
+        {"id": "no-hallucinated-flags", "text": "Does not invent non-existent CLI flags or options"}
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "How do I add a custom MCP server to codex CLI? I have a Python-based MCP server that needs a GITHUB_TOKEN env var. Also want to run codex itself as an MCP server for other agents to consume.",
+      "expected_output": "Should show ~/.codex/config.toml mcp_servers section with command, args, env fields. Should show 'codex mcp' command for running as MCP server. Should use $GITHUB_TOKEN pattern for env vars.",
+      "files": [],
+      "assertions": [
+        {"id": "correct-config-location", "text": "Points to ~/.codex/config.toml for MCP server configuration"},
+        {"id": "mcp-servers-toml-syntax", "text": "Shows [mcp_servers.name] TOML section with command, args fields"},
+        {"id": "env-var-dollar-pattern", "text": "Shows $GITHUB_TOKEN or $ENV_VAR pattern for environment variable references"},
+        {"id": "codex-as-mcp-server", "text": "Shows 'codex mcp' command for running codex as an MCP server"},
+        {"id": "python-command-correct", "text": "Uses correct Python command (python/python3) in the MCP server command field"},
+        {"id": "no-hallucinated-config", "text": "Does not invent non-existent config keys or MCP server fields"}
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "I'm getting Landlock errors on WSL2 when running codex. Also, I need to set up two profiles in config.toml — one for safe daily dev and one for CI with no approvals. How do I fix the Landlock issue and configure the profiles?",
+      "expected_output": "Should explain Landlock fix (update WSL2 or use --dangerously-bypass-approvals-and-sandbox in isolated env). Should show config.toml profiles section with [profiles.dev] and [profiles.ci] using correct approval_policy values.",
+      "files": [],
+      "assertions": [
+        {"id": "landlock-wsl-fix", "text": "Mentions updating WSL2 kernel or using --dangerously-bypass-approvals-and-sandbox (--yolo) as workarounds"},
+        {"id": "profiles-toml-syntax", "text": "Shows correct [profiles.name] TOML syntax for defining profiles"},
+        {"id": "ci-profile-no-approval", "text": "CI profile uses approval_policy = 'never' for fully automated mode"},
+        {"id": "dev-profile-safe", "text": "Dev profile uses a safe approval_policy like 'on-request' or 'untrusted'"},
+        {"id": "profile-usage-flag", "text": "Shows --profile flag for selecting a profile at runtime"},
+        {"id": "no-hallucinated-fixes", "text": "Does not invent non-existent troubleshooting steps or config options"}
+      ]
+    }
+  ]
+}

package/src/skills/gemini-cli/SKILL.md

@@ -7,7 +7,7 @@ description: >
   prompts with -p flag, configuring settings.json, creating GEMINI.md context files, writing
   custom slash commands (.toml files), connecting MCP servers, creating extensions, automating
   tasks with shell scripts, using --output-format json/stream-json, managing chat sessions,
-  using /memory commands, --yolo mode, or any scripting/automation involving gemini-cli.
+  using /memory commands, --auto-approve mode, Application Default Credentials (ADC), or any scripting/automation involving gemini-cli.
   Also trigger when user asks about integrating Gemini models into CLI workflows, CI/CD pipelines,
   or programmatic use of the Gemini API through the CLI tool.
 ---
@@ -66,11 +66,19 @@ gemini
 - Free: 1,000 req/day (Gemini Flash/Pro mix)
 - Can also store in `~/.gemini/.env` or `./.gemini/.env`
 
-### Option 3: Vertex AI (enterprise)
+### Option 3: Application Default Credentials (ADC)
+```bash
+gcloud auth application-default login
+gemini
+```
+- Uses Google Cloud ADC — no API key needed
+- Best for developers already using Google Cloud
+
+### Option 4: Vertex AI (enterprise)
 ```bash
-export GOOGLE_API_KEY="your_key"
 export GOOGLE_GENAI_USE_VERTEXAI=true
 export GOOGLE_CLOUD_PROJECT="your-project-id"
+gcloud auth application-default login
 gemini
 ```
 
@@ -119,8 +127,8 @@ gemini -p "Run tests and analyze results" --output-format stream-json
 # Extract response field with jq
 gemini -p "List top 5 Python testing frameworks" --output-format json | jq -r '.response'
 
-# Auto-accept all tool actions (YOLO mode) — use with care in automation
-gemini -p "Generate unit tests for @./src/utils.js" --yolo
+# Auto-accept all tool actions (auto-approve mode) — use with care in automation
+gemini -p "Generate unit tests for @./src/utils.js" --auto-approve
 ```
 
 ### JSON output schema
@@ -154,7 +162,7 @@ For full scripting patterns → read `references/headless-and-scripting.md`
 | `/restore` | List checkpoints |
 | `/restore <file>` | Restore a checkpoint |
 | `/bug` | Report an issue directly from CLI |
-| `Ctrl+Y` | Toggle YOLO mode (auto-accept all tools) |
+| `Ctrl+Y` | Toggle auto-approve mode |
 
 ---
 
@@ -226,11 +234,17 @@ Location: `~/.gemini/settings.json` (global) or `<project>/.gemini/settings.json
 
 ```json
 {
-  "model": "gemini-2.5-pro",
-  "theme": "dark",
+  "model": {
+    "name": "gemini-2.5-pro"
+  },
+  "theme": {
+    "name": "dark"
+  },
   "autoAccept": false,
-  "coreTools": ["read_file", "write_file", "run_shell_command"],
-  "excludeTools": ["dangerous_tool"],
+  "tools": {
+    "core": ["read_file", "write_file", "run_shell_command"],
+    "disabled": ["dangerous_tool"]
+  },
   "mcpServers": {
     "github": {
       "command": "npx",
@@ -288,7 +302,7 @@ Extensions bundle MCP servers + GEMINI.md + custom commands into a reusable pack
 
 **Install from URL:**
 ```bash
-gemini extension install https://github.com/GoogleCloudPlatform/cloud-run-mcp
+gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp
 ```
 
 **Browse gallery:** https://geminicli.com/extensions/
@@ -347,7 +361,7 @@ echo "$result" | jq -r '.response' > openapi.json
 export GEMINI_API_KEY="${{ secrets.GEMINI_API_KEY }}"
 gemini -p "Analyze test failures in @./test-results.xml and suggest fixes" \
   --output-format json \
-  --yolo \
+  --auto-approve \
   | jq -r '.response'
 ```
 
@@ -374,6 +388,6 @@ For Vertex AI: additional enterprise models available.
 | Rate limit errors | Free tier: 60 req/min, 1000/day — wait or upgrade |
 | MCP server not connecting | Check `/mcp status`, verify server binary is installed |
 | Slash command not recognized in headless | Known limitation — embed prompt text directly for now |
-| Tool confirmation loops | Add `--yolo` flag for automation, or set `"autoAccept": true` in settings.json |
+| Tool confirmation loops | Add `--auto-approve` flag for automation, or set `"autoAccept": true` in settings |
 
 Full troubleshooting: https://geminicli.com/docs/resources/troubleshooting/

package/src/skills/gemini-cli/evals/evals.json

@@ -0,0 +1,46 @@
+{
+  "skill_name": "gemini-cli",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "I want to set up gemini cli in my CI/CD pipeline on GitHub Actions so it can automatically review PRs. We use an API key stored in GitHub secrets. How do I set this up with structured JSON output so I can parse the review?",
+      "expected_output": "Should provide a GitHub Actions workflow snippet using GEMINI_API_KEY from secrets, -p flag for headless mode, --output-format json, and jq for parsing. Should mention --yolo if tool actions are needed.",
+      "files": [],
+      "assertions": [
+        {"id": "mentions-p-flag", "text": "Uses -p or --prompt flag for headless/non-interactive mode"},
+        {"id": "mentions-json-output", "text": "Includes --output-format json flag for structured output"},
+        {"id": "mentions-api-key-env", "text": "Shows how to set GEMINI_API_KEY from GitHub secrets"},
+        {"id": "provides-workflow-yaml", "text": "Provides a GitHub Actions workflow YAML snippet"},
+        {"id": "mentions-jq-parsing", "text": "Shows how to parse JSON response (e.g., with jq .response)"},
+        {"id": "no-hallucinated-flags", "text": "Does not invent non-existent CLI flags or options"}
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "I need to connect a custom MCP server I built in Python to gemini cli. The server needs an API key from my environment. Also I want to restrict which tools it can expose. How do I configure this?",
+      "expected_output": "Should explain settings.json mcpServers config with command, args, env ($VAR pattern), and includeTools/excludeTools. Should mention trust field and security considerations.",
+      "files": [],
+      "assertions": [
+        {"id": "correct-settings-location", "text": "Points to ~/.gemini/settings.json or project-level settings.json"},
+        {"id": "shows-mcp-config-structure", "text": "Shows mcpServers config with command, args fields"},
+        {"id": "env-var-dollar-pattern", "text": "Shows $VAR pattern for environment variable references in env field"},
+        {"id": "tool-filtering", "text": "Explains includeTools and/or excludeTools for restricting exposed tools"},
+        {"id": "security-note", "text": "Mentions security considerations (trust field, not hardcoding keys, etc.)"},
+        {"id": "python-command-correct", "text": "Uses correct Python command (python/python3) in the command field"}
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "How do I create a custom slash command in gemini cli that runs git diff --cached and asks the AI to write a commit message? I want it available in all my projects.",
+      "expected_output": "Should provide a .toml file in ~/.gemini/commands/ with !{git diff --cached} shell syntax and prompt template. Should mention headless limitation.",
+      "files": [],
+      "assertions": [
+        {"id": "correct-file-location", "text": "Points to ~/.gemini/commands/ for global user-scoped commands"},
+        {"id": "toml-format", "text": "Shows .toml file format with prompt field"},
+        {"id": "shell-execution-syntax", "text": "Uses !{git diff --cached} shell execution syntax in the prompt"},
+        {"id": "mentions-headless-limitation", "text": "Warns that custom slash commands don't work in headless/non-interactive mode"},
+        {"id": "complete-working-example", "text": "Provides a complete, copy-pasteable .toml file example"}
+      ]
+    }
+  ]
+}

package/src/skills/gemini-cli/references/commands.md

@@ -10,11 +10,9 @@ Options:
   -m, --model <model>          Model to use (e.g., gemini-2.5-pro)
   --output-format <format>     Output format: text (default), json, stream-json
   --include-directories <dirs> Comma-separated extra directories to include
-  --yolo                       Auto-accept all tool actions (no confirmations)
+  --auto-approve               Auto-accept all tool actions (no confirmations)
   --resume <session-id>        Resume a previous session
-  --system-prompt <text>       Override system prompt
-  --raw-output                 Disable ANSI codes in output
-  --debug-log <path>           Write debug JSONL log to file
+  --sandbox <type>             Run in sandboxed environment (docker, podman, etc.)
   -v, --version                Show version
   -h, --help                   Show help
 ```
@@ -56,6 +54,13 @@ Options:
 | `/chat resume <name>` | Resume a saved conversation |
 | `/chat list` | List saved conversations |
 
+### Context / Compaction
+
+| Command | Description |
+|---|---|
+| `/compact` | Compact conversation context (free tokens) |
+| `/diff` | Show diff of changes made in current session |
+
 ### Memory
 
 | Command | Description |
@@ -63,6 +68,7 @@ Options:
 | `/memory add <text>` | Add a persistent fact to GEMINI.md |
 | `/memory show` | Display current memory contents |
 | `/memory clear` | Clear all memory entries |
+| `/memory reload` | Reload memory from disk |
 
 ### Checkpointing
 
@@ -75,9 +81,9 @@ Options:
 
 | Command | Description |
 |---|---|
-| `/extension list` | List installed extensions |
-| `/extension enable <n>` | Enable an extension |
-| `/extension disable <n>` | Disable an extension |
+| `/extensions list` | List installed extensions |
+| `/extensions enable <n>` | Enable an extension |
+| `/extensions disable <n>` | Disable an extension |
 
 ### Theme
 
@@ -95,7 +101,7 @@ Options:
 | `replace` | Replace text in files (old_string → new_string) |
 | `list_directory` | List directory contents |
 | `glob` | Find files by pattern |
-| `search_file_content` | Search within files by pattern |
+| `grep_search` | Search within files by pattern |
 | `run_shell_command` | Execute shell commands |
 | `google_web_search` | Search the web (Google Search grounding) |
 | `web_fetch` | Fetch URL content |
@@ -123,10 +129,11 @@ gemini -p "Summarize @https://github.com/org/repo/README.md"
 |---|---|
 | `Ctrl+C` | Cancel current operation |
 | `Ctrl+D` | Exit |
-| `Ctrl+Y` | Toggle YOLO mode (auto-accept tools) |
+| `Ctrl+Y` | Toggle auto-approve mode (auto-accept tools) |
 | `Ctrl+L` | Clear screen |
+| `Ctrl+J` | Insert newline (multi-line input) |
 | `↑ / ↓` | Navigate input history |
-| `Tab` | Autocomplete slash commands |
+| `Tab` | Autocomplete slash commands and file paths |
 
 ## gemini mcp CLI Commands (outside session)
 
@@ -136,10 +143,10 @@ gemini mcp list
 gemini mcp remove <n>
 ```
 
-## gemini extension CLI Commands (outside session)
+## gemini extensions CLI Commands (outside session)
 
 ```bash
-gemini extension install <url>
-gemini extension list
-gemini extension remove <n>
+gemini extensions install <url>
+gemini extensions list
+gemini extensions remove <n>
 ```

package/src/skills/gemini-cli/references/configuration.md

@@ -17,20 +17,25 @@
 
 ```json
 {
-  // Model selection
-  "model": "gemini-2.5-pro",
+  // Model selection (nested under "model" object)
+  "model": {
+    "name": "gemini-2.5-pro"
+  },
 
-  // UI theme: "dark" | "light" | "auto" | custom theme name
-  "theme": "dark",
+  // UI theme (nested under "theme" object)
+  "theme": {
+    "name": "dark"
+  },
 
-  // Auto-accept all tool confirmations (like --yolo)
+  // Auto-accept all tool confirmations (like --auto-approve)
   "autoAccept": false,
 
-  // Tools to include (whitelist) — if set, only these are available
-  "coreTools": ["read_file", "write_file", "run_shell_command", "google_web_search"],
-
-  // Tools to explicitly exclude (blacklist)
-  "excludeTools": ["dangerous_tool_name"],
+  // Tools configuration (nested under "tools" object)
+  "tools": {
+    "core": ["read_file", "write_file", "run_shell_command", "google_web_search"],
+    "allowed": ["my_custom_tool"],
+    "disabled": ["dangerous_tool_name"]
+  },
 
   // Generation parameters
   "generationConfig": {
@@ -48,7 +53,7 @@
       "env": {
         "API_KEY": "$MY_ENV_VAR"
       },
-      "timeout": 15000,
+      "timeout": 600000,
       "trust": false,
       "includeTools": ["safe_tool_1"],
       "excludeTools": ["unsafe_tool"]
@@ -107,6 +112,7 @@ Main services: auth, api, worker.
 ```
 /memory add "Staging database is on port 5432"
 /memory show
+/memory reload     # reload from disk after external edits
 ```
 (Writes to `~/.gemini/GEMINI.md`)
 
@@ -130,6 +136,9 @@ Gemini CLI also respects `.gitignore` automatically.
 
 ```json
 {
+  "model": {
+    "name": "gemini-2.5-pro"
+  },
   "generationConfig": {
     "temperature": 1.0,
     "topP": 0.95,
@@ -146,19 +155,15 @@ Gemini CLI also respects `.gitignore` automatically.
 
 ## System Prompt Override
 
-Override the entire system prompt (advanced):
-
-```bash
-gemini --system-prompt "You are a strict TypeScript reviewer. Only respond with code issues."
-```
-
-Or via settings.json:
+Override the system prompt via settings.json:
 ```json
 {
   "systemPrompt": "You are a helpful assistant for Python development."
 }
 ```
 
+Or use GEMINI.md context files to provide project-specific instructions (preferred approach).
+
 ## Trusted Folders
 
 Control which directories allow shell command execution:

package/src/skills/gemini-cli/references/headless-and-scripting.md

@@ -60,8 +60,8 @@
 |---|---|
 | 0 | Success |
 | 1 | General error |
-| 2 | Authentication error |
-| 3 | Rate limit / quota exceeded |
+| 42 | Input error (invalid arguments, missing config) |
+| 53 | Turn limit exceeded |
 
 ## Session Management in Headless Mode
 
@@ -74,9 +74,8 @@ gemini -p "Continue from where we left off" --resume <session_id>
 
 ## Input Sources (merged in order)
 
-1. `--context-file` flag
-2. Stdin pipe
-3. `-p` prompt argument
+1. Stdin pipe
+2. `-p` prompt argument
 
 ## Bash Scripting Patterns
 
@@ -104,10 +103,10 @@ echo "$RESULT" | jq -r '.response'
 git log --oneline -20 | gemini -p "Summarize the recent development activity"
 ```
 
-### Pattern 5: Auto-accept all tool actions (YOLO)
+### Pattern 5: Auto-accept all tool actions (auto-approve)
 ```bash
 # For CI pipelines where no human is present
-gemini -p "Fix lint errors in @./src/ and save changes" --yolo --output-format json
+gemini -p "Fix lint errors in @./src/ and save changes" --auto-approve --output-format json
 ```
 
 ### Pattern 6: Batch processing multiple files
@@ -115,7 +114,7 @@ gemini -p "Fix lint errors in @./src/ and save changes" --yolo --output-format j
 #!/bin/bash
 for py_file in $(find src -name "*.py"); do
   echo "Processing: $py_file"
-  gemini -p "Add type hints to @$py_file and save" --yolo
+  gemini -p "Add type hints to @$py_file and save" --auto-approve
 done
 ```
 
@@ -166,15 +165,6 @@ $output.response > data.json
     echo "$REVIEW" >> $GITHUB_STEP_SUMMARY
 ```
 
-## Logging / Debugging
-
-```bash
-# Enable debug logging to file
-gemini -p "My prompt" --debug-log ./gemini-debug.jsonl
-```
-
-The log file captures all API interactions and tool executions as JSONL events.
-
 ## Known Limitations
 
 - Custom slash commands (`.toml`) currently do NOT work in headless/non-interactive mode (open issue). Workaround: embed the full prompt text directly in your script.

package/src/skills/gemini-cli/references/mcp-and-extensions.md

@@ -49,10 +49,13 @@ resources to Gemini CLI. MCP servers act as a bridge between Gemini and external
 | `args` | string[] | Arguments array |
 | `cwd` | string | Working directory |
 | `env` | object | Environment variables (use `"$VAR"` to reference env) |
-| `timeout` | number | Connection timeout in ms (default: 10000) |
+| `timeout` | number | Connection timeout in ms (default: 600000 — 10 minutes) |
 | `trust` | boolean | Skip all confirmation dialogs (use with caution) |
 | `includeTools` | string[] | Whitelist of tools to expose |
 | `excludeTools` | string[] | Blacklist of tools to hide |
+| `description` | string | Human-readable description of the server |
+| `httpUrl` | string | HTTP endpoint URL (for streamable HTTP transport) |
+| `headers` | object | Custom HTTP headers for remote connections |
 
 ## Remote MCP Servers (SSE/HTTP)
 
@@ -128,7 +131,7 @@ Extensions bundle together MCP servers, context files, and custom commands into
 
 ### Install from Git URL
 ```bash
-gemini extension install https://github.com/GoogleCloudPlatform/cloud-run-mcp
+gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp
 ```
 
 ### Browse the gallery
@@ -176,9 +179,9 @@ my-extension/
 ### Managing Extensions
 
 ```
-/extension list          # list installed extensions
-/extension enable <n>    # enable extension
-/extension disable <n>   # disable extension
+/extensions list          # list installed extensions
+/extensions enable <n>    # enable extension
+/extensions disable <n>   # disable extension
 ```
 
 ---
@@ -206,9 +209,12 @@ description = "What this command does"
 # Use {{args}} to insert all user-provided arguments
 prompt = "Review this code: {{args}}"
 
-# Shell command execution (backtick-style)
+# Shell command execution
 prompt = "Review staged changes:\n!{git diff --cached}"
 
+# File content injection
+prompt = "Review this config:\n@{./config.json}"
+
 # Combined example
 description = "Commit with AI message"
 prompt = """

package/src/skills/notebook-lm/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: notebooklm
+name: notebook-lm
 description: |
   Automate Google NotebookLM via the notebooklm-py Python library. Use this skill whenever the user wants to:
   - Create, manage, or delete NotebookLM notebooks