tidying-files

Remove untracked junk files across git repositories with dry-run and --fix options.

125|42|Updated May 19, 2025
One-click install
npx skills add https://github.com/SocketDev/socket-mcp --skill tidying-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tidying-files
Source: https://github.com/SocketDev/socket-mcp/tree/main/.claude/skills/fleet/tidying-files
Command: npx skills add https://github.com/SocketDev/socket-mcp --skill tidying-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The fleet accumulates OS cruft and editor backups across repositories, making environments cluttered and harder to maintain. This Skill provides a conservative, no-prompt cleanup that deletes only untracked or ignored files and never touches tracked work or submodules.

Core Features & Use Cases

  • Conservative, fleet-wide cleanup that never removes git-tracked files or submodule contents.
  • Dry-run by default; run with --fix to apply deletions across selected repos or the entire fleet.
  • Supports periodic maintenance with a /loop cadence to keep repositories tidy.

Quick Start

Run the tidy-files.mts script in dry-run mode to preview deletions, then run with --fix to apply the cleanup fleet-wide.

Frequently Asked Questions about tidying-files

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

FAQPage Schema
How do I safely remove OS cruft like .DS_Store and Thumbs.db across multiple git repositories?

To safely remove OS cruft across repositories, run a dry-run cleanup to preview deletions, then execute with the --fix option to delete only untracked, non-submodule junk files like .DS_Store and editor backups.

Can I delete untracked junk files fleet-wide without accidentally removing git-tracked work?

Yes, you can delete untracked junk files fleet-wide without removing git-tracked work because the cleanup process checks git-tracked status and submodule boundaries, ensuring only ignored or untracked OS cruft is targeted.

What is the best way to automate periodic cleanup of OS cruft and editor backups in a repository fleet?

The best way to automate periodic cleanup of OS cruft is using a /loop cadence to schedule conservative, no-prompt maintenance that keeps repositories tidy by regularly removing accumulated editor backups and untracked files.

Does the fleet cleanup process delete files immediately or does it perform a dry-run first?

The fleet cleanup process performs a dry-run by default to preview which untracked junk files will be deleted, requiring an explicit --fix option to authorize and execute the actual deletions across the fleet.

Will cleaning up OS cruft affect the contents of my git submodules?

Cleaning up OS cruft will not affect your git submodules because the cleanup mechanism explicitly checks submodule boundaries, ensuring submodule contents remain untouched while only removing untracked junk files.

How do I preview which junk files will be removed before applying a fleet-wide cleanup?

To preview which junk files will be removed before a fleet-wide cleanup, execute the tidy-files script in its default dry-run mode, which lists all targeted untracked files without deleting them until --fix is passed.