gabb-code-navigation
Decision guide for code navigation. Teaches when to use gabb tools vs defaulttools (Grep/Read) for maximum efficiency. Applies to Python/TypeScript/Rust/Kotlin/C++.
Security Assessment
About gabb-code-navigation
The gabb-code-navigation skill provides a structured approach to efficiently navigating and understanding code across multiple programming languages, including Python, TypeScript, Rust, Kotlin, and C++. It helps developers decide when to use specialized gabb tools versus traditional methods like Grep or Read, optimizing the search for symbols, file structures, and text content. By offering a clear decision flow, this skill minimizes unnecessary exploration and reduces the risk of retrieving irrelevant results, ultimately saving time and cognitive load during code analysis or debugging tasks.
The main features of gabb-code-navigation include workspace symbol search (`gabb_symbol`) for quickly locating functions, classes, or methods by name, and file layout previews (`gabb_structure`) for efficiently understanding the structure of large or unfamiliar files. The skill provides guidance on when to fall back to Grep/Read for searching text content, error messages, or unsupported file types. It supports a range of file extensions specific to the supported languages and offers quick reference examples for common tasks like finding symbol definitions, previewing file structures, and locating usages before refactoring.
This skill is particularly useful for developers working in multi-language codebases who need to locate code elements quickly and accurately without sifting through unnecessary information. It is ideal for those performing code reviews, debugging, or exploring unfamiliar repositories. By guiding users on the appropriate tool for each task, gabb-code-navigation enhances productivity and ensures that developers focus their efforts on the most relevant parts of the code, making it a practical tool for both individual contributors and teams maintaining complex projects.
FAQ
Which programming languages are supported by gabb-code-navigation?
The skill supports Python (.py, .pyi), TypeScript (.ts, .tsx), Rust (.rs), Kotlin (.kt, .kts), and C++ (.cpp, .cc, .cxx, .hpp, .hh). For other languages like JavaScript, Go, Java, C, and header files, Grep/Read should be used instead.
When should I use `gabb_symbol` versus Grep?
`gabb_symbol` should be used when searching for functions, classes, or methods by name across the workspace, especially when Grep would return too many false positives. Grep is better for searching text content such as error messages, string literals, or comments.
How does `gabb_structure` help with large files?
`gabb_structure` provides a preview of a file's layout, allowing you to understand the structure before reading the entire content. This is useful for large files (>100 lines) or unfamiliar codebases, helping to save tokens and focus on relevant sections.
Can gabb-code-navigation handle configuration or non-code files?
No, the skill is optimized for code navigation. For configuration files, documentation, or unsupported file types like .json or .md, it is recommended to use Grep or Read.
Who benefits most from using this skill?
Developers exploring unfamiliar repositories, performing code reviews, debugging, or needing to locate code elements efficiently will benefit the most. It is suitable for individual contributors and teams working across multiple programming languages.
Install gabb-code-navigation
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
gabb-software/gabb-cli