project-audit

Audit project directories for clutter and generate categorized cleanup plans.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/Albatross679/0313temp --skill project-audit-albatross679
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-audit
Source: https://github.com/Albatross679/0313temp/tree/main/.claude/skills/project-audit
Command: npx skills add https://github.com/Albatross679/0313temp --skill project-audit-albatross679

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit a project directory for clutter, unused files, uncommitted changes, stale artifacts, and large runtime directories -- then present categorized recommendations the user can selectively execute. Use when the user asks to "organize", "clean up", "audit", "declutter", or tidy up a project or directory, or asks about unused files, stale artifacts, what to gitignore, or how to reduce project size.

Core Features & Use Cases

  • Scan phase: git status checks, runtime/cache size measurements, root-level clutter detection.
  • Categorize: group findings into Gitignore gaps, Archive candidates, Delete candidates, and Commit-ready changes.
  • Report & execution: present a structured plan and execute user-approved actions (gitignore updates, moves to archive, deletions, commits) with safety prompts.

Quick Start

Run the audit on your project directory to generate a prioritized, actionable cleanup plan.

Frequently Asked Questions about project-audit

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

FAQPage Schema
How do I audit a project directory for clutter and unused files?

Auditing a project directory involves scanning for root-level clutter, measuring runtime and cache sizes, and checking git status to categorize findings into gitignore gaps, archive candidates, and delete candidates for actionable cleanup.

What is the best way to find stale artifacts and oversized runtime directories before a release?

The best way to find stale artifacts is running a scan phase that measures cache sizes and detects root-level clutter, then categorizes them into a structured cleanup plan to execute user-approved deletions safely.

How do I determine what to add to gitignore for unused files in my repository?

You can determine what to add to gitignore by running an audit that categorizes unused files and runtime directories into gitignore gaps during the scan phase, presenting structured recommendations to selectively update your repository configuration.

Does this project cleanup approach work on any software repository?

Yes, this project cleanup approach applies to any software project repository by scanning for uncommitted changes, stale artifacts, and large runtime directories to guide users through actionable cleanup steps before refactors or onboarding.

Can I automatically delete unused files during a project audit?

You cannot automatically delete unused files without approval during a project audit; the tool presents a structured plan categorizing delete candidates and executes user-approved actions with safety prompts to move items to archive or perform deletions.