search-symbol

Locate code symbol definitions in containerized environments using ctags indexing.

113|23|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/opensage-agent/opensage-adk --skill search-symbol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search-symbol
Source: https://github.com/opensage-agent/opensage-adk/tree/main/src/opensage/bash_tools/retrieval/search-symbol
Command: npx skills add https://github.com/opensage-agent/opensage-adk --skill search-symbol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ctags, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the manual effort of searching through large codebases to find where specific methods, classes, or variables are defined, significantly accelerating code navigation and debugging.

Core Features & Use Cases

  • Symbol Indexing: Utilizes ctags to generate a searchable index of the entire codebase.
  • Fuzzy Matching: Provides intelligent search results even when exact symbol names are partially remembered or ambiguous.
  • Use Case: When working on a complex refactor, use this tool to immediately jump to the definition of a specific method across multiple files without needing to know the exact file path.

Quick Start

Use the search-symbol skill to find the definition of the function named process_data in the current project.

Frequently Asked Questions about search-symbol

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find where a method or variable is defined in a large codebase?

Yes, the search provides fuzzy matching for symbol navigation, returning intelligent results even when you only partially remember the exact method or class name. This helps you jump directly to definitions during complex refactoring tasks.

Do I need ctags installed to search for code symbol definitions?

Yes, you need the ctags utility installed in your containerized environment to generate the required index. The source directory must also be pre-indexed or indexable to ensure the search returns accurate file paths and line numbers.

What is the best way to navigate code definitions when debugging a complex project?

Using ctags indexing is the best way to navigate code definitions when debugging, as it eliminates manual file searches and immediately jumps to specific symbol locations. This significantly accelerates debugging and architectural analysis tasks across multiple files.

Can I use this symbol search tool on a containerized development environment?

Yes, this symbol search tool is designed to locate code definitions within a containerized environment using ctags indexing. It facilitates rapid codebase navigation by returning accurate file paths and line numbers directly from your containerized source directory.

What are the limitations of using ctags for codebase navigation?

The main limitation of using ctags for codebase navigation is that it requires a pre-indexed or indexable source directory to return accurate results. If the codebase changes frequently, the index must be regenerated to maintain search accuracy.