serena

Find symbol definitions and references, then perform semantic code edits.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/sandriaas/_dotfiles --skill serena-sandriaas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: serena
Source: https://github.com/sandriaas/_dotfiles/tree/main/local/.claude/skills/serena
Command: npx skills add https://github.com/sandriaas/_dotfiles --skill serena-sandriaas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill replaces inefficient text-based code searching and manual editing with intelligent, symbol-aware operations, making code navigation and modification faster and more reliable.

Core Features & Use Cases

  • Symbol Discovery: Quickly find functions, classes, types, and their references within a codebase.
  • Semantic Editing: Safely modify code implementations, insert code adjacent to symbols, and perform symbol-aware replacements.
  • Use Case: When refactoring a large project, use find_symbol to locate a specific function, then find_referencing_symbols to understand its impact, and finally replace_symbol_body to update its implementation without breaking other parts of the code.

Quick Start

Use the serena skill to find the definition of the 'User' class in the current project.

Frequently Asked Questions about serena

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find all references to a specific symbol in my codebase?

To find symbol references, use semantic code navigation tools to locate definitions and find referencing symbols across the codebase. This symbol-aware approach ensures safe refactoring by understanding impact before modifying code.

What's the best way to refactor a function across a large project?

The best way to refactor a function is using semantic editing to locate the symbol, analyze its references, and replace its implementation safely. This prevents breaking other parts of the codebase compared to traditional text-based replacement.

How does semantic code analysis work for navigating codebases?

Semantic code analysis works by understanding code intelligence and symbol structures, allowing you to find functions, classes, and types. It prioritizes symbol-aware operations over traditional text searches to navigate and modify codebases efficiently.

Can I safely modify code implementations without breaking references?

Yes, you can safely modify code implementations by using symbol-aware operations to insert code adjacent to symbols and perform replacements. Finding referencing symbols first ensures modifications do not break other parts of the project.

Why should I use semantic code search instead of text-based search?

You should use semantic code search because it replaces inefficient text-based searching with intelligent, symbol-aware operations. This makes code navigation and modification faster and more reliable by understanding deep code structures rather than just matching text strings.

How do I insert new code adjacent to existing functions during refactoring?

To insert new code adjacent to existing functions, use semantic editing capabilities that allow symbol-aware modifications. This ensures the inserted code integrates correctly with the surrounding symbol structure without disrupting the overall codebase.