Dianel555/DSkills / skills/serena
serena
VerifiedSemantic code understanding with IDE-like symbol operations. Use when: (1) Large codebase analysis (>50 files), (2) Symbol-level operations (find, rename, refactor), (3) Cross-file reference tracking, (4) Project memory and session persistence, (5) Multi-language semantic navigation. Triggers: "find symbol", "rename function", "find references", "symbol overview", "project memory". IMPORTANT: Prioritize Serena's symbolic tools over file-based grep/read for code exploration.
| File | Kind | Size |
|---|---|---|
| .env.example | other | 619 B |
| README.md | markdown | 6.8 KB |
| SKILL.md | skill md | 7.1 KB |
| tools/__init__.py | script | 310 B |
| tools/__main__.py | script | 94 B |
| tools/cli/__init__.py | script | 3.4 KB |
| tools/cli/cmd.py | script | 1.0 KB |
| tools/cli/config.py | script | 1.1 KB |
| tools/cli/dashboard.py | script | 5.3 KB |
| tools/cli/file.py | script | 1.4 KB |
| tools/cli/memory.py | script | 1.5 KB |
| tools/cli/symbol.py | script | 3.7 KB |
| tools/cli/workflow.py | script | 780 B |
| tools/core.py | script | 7.8 KB |
| tools/extended/__init__.py | script | 30 B |
| tools/extended/cmd_tools.py | script | 3.7 KB |
| tools/extended/config_tools.py | script | 4.9 KB |
| tools/output.py | script | 402 B |
| tools/paths.py | script | 1.5 KB |
| tools/server/__init__.py | script | 110 B |
| tools/server/dashboard_server.py | script | 14.1 KB |
| tools/tests/__init__.py | script | 30 B |
| tools/tests/conftest.py | script | 256 B |
| tools/tests/test_cli_dashboard.py | script | 3.0 KB |
| tools/tests/test_cli_file.py | script | 3.4 KB |
| tools/tests/test_cli_memory.py | script | 2.6 KB |
| tools/tests/test_core.py | script | 5.4 KB |
| tools/tests/test_module_path.py | script | 3.0 KB |
| tools/tests/test_paths.py | script | 2.8 KB |
tools/cli/symbol.py
View on GitHub"""Symbol operations command group."""
import typer
from typing import Optional
from . import State
from ..output import output_json
app = typer.Typer(help="Symbol operations (find, overview, references, edit)")
@app.command("find")
def find_symbol(
name_path: str = typer.Argument(..., help="Symbol name or path pattern"),
path: Optional[str] = typer.Option(None, "--path", "-p", help="Restrict search to file/directory"),
body: bool = typer.Option(False, "--body", "-b", help="Include symbol body in output"),
depth: int = typer.Option(0, "--depth", "-d", help="Depth for nested symbols (0=current level only)"),
exact: bool = typer.Option(False, "--exact", "-e", help="Exact match (disable substring matching)"),
):
"""Find symbols by name or path pattern."""
result = State.core.call_tool(
"find_symbol",
name_path=name_path,
relative_path=path,
include_body=body,
depth=depth,
substring_matching=not exact,
)
output_json(result)
@app.command("overview")
def symbols_overview(
path: str = typer.Argument(..., help="File path to analyze"),
):
"""List all symbols in a file."""
result = State.core.call_tool(
"get_symbols_overview",
relative_path=path,
)
output_json(result)
@app.command("refs")
def find_refs(
name_path: str = typer.Argument(..., help="Symbol name or path"),
path: Optional[str] = typer.Option(None, "--path", "-p", help="Restrict search to file/directory"),
snippets: bool = typer.Option(True, "--snippets/--no-snippets", help="Include code snippets"),
):
"""Find references to a symbol."""
result = State.core.call_tool(
"find_referencing_symbols",
name_path=name_path,
relative_path=path,
include_code_snippets=snippets,
)
output_json(result)
@app.command("replace")
def replace_symbol(
name_path: str = typer.Argument(..., help="Symbol name or path"),
path: str = typer.Option(..., "--path", "-p", help="File containing the symbol"),
body: str = typer.Option(..., "--body", "-b", help="New symbol body"),
):
"""Replace symbol body."""
result = State.core.call_tool(
"replace_symbol_body",
name_path=name_path,
relative_path=path,
new_body=body,
)
output_json(result)
@app.command("insert-after")
def insert_after(
name_path: str = typer.Argument(..., help="Symbol name or path"),
path: str = typer.Option(..., "--path", "-p", help="File containing the symbol"),
content: str = typer.Option(..., "--content", "-c", help="Content to insert"),
):
"""Insert content after a symbol."""
result = State.core.call_tool(
"insert_after_symbol",
name_path=name_path,
relative_path=path,
content=content,
)
output_json(result)
@app.command("insert-before")
def insert_before(
name_path: str = typer.Argument(..., help="Symbol name or path"),
path: str = typer.Option(..., "--path", "-p", help="File containing the symbol"),
content: str = typer.Option(..., "--content", "-c", help="Content to insert"),
):
"""Insert content before a symbol."""
result = State.core.call_tool(
"insert_before_symbol",
name_path=name_path,
relative_path=path,
content=content,
)
output_json(result)
@app.command("rename")
def rename_symbol(
name_path: str = typer.Argument(..., help="Symbol name or path"),
new_name: str = typer.Argument(..., help="New symbol name"),
path: str = typer.Option(..., "--path", "-p", help="File containing the symbol"),
):
"""Rename a symbol."""
result = State.core.call_tool(
"rename_symbol",
name_path=name_path,
relative_path=path,
new_name=new_name,
)
output_json(result)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |