Rust Code Navigator

What it does

The Rust Code Navigator skill enables AI agents to efficiently navigate and understand Rust code within your Actionbook project's backend. It leverages the Language Server Protocol (LSP) to provide features like finding definitions, locating references, and displaying type information and documentation for symbols. This allows users to quickly locate, debug, and comprehend Rust code without manually searching through files.

When to use it

This skill is useful in the following scenarios:

• When you need to find where a specific symbol (e.g., function, struct) is defined.
• To understand the purpose or type of a particular piece of code.
• Before refactoring or renaming code to see all its usages and potential impact.
• As a replacement for common IDE actions like Ctrl+click "Go To Definition".

Key capabilities

• Go to Definition: Finds where a symbol is defined in the codebase.
• Find References: Locates all instances where a symbol is used.
• Hover Information: Displays type information and documentation for a given symbol.
• Workspace Symbol Search: Searches for symbols across the entire workspace (e.g., "find all structs").

Example prompts

Here are some example prompts you can give an AI agent with this skill:

• "/rust-code-navigator parse_config" - Finds the definition of the parse_config function.
• "/rust-code-navigator MyStruct in src/lib.rs:42" - Navigates to a specific location within the code.
• "Where is the Config struct defined?"

Tips & gotchas

• Prerequisite: Requires rust-analyzer to be running, as it provides the LSP server. If you encounter "No LSP server" errors, ensure that rustup component add rust-analyzer has been run.
• Multiple Definitions: When a symbol has multiple definitions (e.g., due to generics or macros), the skill will present all options for the user to choose from.