fix: correct invalid Gemini CLI tool names in agents and docs

Jamkris · Jamkris · commit 01892d0c59da · 2026-04-22T13:08:27.000+09:00
Replace `search_files` with `search_file_content` and `replace_in_file` with `replace` across all agent frontmatter and documentation. These were not valid Gemini CLI built-in tool names and caused agent loading failures at startup (validation error: `tools.N: Invalid tool name`). The terminology tables in docs/ that mapped Claude Code tools to Gemini CLI equivalents were the source of the incorrect names, which had propagated into 18 agent files. Fixes #34
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -108,9 +108,9 @@ If you are migrating agents from Claude Code:
 |-------------|------------|
 | `Read` | `read_file` |
 | `Write` | `write_file` |
-| `Edit` | `replace_in_file` |
+| `Edit` | `replace` |
 | `Bash` | `run_shell_command` |
-| `Grep` | `search_files` |
+| `Grep` | `search_file_content` |
 | `Glob` | `list_directory` |
 | `WebSearch` | `google_web_search` |
 
diff --git a/agents/architect.md b/agents/architect.md
@@ -1,7 +1,7 @@
 ---
 name: architect
 description: Software architecture specialist for system design, scalability, and technical decision-making. Use PROACTIVELY when planning new features, refactoring large systems, or making architectural decisions.
-tools: ["read_file", "search_files", "list_directory"]
+tools: ["read_file", "search_file_content", "list_directory"]
 ---
 
 You are a senior software architect specializing in scalable, maintainable system design.
diff --git a/agents/chief-of-staff.md b/agents/chief-of-staff.md
@@ -1,7 +1,7 @@
 ---
 name: chief-of-staff
 description: Personal communication chief of staff that triages email, Slack, LINE, and Messenger. Classifies messages into 4 tiers (skip/info_only/meeting_info/action_required), generates draft replies, and enforces post-send follow-through via hooks. Use when managing multi-channel communication workflows.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command", "replace_in_file", "write_file"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command", "replace", "write_file"]
 ---
 
 You are a personal chief of staff that manages all communication channels — email, Slack, LINE, Messenger, and calendar — through a unified triage pipeline.
diff --git a/agents/code-architect.md b/agents/code-architect.md
@@ -1,7 +1,7 @@
 ---
 name: code-architect
 description: Designs feature architectures by analyzing existing codebase patterns and conventions, then providing implementation blueprints with concrete files, interfaces, data flow, and build order.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 # Code Architect Agent
diff --git a/agents/code-explorer.md b/agents/code-explorer.md
@@ -1,7 +1,7 @@
 ---
 name: code-explorer
 description: Deeply analyzes existing codebase features by tracing execution paths, mapping architecture layers, and documenting dependencies to inform new development.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 # Code Explorer Agent
diff --git a/agents/code-reviewer.md b/agents/code-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: code-reviewer
 description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code. MUST BE USED for all code changes.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command"]
 ---
 
 You are a senior code reviewer ensuring high standards of code quality and security.
diff --git a/agents/code-simplifier.md b/agents/code-simplifier.md
@@ -1,7 +1,7 @@
 ---
 name: code-simplifier
 description: Simplifies and refines code for clarity, consistency, and maintainability while preserving behavior. Focus on recently modified code unless instructed otherwise.
-tools: [read_file, write_file, replace_in_file, run_shell_command, search_files, list_directory]
+tools: [read_file, write_file, replace, run_shell_command, search_file_content, list_directory]
 ---
 
 # Code Simplifier Agent
diff --git a/agents/comment-analyzer.md b/agents/comment-analyzer.md
@@ -1,7 +1,7 @@
 ---
 name: comment-analyzer
 description: Analyze code comments for accuracy, completeness, maintainability, and comment rot risk.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 # Comment Analyzer Agent
diff --git a/agents/conversation-analyzer.md b/agents/conversation-analyzer.md
@@ -1,7 +1,7 @@
 ---
 name: conversation-analyzer
 description: Use this agent when analyzing conversation transcripts to find behaviors worth preventing with hooks. Triggered by /hookify without arguments.
-tools: [read_file, search_files]
+tools: [read_file, search_file_content]
 ---
 
 # Conversation Analyzer Agent
diff --git a/agents/cpp-build-resolver.md b/agents/cpp-build-resolver.md
@@ -1,7 +1,7 @@
 ---
 name: cpp-build-resolver
 description: C++ build, CMake, and compilation error resolution specialist. Fixes build errors, linker issues, and template errors with minimal changes. Use when C++ builds fail.
-tools: ["read_file", "write_file", "replace_in_file", "run_shell_command", "search_files", "list_directory"]
+tools: ["read_file", "write_file", "replace", "run_shell_command", "search_file_content", "list_directory"]
 ---
 
 # C++ Build Error Resolver
diff --git a/agents/cpp-reviewer.md b/agents/cpp-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: cpp-reviewer
 description: Expert C++ code reviewer specializing in memory safety, modern C++ idioms, concurrency, and performance. Use for all C++ code changes. MUST BE USED for C++ projects.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command"]
 ---
 
 You are a senior C++ code reviewer ensuring high standards of modern C++ and best practices.
diff --git a/agents/csharp-reviewer.md b/agents/csharp-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: csharp-reviewer
 description: Expert C# code reviewer specializing in .NET conventions, async patterns, security, nullable reference types, and performance. Use for all C# code changes. MUST BE USED for C# projects.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 You are a senior C# code reviewer ensuring high standards of idiomatic .NET code and best practices.
diff --git a/agents/dart-build-resolver.md b/agents/dart-build-resolver.md
@@ -1,7 +1,7 @@
 ---
 name: dart-build-resolver
 description: Dart/Flutter build, analysis, and dependency error resolution specialist. Fixes `dart analyze` errors, Flutter compilation failures, pub dependency conflicts, and build_runner issues with minimal, surgical changes. Use when Dart/Flutter builds fail.
-tools: [read_file, write_file, replace_in_file, run_shell_command, search_files, list_directory]
+tools: [read_file, write_file, replace, run_shell_command, search_file_content, list_directory]
 ---
 
 # Dart/Flutter Build Error Resolver
diff --git a/agents/docs-lookup.md b/agents/docs-lookup.md
@@ -1,7 +1,7 @@
 ---
 name: docs-lookup
 description: When the user asks how to use a library, framework, or API or needs up-to-date code examples, use Context7 MCP to fetch current documentation and return answers with examples. Invoke for docs/API/setup questions.
-tools: ["read_file", "search_files", "mcp__context7__resolve-library-id", "mcp__context7__query-docs"]
+tools: ["read_file", "search_file_content", "mcp__context7__resolve-library-id", "mcp__context7__query-docs"]
 ---
 
 You are a documentation specialist. You answer questions about libraries, frameworks, and APIs using current documentation fetched via the Context7 MCP (resolve-library-id and query-docs), not training data.
diff --git a/agents/flutter-reviewer.md b/agents/flutter-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: flutter-reviewer
 description: Flutter and Dart code reviewer. Reviews Flutter code for widget best practices, state management patterns, Dart idioms, performance pitfalls, accessibility, and clean architecture violations. Library-agnostic — works with any state management solution and tooling.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command"]
 ---
 
 You are a senior Flutter and Dart code reviewer ensuring idiomatic, performant, and maintainable code.
diff --git a/agents/gan-evaluator.md b/agents/gan-evaluator.md
@@ -1,7 +1,7 @@
 ---
 name: gan-evaluator
 description: "GAN Harness — Evaluator agent. Tests the live running application via Playwright, scores against rubric, and provides actionable feedback to the Generator."
-tools: [read_file, write_file, run_shell_command, search_files, list_directory]
+tools: [read_file, write_file, run_shell_command, search_file_content, list_directory]
 color: red
 ---
 
diff --git a/agents/gan-generator.md b/agents/gan-generator.md
@@ -1,7 +1,7 @@
 ---
 name: gan-generator
 description: "GAN Harness — Generator agent. Implements features according to the spec, reads evaluator feedback, and iterates until quality threshold is met."
-tools: [read_file, write_file, replace_in_file, run_shell_command, search_files, list_directory]
+tools: [read_file, write_file, replace, run_shell_command, search_file_content, list_directory]
 color: green
 ---
 
diff --git a/agents/gan-planner.md b/agents/gan-planner.md
@@ -1,7 +1,7 @@
 ---
 name: gan-planner
 description: "GAN Harness — Planner agent. Expands a one-line prompt into a full product specification with features, sprints, evaluation criteria, and design direction."
-tools: [read_file, write_file, search_files, list_directory]
+tools: [read_file, write_file, search_file_content, list_directory]
 color: purple
 ---
 
diff --git a/agents/harness-optimizer.md b/agents/harness-optimizer.md
@@ -1,7 +1,7 @@
 ---
 name: harness-optimizer
 description: Analyze and improve the local agent harness configuration for reliability, cost, and throughput.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command", "replace_in_file"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command", "replace"]
 color: teal
 ---
 
diff --git a/agents/healthcare-reviewer.md b/agents/healthcare-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: healthcare-reviewer
 description: Reviews healthcare application code for clinical safety, CDSS accuracy, PHI compliance, and medical data integrity. Specialized for EMR/EHR, clinical decision support, and health information systems.
-tools: [read_file, search_files, list_directory]
+tools: [read_file, search_file_content, list_directory]
 ---
 
 # Healthcare Reviewer — Clinical Safety & PHI Compliance
diff --git a/agents/java-build-resolver.md b/agents/java-build-resolver.md
@@ -1,7 +1,7 @@
 ---
 name: java-build-resolver
 description: Java/Maven/Gradle build, compilation, and dependency error resolution specialist. Fixes build errors, Java compiler errors, and Maven/Gradle issues with minimal changes. Use when Java or Spring Boot builds fail.
-tools: ["read_file", "write_file", "replace_in_file", "run_shell_command", "search_files", "list_directory"]
+tools: ["read_file", "write_file", "replace", "run_shell_command", "search_file_content", "list_directory"]
 ---
 
 # Java Build Error Resolver
diff --git a/agents/java-reviewer.md b/agents/java-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: java-reviewer
 description: Expert Java and Spring Boot code reviewer specializing in layered architecture, JPA patterns, security, and concurrency. Use for all Java code changes. MUST BE USED for Spring Boot projects.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command"]
 ---
 You are a senior Java engineer ensuring high standards of idiomatic Java and Spring Boot best practices.
 When invoked:
diff --git a/agents/kotlin-build-resolver.md b/agents/kotlin-build-resolver.md
@@ -1,7 +1,7 @@
 ---
 name: kotlin-build-resolver
 description: Kotlin/Gradle build, compilation, and dependency error resolution specialist. Fixes build errors, Kotlin compiler errors, and Gradle issues with minimal changes. Use when Kotlin builds fail.
-tools: ["read_file", "write_file", "replace_in_file", "run_shell_command", "search_files", "list_directory"]
+tools: ["read_file", "write_file", "replace", "run_shell_command", "search_file_content", "list_directory"]
 ---
 
 # Kotlin Build Error Resolver
diff --git a/agents/kotlin-reviewer.md b/agents/kotlin-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: kotlin-reviewer
 description: Kotlin and Android/KMP code reviewer. Reviews Kotlin code for idiomatic patterns, coroutine safety, Compose best practices, clean architecture violations, and common Android pitfalls.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command"]
 ---
 
 You are a senior Kotlin and Android/KMP code reviewer ensuring idiomatic, safe, and maintainable code.
diff --git a/agents/loop-operator.md b/agents/loop-operator.md
@@ -1,7 +1,7 @@
 ---
 name: loop-operator
 description: Operate autonomous agent loops, monitor progress, and intervene safely when loops stall.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command", "replace_in_file"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command", "replace"]
 color: orange
 ---
 
diff --git a/agents/opensource-forker.md b/agents/opensource-forker.md
@@ -1,7 +1,7 @@
 ---
 name: opensource-forker
 description: Fork any project for open-sourcing. Copies files, strips secrets and credentials (20+ patterns), replaces internal references with placeholders, generates .env.example, and cleans git history. First stage of the opensource-pipeline skill.
-tools: [read_file, write_file, replace_in_file, run_shell_command, search_files, list_directory]
+tools: [read_file, write_file, replace, run_shell_command, search_file_content, list_directory]
 ---
 
 # Open-Source Forker
diff --git a/agents/opensource-packager.md b/agents/opensource-packager.md
@@ -1,7 +1,7 @@
 ---
 name: opensource-packager
 description: Generate complete open-source packaging for a sanitized project. Produces GEMINI.md, setup.sh, README.md, LICENSE, CONTRIBUTING.md, and GitHub issue templates. Makes any repo immediately usable with Gemini CLI. Third stage of the opensource-pipeline skill.
-tools: [read_file, write_file, replace_in_file, run_shell_command, search_files, list_directory]
+tools: [read_file, write_file, replace, run_shell_command, search_file_content, list_directory]
 ---
 
 # Open-Source Packager
diff --git a/agents/opensource-sanitizer.md b/agents/opensource-sanitizer.md
@@ -1,7 +1,7 @@
 ---
 name: opensource-sanitizer
 description: Verify an open-source fork is fully sanitized before release. Scans for leaked secrets, PII, internal references, and dangerous files using 20+ regex patterns. Generates a PASS/FAIL/PASS-WITH-WARNINGS report. Second stage of the opensource-pipeline skill. Use PROACTIVELY before any public release.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 # Open-Source Sanitizer
diff --git a/agents/performance-optimizer.md b/agents/performance-optimizer.md
@@ -1,7 +1,7 @@
 ---
 name: performance-optimizer
 description: Performance analysis and optimization specialist. Use PROACTIVELY for identifying bottlenecks, optimizing slow code, reducing bundle sizes, and improving runtime performance. Profiling, memory leaks, render optimization, and algorithmic improvements.
-tools: [read_file, write_file, replace_in_file, run_shell_command, search_files, list_directory]
+tools: [read_file, write_file, replace, run_shell_command, search_file_content, list_directory]
 ---
 
 # Performance Optimizer
diff --git a/agents/planner.md b/agents/planner.md
@@ -1,7 +1,7 @@
 ---
 name: planner
 description: Expert planning specialist for complex features and refactoring. Use PROACTIVELY when users request feature implementation, architectural changes, or complex refactoring. Automatically activated for planning tasks.
-tools: ["read_file", "search_files", "list_directory"]
+tools: ["read_file", "search_file_content", "list_directory"]
 ---
 
 You are an expert planning specialist focused on creating comprehensive, actionable implementation plans.
diff --git a/agents/pr-test-analyzer.md b/agents/pr-test-analyzer.md
@@ -1,7 +1,7 @@
 ---
 name: pr-test-analyzer
 description: Review pull request test coverage quality and completeness, with emphasis on behavioral coverage and real bug prevention.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 # PR Test Analyzer Agent
diff --git a/agents/pytorch-build-resolver.md b/agents/pytorch-build-resolver.md
@@ -1,7 +1,7 @@
 ---
 name: pytorch-build-resolver
 description: PyTorch runtime, CUDA, and training error resolution specialist. Fixes tensor shape mismatches, device errors, gradient issues, DataLoader problems, and mixed precision failures with minimal changes. Use when PyTorch training or inference crashes.
-tools: ["read_file", "write_file", "replace_in_file", "run_shell_command", "search_files", "list_directory"]
+tools: ["read_file", "write_file", "replace", "run_shell_command", "search_file_content", "list_directory"]
 ---
 
 # PyTorch Build/Runtime Error Resolver
diff --git a/agents/rust-build-resolver.md b/agents/rust-build-resolver.md
@@ -1,7 +1,7 @@
 ---
 name: rust-build-resolver
 description: Rust build, compilation, and dependency error resolution specialist. Fixes cargo build errors, borrow checker issues, and Cargo.toml problems with minimal changes. Use when Rust builds fail.
-tools: ["read_file", "write_file", "replace_in_file", "run_shell_command", "search_files", "list_directory"]
+tools: ["read_file", "write_file", "replace", "run_shell_command", "search_file_content", "list_directory"]
 ---
 
 # Rust Build Error Resolver
diff --git a/agents/rust-reviewer.md b/agents/rust-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: rust-reviewer
 description: Expert Rust code reviewer specializing in ownership, lifetimes, error handling, unsafe usage, and idiomatic patterns. Use for all Rust code changes. MUST BE USED for Rust projects.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command"]
 ---
 
 You are a senior Rust code reviewer ensuring high standards of safety, idiomatic patterns, and performance.
diff --git a/agents/seo-specialist.md b/agents/seo-specialist.md
@@ -1,7 +1,7 @@
 ---
 name: seo-specialist
 description: SEO specialist for technical SEO audits, on-page optimization, structured data, Core Web Vitals, and content/keyword mapping. Use for site audits, meta tag reviews, schema markup, sitemap and robots issues, and SEO remediation plans.
-tools: [read_file, search_files, list_directory, run_shell_command, google_web_search]
+tools: [read_file, search_file_content, list_directory, run_shell_command, google_web_search]
 ---
 
 You are a senior SEO specialist focused on technical SEO, search visibility, and sustainable ranking improvements.
diff --git a/agents/silent-failure-hunter.md b/agents/silent-failure-hunter.md
@@ -1,7 +1,7 @@
 ---
 name: silent-failure-hunter
 description: Review code for silent failures, swallowed errors, bad fallbacks, and missing error propagation.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 # Silent Failure Hunter Agent
diff --git a/agents/type-design-analyzer.md b/agents/type-design-analyzer.md
@@ -1,7 +1,7 @@
 ---
 name: type-design-analyzer
 description: Analyze type design for encapsulation, invariant expression, usefulness, and enforcement.
-tools: [read_file, search_files, list_directory, run_shell_command]
+tools: [read_file, search_file_content, list_directory, run_shell_command]
 ---
 
 # Type Design Analyzer Agent
diff --git a/agents/typescript-reviewer.md b/agents/typescript-reviewer.md
@@ -1,7 +1,7 @@
 ---
 name: typescript-reviewer
 description: Expert TypeScript/JavaScript code reviewer specializing in type safety, async correctness, Node/web security, and idiomatic patterns. Use for all TypeScript and JavaScript code changes. MUST BE USED for TypeScript/JavaScript projects.
-tools: ["read_file", "search_files", "list_directory", "run_shell_command"]
+tools: ["read_file", "search_file_content", "list_directory", "run_shell_command"]
 ---
 
 You are a senior TypeScript engineer ensuring high standards of type-safe, idiomatic TypeScript and JavaScript.
diff --git a/docs/en/agents/README.md b/docs/en/agents/README.md
@@ -103,8 +103,8 @@ Agents in Everything Gemini Code use Gemini CLI tool names:
 |------|-------------|
 | `read_file` | Read file contents |
 | `write_file` | Write to files |
-| `replace_in_file` | Edit file content |
+| `replace` | Edit file content |
 | `run_shell_command` | Execute shell commands |
-| `search_files` | Search/grep in files |
+| `search_file_content` | Search/grep in files |
 | `list_directory` | List directory contents |
 | `google_web_search` | Web search |
diff --git a/docs/en/contributing/SKILL-PLACEMENT-POLICY.md b/docs/en/contributing/SKILL-PLACEMENT-POLICY.md
@@ -80,7 +80,7 @@ Note: If you adapt skill references from Claude Code, be aware that tool names d
 |-------------|------------|
 | `Read` | `read_file` |
 | `Write` | `write_file` |
-| `Edit` | `replace_in_file` |
+| `Edit` | `replace` |
 | `Bash` | `run_shell_command` |
-| `Grep` | `search_files` |
+| `Grep` | `search_file_content` |
 | `Glob` | `list_directory` |
diff --git a/docs/en/contributing/TERMINOLOGY.md b/docs/en/contributing/TERMINOLOGY.md
@@ -55,9 +55,9 @@ Gemini CLI and Claude Code use different tool names:
 |-------------|------------|
 | `Read` | `read_file` |
 | `Write` | `write_file` |
-| `Edit` | `replace_in_file` |
+| `Edit` | `replace` |
 | `Bash` | `run_shell_command` |
-| `Grep` | `search_files` |
+| `Grep` | `search_file_content` |
 | `Glob` | `list_directory` |
 | `WebSearch` | `google_web_search` |
 
diff --git a/docs/ko-KR/contributing/README.md b/docs/ko-KR/contributing/README.md
@@ -108,9 +108,9 @@ Claude Code 에이전트를 변환하는 경우:
 |-------------|------------|
 | `Read` | `read_file` |
 | `Write` | `write_file` |
-| `Edit` | `replace_in_file` |
+| `Edit` | `replace` |
 | `Bash` | `run_shell_command` |
-| `Grep` | `search_files` |
+| `Grep` | `search_file_content` |
 | `Glob` | `list_directory` |
 | `WebSearch` | `google_web_search` |
 
diff --git a/docs/ko-KR/contributing/SKILL-PLACEMENT-POLICY.md b/docs/ko-KR/contributing/SKILL-PLACEMENT-POLICY.md
@@ -82,7 +82,7 @@ Claude Code에서 스킬 참조를 변환할 때 도구 이름이 다릅니다:
 |-------------|------------|
 | `Read` | `read_file` |
 | `Write` | `write_file` |
-| `Edit` | `replace_in_file` |
+| `Edit` | `replace` |
 | `Bash` | `run_shell_command` |
-| `Grep` | `search_files` |
+| `Grep` | `search_file_content` |
 | `Glob` | `list_directory` |
diff --git a/docs/ko-KR/contributing/TERMINOLOGY.md b/docs/ko-KR/contributing/TERMINOLOGY.md
