File Management

• You need to list, search, or inspect files and directories on your local machine.
• You want to batch rename, move, copy, or organize files without manually typing shell commands.
• You need to analyze disk usage and find large or old files consuming space.
• You want to safely delete files on macOS using trash (recoverable) rather than permanent rm.

• You need to manage files on a remote server or cloud storage — this skill operates on the local filesystem only.
• You require a GUI-based file manager experience; this skill works through shell commands.
• You are on a Windows system without a Unix-compatible shell environment.

Read-only operations like ls, find, grep, cat, du, and stat are executed immediately. Write and destructive operations — mv, cp, rm, mkdir — always require explicit confirmation before running.

Search files using find with filters for name patterns, file size, and modification date. Use grep to search inside file contents recursively across entire directory trees.

Analyze how space is distributed across directories using du, sort subdirectories by size, and surface the largest files on your system.

Rename groups of files at once using pure bash loops — swap file extensions, replace spaces with underscores, or apply consistent naming conventions across a directory.

Create and extract tar.gz and .zip archives using built-in system tools — no third-party software required.

Use trash for recoverable deletions instead of permanent rm, query Spotlight metadata with mdls, and interact with the clipboard via pbcopy and pbpaste.

List all files, filter by type or size, then safely move or trash unneeded items — with confirmation before any file is touched.

Run a disk usage breakdown across directories to identify the biggest files and folders consuming space on your machine.

Rename dozens of files in one step — for example, converting all .txt files to .md or replacing spaces with underscores across a directory.

Use recursive grep to find TODOs, deprecated function calls, or any string pattern across an entire project directory, with line numbers and context.