skills.rest
aifuun
aifuunCOMMUNITY
Explore all skills by this author →
GitHub

cleanup-project

Clean temporary project files and update .gitignore for local repositories.

Updated Mar 8, 2026
Search Tags:#python#cleanup#gitignore#health-check#dry-run#temp-files#profile-aware
One-click install
npx skills add https://github.com/aifuun/u-safe-archive --skill cleanup-project-aifuun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cleanup-project
Source: https://github.com/aifuun/u-safe-archive/tree/main/.claude/skills/cleanup-project
Command: npx skills add https://github.com/aifuun/u-safe-archive --skill cleanup-project-aifuun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Many repositories accumulate large temporary build artifacts, caches, and framework state files that consume disk space and complicate backups; this Skill automates safe removal while avoiding accidental deletion of source, configs, and tracked files.

Core Features & Use Cases

  • Profile-aware scanning: Detects tauri, nextjs-aws, or common project profiles and applies targeted cleanup rules for build artifacts, node_modules, .next, target, and Python caches.
  • Safety-first deletion: Enforces a whitelist (never delete: .git, .env, source files, docs, framework settings), checks git-tracked status, supports dry-run previews, and requires confirmation unless forced.
  • Health checks and maintenance: Finds large unignored files and recommends .gitignore updates; suitable for monthly maintenance, CI workspace cleanup, or urgent disk-space recovery.

Quick Start

Use the cleanup-project skill to preview temporary file deletions with a dry-run and then run cleanup to remove the listed items.

Frequently Asked Questions about cleanup-project

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

FAQPage Schema
How do I safely clean temporary build artifacts and caches in a Next.js or Tauri project?▼

To safely clean temporary build artifacts, use profile-aware scanning to detect Tauri, Next.js, or common project profiles and apply targeted cleanup rules for node_modules, .next, target, and Python caches. It enforces a whitelist to never delete source files, .git, or .env.

Can I preview temporary file deletions before actually removing them?▼

Yes, you can preview temporary file deletions using a dry-run mode. This mode lists the exact items targeted for removal before any action is taken, ensuring no critical files are accidentally deleted.

Does the cleanup process skip files that are tracked by Git?▼

Yes, the cleanup process skips Git-tracked files. It checks the git-tracked status during scanning to ensure only untracked temporary files and build artifacts are removed.

How do I find large unignored files and update my .gitignore?▼

You can find large unignored files and update .gitignore by running a health check. This maintenance mode identifies large unignored files and recommends specific .gitignore updates to improve repository hygiene.

Do I need Python and Git installed to reclaim disk space from project temp files?▼

Yes, you need a Python runtime to run the cleanup script, while system utilities like Git and find are optional. These tools work together to check tracked status and safely reclaim disk space from temporary files.

What is the best way to automate CI workspace cleanup and reclaim disk space?▼

The best way to automate CI workspace cleanup is using a profile-aware script with force mode. This bypasses manual confirmation to automatically remove build artifacts and caches, urgently reclaiming disk space in automated environments.

Related Skills

Explore More Software Engineering Skills→
pattern-stackpattern-stack
1

create-worktree-skill

Create isolated Git worktrees with auto-incremented ports and environment files.

Official
Intermediate
idemeumidemeum

disk-cleanup

Scan disks for large, duplicate, stale, and cache files with consent-gated deletion.

Official
Advanced
niuhainiuhai
203

c-drive-cleaner

Analyze C-drive storage pressure and recommend safe cleanup actions.

Community
Advanced
u9401066u9401066

temp-cleaner

Remove temporary files, caches, and build artifacts from Python and Node.js projects.

Community
Basic