Orphan file finder

Skill dcs-soni/skills/orphan-file-finder

A collection of custom Claude Code Skills to supercharge your development workflow.

Install

npx -y skills add dcs-soni/skills --skill orphan-file-finder

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.7 KB, as published. Nobody here has run it

Orphan File Finder

Detects "orphan" source files—those with no inbound references—to surface potentially unused code.

Why This Matters

Reduce Technical Debt: Unused files rot over time and mislead developers.
Shrink Bundle Size: Dead code might still be bundled or deployed.
Security: Forgotten endpoints or scripts can be attack vectors.

Quick Start

Orphan File Cleanup:
- [ ] Step 1: Scan codebase for orphans
- [ ] Step 2: Review and whitelist entry points
- [ ] Step 3: Archive or delete verified dead files

Workflow

Step 1: Scan for Orphans

Analyze the dependency graph to find files with 0 inbound imports:

python scripts/find_orphans.py <directory>

What it does:

Indexes all source files (.js, .ts, .py).
Parses imports to build a directed graph.
Reports files that no other file imports.

Step 2: Review & Verify

The script output splits findings into:

Potential Orphans: Files with no imports.
Likely Entry Points: Files matching patterns like index.js, main.py, server.ts.

Example output:

Found 12 potential orphan files.

Likely Entry Points (whitelist these?):
- src/index.ts
- src/cli.ts

Potential True Orphans:
- src/legacy/OldHelper.ts
- src/utils/Deprecated.js

Step 3: Archive or Delete

Once verified:

Move to a _archive/ folder if unsure.
Or delete: rm src/legacy/OldHelper.ts

Configuration

Auto-Whitelisted Patterns:

index.js/ts/jsx/tsx
main.py/js/ts
server.js/ts
app.js/ts
cli.js/py
setup.py
manage.py (Django)
vite.config.*, webpack.config.*

Supported Import Styles:

JS/TS: import ... from, require(...), export ... from
Python: import module, from module import ...

Utility Scripts

Script	Purpose
`find_orphans.py`	Builds dependency graph and identifies disconnected nodes

Related Skills

stale-todo-finder — Clean up old comments while cleaning up old files.
codebase-onboarding — Understanding the graph helps with onboarding.