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/tests/test_module_path.py
View on GitHub"""Regression test for module path fix.
This test ensures that the serena tools can be executed from the serena root directory
using 'python -m tools' command, which is the correct usage after skill installation.
Issue: Previously, SKILL.md and README.md used 'python -m skills.serena.tools' which
assumed execution from the parent directory of skills/, causing ModuleNotFoundError
when executed from the serena root directory.
Fix: Changed all command examples to 'python -m tools' for execution from serena root.
"""
import subprocess
import sys
from pathlib import Path
def test_module_execution_from_serena_root():
"""Test that 'python -m tools' works from serena root directory."""
serena_root = Path(__file__).parent.parent.parent
# Test basic command execution
result = subprocess.run(
[sys.executable, "-m", "tools", "--help"],
cwd=serena_root,
capture_output=True,
text=True,
timeout=10
)
assert result.returncode == 0, f"Command failed with: {result.stderr}"
assert "serena" in result.stdout.lower(), "Help text should mention serena"
def test_symbol_command_execution():
"""Test that symbol commands work correctly."""
serena_root = Path(__file__).parent.parent.parent
result = subprocess.run(
[sys.executable, "-m", "tools", "symbol", "--help"],
cwd=serena_root,
capture_output=True,
text=True,
timeout=10
)
assert result.returncode == 0, f"Symbol command failed: {result.stderr}"
assert "symbol" in result.stdout.lower()
def test_dashboard_command_execution():
"""Test that dashboard commands work correctly."""
serena_root = Path(__file__).parent.parent.parent
result = subprocess.run(
[sys.executable, "-m", "tools", "dashboard", "info"],
cwd=serena_root,
capture_output=True,
text=True,
timeout=10
)
assert result.returncode == 0, f"Dashboard command failed: {result.stderr}"
# Should return JSON output
assert "{" in result.stdout
def test_documentation_uses_correct_module_path():
"""Test that documentation files use 'python -m tools' instead of 'python -m skills.serena.tools'."""
serena_root = Path(__file__).parent.parent.parent
# Check SKILL.md
skill_md = (serena_root / "SKILL.md").read_text(encoding="utf-8")
assert "skills.serena.tools" not in skill_md, "SKILL.md should not contain 'skills.serena.tools'"
assert "python -m tools" in skill_md, "SKILL.md should contain 'python -m tools'"
# Check README.md
readme_md = (serena_root / "README.md").read_text(encoding="utf-8")
assert "skills.serena.tools" not in readme_md, "README.md should not contain 'skills.serena.tools'"
assert "python -m tools" in readme_md, "README.md should contain 'python -m tools'"
if __name__ == "__main__":
test_module_execution_from_serena_root()
test_symbol_command_execution()
test_dashboard_command_execution()
test_documentation_uses_correct_module_path()
print("✅ All regression tests passed!")
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 |