Agent skill

clean-code-dead-code-identification-and-removal

Sub-skill of clean-code: Dead Code Identification and Removal.

Stars 4
Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/_archive/workspace-hub/clean-code/dead-code-identification-and-removal

SKILL.md

Dead Code Identification and Removal

Dead Code Identification and Removal

Dead code is any code that is never called, imported, or referenced.

bash
# Find files that nothing imports (potential dead modules)
# Run from repo root:
python3 -c "
import ast, os, sys
from pathlib import Path

src = Path('src')
all_files = list(src.rglob('*.py'))
imported = set()

for f in all_files:
    try:
        tree = ast.parse(f.read_text())
        for node in ast.walk(tree):
            if isinstance(node, (ast.Import, ast.ImportFrom)):
                if hasattr(node, 'module') and node.module:
                    imported.add(node.module.split('.')[-1])
    except:
        pass

for f in all_files:
    stem = f.stem
    if stem not in imported and stem != '__init__':
        print(f)
"

Common dead code patterns to delete:

  • *_unused.py — explicitly named dead code
  • *_old.py, *_bak.py, *.py.bak — backup files (use git, not backup files)
  • Files with only pass in every function
  • Commented-out code blocks >5 lines (use git history instead)
  • __all__ = [] with no exports (likely orphaned)

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results