Agent skill

advanced_tools

Use when finding files by name, searching code content, locating patterns with regex, exploring codebase, or batch refactoring across multiple files. Conforms to docs/reference/skill-routing-value-standard.md.

View SKILL.md on GitHub Repository

Stars 9

Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tao3k/xiuxian-artisan-workshop/tree/main/skills/advanced_tools

Metadata

Additional technical details for this skill

author: xiuxian-artisan-workshop
source: https://github.com/tao3k/xiuxian-artisan-workshop/tree/main/assets/skills/advanced_tools
intents: [ "Find files by name, extension, or glob pattern", "Search for text or regex patterns in code content", "Locate specific files across the entire project", "Fast codebase exploration and discovery", "Batch find and replace across multiple files", "Use batch replace for safe multi-file refactoring", "High-performance grep replacement", "Scan directory for files matching a pattern" ]
version: 1.2.0
routing keywords: [ "find", "search", "locate", "grep", "ripgrep", "rg", "fd", "discovery", "explore", "pattern", "regex", "match", "content", "text", "files", "codebase", "batch", "refactor", "replace", "batch replace", "batch_replace", "directory", "tree" ]

SKILL.md

Advanced Tools Skill (Batch Replace, Smart Search, Smart Find)

You have loaded the Advanced Tools (Find & Search) Skill.

The Search Engine of Agentic OS

This skill is the PRIMARY gateway for locating anything in the project. It wraps high-performance Rust tools.

Category	Tool	Implementation	Best For
Locator	`smart_find`	fd-find	Finding FILES by name/path
Searcher	`smart_search`	ripgrep	Finding TEXT inside files
Refactor	`batch_replace`	Rust/Python	Multi-file search and replace

Available Tools

smart_find: Fast File Location

ALWAYS use this to find files. Superior to ls or list_directory for discovery.

python

def smart_find(
    pattern: str = ".",      # Regex or glob for filename
    extension: str = None,   # Filter: 'py', 'rs', 'md'
    exclude: str = None,     # Patterns to ignore
    search_mode: str = "filename" # "filename" (fd) or "content" (rg -l)
) -> dict

smart_search: Fast Code Search

ALWAYS use this to find code content. The gold standard for grep.

python

def smart_search(
    pattern: str,            # Text or regex to find (REQUIRED)
    file_globs: str = None,  # Filter: "*.py *.ts"
    case_sensitive: bool = True,
    context_lines: int = 0
) -> dict

batch_replace: Safe Refactoring

RECOMMENDED for mass changes. Always includes a dry-run preview.

python

def batch_replace(
    pattern: str,            # Find this
    replacement: str,        # Replace with this
    file_glob: str = "**/*",
    dry_run: bool = True     # Default is PREVIEW for safety
) -> dict

Batch Replace Command (Primary Query Anchor)

batch replace is the canonical query phrase for this tool in documentation and routing. Use batch_replace when you need deterministic multi-file replacement with dry-run safety.

Linked Notes

Related: Code Tools Skill
Related: Skill Routing Value Standard

Use Cases & Intention

"Find all python files" -> smart_find(extension="py")
"Where is the Kernel defined?" -> smart_search(pattern="class Kernel")
"Find files containing API_KEY" -> smart_find(pattern="API_KEY", search_mode="content")
"Rename variable 'old_name' to 'new_name'" -> batch_replace(...)

Important Rules

Discovery First: If you don't know where a file is, use smart_find.
Context Matters: Use smart_search with context_lines to understand match surroundings.
Respect Ignored: All tools automatically respect .gitignore.
Prefer Patterns: Use specific regex patterns to reduce noise.