AI SummaryTeaches Claude when to use gabb_structure and gabb_symbol tools for efficient code exploration and navigation in supported languages. Developers working with large codebases benefit from optimized search strategies that reduce unnecessary file reads.
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to install the "gabb-code-navigation" skill in my project. Please run this command in my terminal: # Install skill into the correct directory (2 files) mkdir -p .claude/skills/assets && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/assets/SKILL.md "https://raw.githubusercontent.com/gabb-software/gabb-cli/main/assets/SKILL.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/assets/MCP_INSTRUCTIONS.md "https://raw.githubusercontent.com/gabb-software/gabb-cli/main/assets/MCP_INSTRUCTIONS.md" Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.
Description
Teaches when to use gabb_structure for efficient file exploration. Use gabb_structure before reading large files in supported languages.
Search Strategy Decision Flow
When you need to find code, follow this order: • Task names specific file/function? → Read directly (skip exploration) • Looking for a code construct by name? → gabb_symbol • Looking for text content (strings, error messages)? → Grep • Need to understand file layout? → gabb_structure
`gabb_symbol` - Workspace Symbol Search
Search for symbols (functions, classes, methods) by name across the workspace. When to use: • Task mentions a function/class/method name to find or fix • You need to find where something is defined • Grep would return too many false positives Example: ` gabb_symbol name="update_proxy_model_permissions" → function update_proxy_model_permissions [prod] migrations/0011_update_proxy_permissions.py:5:1 ` Use Grep instead when: • Searching for error messages or string literals • Looking for text patterns, not code identifiers
`gabb_structure` - File Layout Preview
First: Assess if exploration is needed (see MCP instructions). For trivial tasks with obvious targets, go directly to the file. If exploring: Before reading large or unfamiliar code files, consider using gabb_structure to preview the layout. This saves tokens when you only need part of a large file. Recommended for: • Large files (>100 lines) where you only need part • Unfamiliar codebases where you're exploring • Files you'll read multiple times Skip when: • You already know exactly what you're looking for • The file is likely small (<100 lines) • You can answer from existing context • Files you've already seen structure for in this conversation • You're searching for string literals, regex patterns, or error messages (gabb_structure shows symbols, not strings—use Grep directly)
Supported Languages
| Language | Extensions | |------------|----------------------------------------| | Python | .py, .pyi | | TypeScript | .ts, .tsx | | Rust | .rs | | Go | .go | | Kotlin | .kt, .kts | | C++ | .cpp, .cc, .cxx, .hpp, .hh |
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster