gabb-code-navigation
Teaches when to use gabb_structure for efficient file exploration.Use gabb_structure before reading large files in supported languages.
Security Assessment
About gabb-code-navigation
The gabb-code-navigation skill is designed to streamline the process of exploring and understanding codebases efficiently. It provides structured guidance on when to use different code exploration tools, particularly emphasizing the use of `gabb_structure` before reading large files. By doing so, it helps reduce unnecessary reading and token usage when dealing with unfamiliar or sizable code files. This skill solves the problem of inefficient file navigation, preventing developers from wasting time on irrelevant sections and aiding them in quickly locating the components they need to inspect or modify.
The skill offers several main features and capabilities. It includes `gabb_symbol` for searching functions, classes, and methods across a workspace, allowing precise symbol-based searches rather than general text searches that may produce false positives. Additionally, it provides `gabb_structure` to preview file layouts, summarizing key symbols, types, and line counts, which is particularly useful for large files or new codebases. The skill also provides a clear decision flow for choosing the appropriate search strategy based on task requirements, such as directly reading files, using symbol search, performing text searches, or previewing file structures. Supported languages include Python, TypeScript, Rust, Go, Kotlin, and C++, covering a broad range of development environments.
Typical use cases for this skill include navigating large or unfamiliar codebases, quickly locating definitions of functions or classes, and previewing file structures before reading specific sections. Target users are developers, code reviewers, and software engineers who need to explore code efficiently, reduce cognitive load when dealing with large files, and avoid unnecessary token usage in AI-assisted coding workflows. The skill is particularly valuable for tasks where developers need to locate specific symbols, understand file layout, or focus on relevant sections of a file without reading it in its entirety.
FAQ
When should I use `gabb_structure`?
`gabb_structure` should be used before reading large or unfamiliar files to preview the file layout and symbols. It's recommended for files over 100 lines, files you'll read multiple times, or codebases you're exploring for the first time.
Which programming languages are supported?
The skill supports Python, TypeScript, Rust, Go, Kotlin, and C++ with their respective file extensions as listed in the documentation.
When is `gabb_symbol` preferred over Grep?
`gabb_symbol` is preferred when you need to locate functions, classes, or methods by name across the workspace. Grep is more suitable for searching error messages, string literals, or text patterns.
Can I use `gabb_structure` for small files or trivial tasks?
It's generally not necessary to use `gabb_structure` for small files (less than 100 lines) or when you already know exactly what you're looking for. In such cases, reading the file directly is more efficient.
Does `gabb_structure` show string literals or regex matches?
No, `gabb_structure` only displays symbols like functions, classes, and methods. For searching strings, error messages, or regex patterns, you should use Grep instead.
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