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/config_tools.py
View on GitHub"""Configuration file tools with structured output."""
from typing import Optional, Type, Dict, Any
import json
import yaml
from pathlib import Path
from pydantic import BaseModel, Field
try:
from serena.tools.base import BaseTool
except ImportError:
class BaseTool:
pass
class ReadConfigInput(BaseModel):
path: str = Field(..., description="Path to configuration file")
format: Optional[str] = Field(None, description="Format (json, yaml). Auto-detected if None")
class ReadConfigTool(BaseTool):
name = "read_config"
description = "Read a configuration file (JSON/YAML) into a dictionary"
args_schema: Type[BaseModel] = ReadConfigInput
def _execute(self, path: str, format: Optional[str]) -> Dict[str, Any]:
"""Internal method returning structured data."""
file_path = Path(path)
if not file_path.exists():
return {
"error": {
"code": "FILE_NOT_FOUND",
"message": f"File not found at {path}"
}
}
try:
content = file_path.read_text(encoding='utf-8')
fmt = format.lower() if format else file_path.suffix.lstrip('.')
if fmt in ['json']:
data = json.loads(content)
elif fmt in ['yaml', 'yml']:
data = yaml.safe_load(content)
else:
return {
"error": {
"code": "UNSUPPORTED_FORMAT",
"message": f"Unsupported format {fmt}. Use json or yaml."
}
}
return {"config": data}
except Exception as e:
return {
"error": {
"code": "PARSE_ERROR",
"message": str(e)
}
}
def _run(self, path: str, format: Optional[str] = None) -> str:
"""BaseTool-compatible method returning JSON string."""
result = self._execute(path, format)
return json.dumps(result, indent=2, ensure_ascii=False)
class UpdateConfigInput(BaseModel):
path: str = Field(..., description="Path to configuration file")
key: str = Field(..., description="Dot-notation key to update (e.g. 'server.port')")
value: str = Field(..., description="New value (parsed as JSON if possible)")
class UpdateConfigTool(BaseTool):
name = "update_config"
description = "Update a specific key in a configuration file"
args_schema: Type[BaseModel] = UpdateConfigInput
def _set_nested(self, data: Dict, key: str, value: Any):
"""Set nested dictionary value using dot notation."""
parts = key.split('.')
current = data
for part in parts[:-1]:
if part not in current:
current[part] = {}
current = current[part]
if not isinstance(current, dict):
raise ValueError(f"Cannot traverse path {key}: {part} is not a dict")
current[parts[-1]] = value
def _parse_value(self, value_str: str) -> Any:
"""Parse value string as JSON or return as string."""
try:
return json.loads(value_str)
except:
return value_str
def _execute(self, path: str, key: str, value: str) -> Dict[str, Any]:
"""Internal method returning structured data."""
file_path = Path(path)
if not file_path.exists():
return {
"error": {
"code": "FILE_NOT_FOUND",
"message": f"File not found at {path}"
}
}
try:
content = file_path.read_text(encoding='utf-8')
fmt = file_path.suffix.lstrip('.').lower()
if fmt == 'json':
data = json.loads(content)
elif fmt in ['yaml', 'yml']:
data = yaml.safe_load(content) or {}
else:
return {
"error": {
"code": "UNSUPPORTED_FORMAT",
"message": f"Unsupported format {fmt}"
}
}
parsed_value = self._parse_value(value)
self._set_nested(data, key, parsed_value)
if fmt == 'json':
new_content = json.dumps(data, indent=2, ensure_ascii=False)
else:
new_content = yaml.safe_dump(data, allow_unicode=True)
file_path.write_text(new_content, encoding='utf-8')
return {"message": "Config updated successfully", "key": key, "value": parsed_value}
except Exception as e:
return {
"error": {
"code": "UPDATE_ERROR",
"message": str(e)
}
}
def _run(self, path: str, key: str, value: str) -> str:
"""BaseTool-compatible method returning JSON string."""
result = self._execute(path, key, value)
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 |