parcadei

dead-code

Find unused functions and dead code in the codebase

parcadei 3,930 299 Updated 7mo ago
GitHub

Install

npx skillscat add parcadei/continuous-claude-v3/dead-code

Install via the SkillsCat registry.

About this skill

This skill identifies unused functions and dead code in a codebase using static analysis. It helps developers locate code that is never called or unreachable, which can be removed to reduce maintenance burden and potential confusion. An agent or developer should use it when cleaning up a codebase, refactoring legacy code, or verifying that recently removed features have no remaining references.

SKILL.md

Dead Code Detection

Find unused functions and dead code using TLDR static analysis.

Quick Start

# Scan entire project
tldr dead .

# Scan specific directory
tldr dead src/

# Specify entry points (functions to exclude from analysis)
tldr dead . --entry main cli test_

# Specify language
tldr dead . --lang python
tldr dead . --lang typescript

Output Format

Dead code analysis:
  Total functions: 150
  Dead functions: 12

Unused functions:
  - old_helper (src/utils.py:42)
  - deprecated_func (src/legacy.py:15)
  - _unused_method (src/api.py:230)

Cross-Platform

Works on Windows, Mac, and Linux (including WSL).

# Windows (PowerShell)
tldr dead .

# Mac/Linux
tldr dead .

Entry Points

Functions matching entry patterns are excluded from dead code analysis:

  • main, cli - Application entry points
  • test_*, *_test - Test functions
  • setup, teardown - Fixtures
  • @app.route, @api.endpoint - Framework handlers
# Custom entry points
tldr dead src/ --entry main api_handler background_job

Integration

This skill replaces the session-start-dead-code hook with on-demand analysis.

Approach Pros Cons
Hook (removed) Automatic Slowed startup by 3s
Skill (this) On-demand, fast Manual invocation

Related Commands

# Impact analysis (who calls this?)
tldr impact func_name .

# Architecture layers
tldr arch src/

# Full codebase structure
tldr structure . --lang python