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/extended/cmd_tools.py
View on GitHub"""Command execution tools with structured output."""
from typing import Optional, Type, Dict, Any
import subprocess
import shlex
import json
from pathlib import Path
from pydantic import BaseModel, Field
try:
from serena.tools.base import BaseTool
except ImportError:
class BaseTool:
pass
class RunCommandInput(BaseModel):
command: str = Field(..., description="The shell command to execute")
cwd: Optional[str] = Field(None, description="Working directory for execution")
timeout: Optional[int] = Field(300, description="Timeout in seconds")
class RunCommandTool(BaseTool):
name = "run_command"
description = "Execute a shell command on the system. Use with caution."
args_schema: Type[BaseModel] = RunCommandInput
def _execute(self, command: str, cwd: Optional[str], timeout: int) -> Dict[str, Any]:
"""Internal method returning structured data."""
try:
process = subprocess.run(
command,
shell=True,
cwd=cwd,
capture_output=True,
text=True,
timeout=timeout
)
return {
"exit_code": process.returncode,
"stdout": process.stdout,
"stderr": process.stderr,
}
except subprocess.TimeoutExpired:
return {
"error": {
"code": "TIMEOUT",
"message": f"Command timed out after {timeout} seconds"
}
}
except Exception as e:
return {
"error": {
"code": "RUNTIME_ERROR",
"message": str(e)
}
}
def _run(self, command: str, cwd: Optional[str] = None, timeout: int = 300) -> str:
"""BaseTool-compatible method returning JSON string."""
result = self._execute(command, cwd, timeout)
return json.dumps(result, ensure_ascii=False)
class RunScriptInput(BaseModel):
script_path: str = Field(..., description="Path to the script file")
args: Optional[str] = Field(None, description="Arguments for the script")
class RunScriptTool(BaseTool):
name = "run_script"
description = "Execute a local script file (python, bash, etc.)"
args_schema: Type[BaseModel] = RunScriptInput
def _execute(self, script_path: str, args: Optional[str]) -> Dict[str, Any]:
"""Internal method returning structured data."""
import sys
path = Path(script_path)
if not path.exists():
return {
"error": {
"code": "FILE_NOT_FOUND",
"message": f"Script not found at {script_path}"
}
}
cmd = []
if path.suffix == '.py':
cmd = [sys.executable, str(path)]
elif path.suffix == '.sh':
cmd = ['bash', str(path)]
else:
cmd = [str(path)]
if args:
cmd.extend(shlex.split(args))
try:
process = subprocess.run(
cmd,
capture_output=True,
text=True
)
return {
"exit_code": process.returncode,
"stdout": process.stdout,
"stderr": process.stderr,
}
except Exception as e:
return {
"error": {
"code": "RUNTIME_ERROR",
"message": str(e)
}
}
def _run(self, script_path: str, args: Optional[str] = None) -> str:
"""BaseTool-compatible method returning JSON string."""
result = self._execute(script_path, args)
return json.dumps(result, ensure_ascii=False)
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 |