codemaid

Detect dead files, stale references, and unused dependencies across codebases.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/dallas05ll/codemaid --skill codemaid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codemaid
Source: https://github.com/dallas05ll/codemaid/tree/main/.claude/skills/codemaid
Command: npx skills add https://github.com/dallas05ll/codemaid --skill codemaid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codebases often accumulate dead code, broken references, and unused dependencies that degrade reliability and slow down development. This Skill helps teams quickly identify and address these hygiene issues so code remains healthy.

Core Features & Use Cases

  • Dead-file detection across entry points to reveal orphaned files and reduce maintenance cost.
  • Stale-reference and doc-drift checks to keep imports and documentation aligned with the codebase.
  • Confidence-tagged results and JSON output for agent workflows, plus interactive console reports for human review.

Quick Start

Install codemaid and run npx codemaid scan to generate a structured JSON report.

Frequently Asked Questions about codemaid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find dead code and unused dependencies in my codebase?

Stale reference detection checks imports and documentation against the actual codebase to identify doc-drift and broken references. This keeps documentation aligned with code across supported languages like JavaScript, Python, and Markdown.

Can I automate codebase cleanup with JSON output for agent workflows?

Static analysis for codebase cleanup includes safety features like dry-run and backups. These features prevent accidental data loss during cleanup by allowing you to preview changes and restore previous states before permanently removing dead files or unused dependencies.

Does this dead code detection tool work with Python and JavaScript?

Dead code detection works with JavaScript, Python, Markdown, and other supported languages. It scans across entry points in these languages to reveal orphaned files and unused dependencies, ensuring codebase hygiene across multiple file formats.

What is the safest way to remove unused dependencies and dead files?

The safest way to remove unused dependencies and dead files is to use a dry-run before applying changes. This static analysis approach provides confidence-tagged results and creates backups, ensuring you can review detected issues without immediately altering the codebase.