rust-code-navigator

SKILL.md

Rust Code Navigator

Navigate large Rust codebases efficiently using Language Server Protocol.

Usage

/rust-code-navigator <symbol> [in file.rs:line]

Examples:

/rust-code-navigator parse_config - Find definition of parse_config

/rust-code-navigator MyStruct in src/lib.rs:42 - Navigate from specific location

LSP Operations

1. Go to Definition

Find where a symbol is defined.
LSP(
  operation: "goToDefinition",
  filePath: "src/main.rs",
  line: 25,
  character: 10
)

Use when:

User asks "where is X defined?"

User wants to understand a type/function

Ctrl+click equivalent

2. Find References

Find all usages of a symbol.

LSP(
  operation: "findReferences",
  filePath: "src/lib.rs",
  line: 15,
  character: 8
)

Use when:

User asks "who uses X?"

Before refactoring/renaming

Understanding impact of changes

3. Hover Information

Get type and documentation for a symbol.

LSP(
  operation: "hover",
  filePath: "src/main.rs",
  line: 30,
  character: 15
)

Use when:

User asks "what type is X?"

User wants documentation

Quick type checking

Workflow

User: "Where is the Config struct defined?"
    │
    ▼
[1] Search for "Config" in workspace
    LSP(operation: "workspaceSymbol", ...)
    │
    ▼
[2] If multiple results, ask user to clarify
    │
    ▼
[3] Go to definition
    LSP(operation: "goToDefinition", ...)
    │
    ▼
[4] Show file path and context
    Read surrounding code for context

Output Format

Definition Found

## Config (struct)

**Defined in:** `src/config.rs:15`

​```rust
#[derive(Debug, Clone)]
pub struct Config {
    pub name: String,
    pub port: u16,
    pub debug: bool,
}
​```

**Documentation:** Configuration for the application server.

References Found

## References to `Config` (5 found)

| Location | Context |
|----------|---------|
| src/main.rs:10 | `let config = Config::load()?;` |
| src/server.rs:25 | `fn new(config: Config) -> Self` |
| src/server.rs:42 | `self.config.port` |
| src/tests.rs:15 | `Config::default()` |
| src/cli.rs:8 | `config: Option<Config>` |

Common Patterns

User Says
LSP Operation

"Where is X defined?"
goToDefinition

"Who uses X?"
findReferences

"What type is X?"
hover

"Find all structs"
workspaceSymbol

"What's in this file?"
documentSymbol

Error Handling

Error
Cause
Solution

"No LSP server"
rust-analyzer not running
Suggest: rustup component add rust-analyzer

"Symbol not found"
Typo or not in scope
Search with workspaceSymbol first

"Multiple definitions"
Generics or macros
Show all and let user choose

Related Skills

When
See

Call relationships
rust-call-graph

Project structure
rust-symbol-analyzer

Trait implementations
rust-trait-explorer

Safe refactoring
rust-refactor-helper