prune-dead-code

Original：🇺🇸 English

Translated

Audit a codebase for dead and otherwise safe-to-remove code, and report each finding for approval. Use when asked to find dead or unused code, deduplicate repeated constants, replace magic literals that duplicate a named constant, or remove arbitrary caps, thresholds, or timeouts.

4installs

Sourcelukeberrypi/skills

Added on2026-08-12

NPX Install

npx skill4agent add lukeberrypi/skills prune-dead-code

SKILL.md Content

View Translation Comparison →

Prune Dead Code

Treat every declaration as live until you have proven it safe to remove. Find candidates in four categories, verify each one across the whole repository, and report them all for approval before editing.

Workflow

Search each category across the whole repository, code and tests alike.
Verify every candidate's usage before judging it; one missed reference makes the verdict wrong.
Classify each candidate as safe to remove or arbitrary but intentional.
Report the table below.
Ask which findings to apply before editing.
Apply approved changes and update affected tests.
Run typecheck, lint, and tests; fix anything the changes broke.

Required Output

Use exactly these columns:

markdown

| Item | Location | Notes |
|------|----------|-------|
| `<symbol>` | `path:line` | Zero references repo-wide (verified). Confirmed dead. |
| `<constant>` | `pathA:line`, `pathB:line` | Identical declaration in 2 files. Dedupe into one shared constant. |
| literal `<value>` | `path:line` | Duplicates `<NAMED_CONSTANT>`; reference the constant to avoid drift. |
| `<CAP>` | `path:line` | Threshold unreachable in practice (state the real limit). Safe to remove. |

Item: Exact declaration in backticks, or a short phrase for inline literals.
Location:
```
path:line
```
; include every dedupe and drift location.
Notes: In one sentence, identify the item, confirm usage, and give the verdict.

Rules

When in doubt, it stays live — remove only what you have proven dead.

A symbol used only in its own file may be unexported, not deleted; cross-file consumers require it to stay exported.
Check tests before removing exports. Keep exports that cover non-trivial logic, or flag the trade-off.
Keep intentional tuning values — animation timings, debounce intervals, sizes, minimums — and report them as arbitrary but intentional.
Keep validation and guards that prevent crashes on corrupt or missing data.
Treat uncertain dynamic access, reflection, constructed imports, public APIs, and framework entry points as live.