file-operations

Production-grade file operations - permissions, find, archives, rsync

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill provides a comprehensive framework for mastering production-grade file system operations. It focuses on essential Linux/Unix utilities including advanced permission management, efficient file searching with find and fd, professional archiving techniques, and robust data synchronization using rsync. Designed for reliability and safety, it helps users implement industry-standard patterns for file manipulation and IT automation.

Use Cases

  • Automating security hardening by recursively auditing and fixing file permissions (chmod/chown) across web server directories.
  • Implementing intelligent data cleanup tasks that identify and remove obsolete logs or temporary files based on specific age, size, or naming patterns.
  • Streamlining deployment workflows by creating compressed backups and synchronizing assets between local and remote environments using rsync mirroring.
  • Managing complex storage structures through the efficient use of symbolic links and high-performance file discovery tools.
namefile-operations
descriptionProduction-grade file operations - permissions, find, archives, rsync
sasmp_version"1.3.0"
bonded_agent03-file-operations
bond_typePRIMARY_BOND
version"2.0.0"
difficultyintermediate
estimated_time"5-7 hours"

File Operations Skill

Master file system operations with production-ready patterns

Learning Objectives

After completing this skill, you will be able to:

  • Manage file permissions (chmod, chown)
  • Search files efficiently with find and fd
  • Create and extract archives (tar, zip)
  • Synchronize files with rsync
  • Work with symbolic and hard links

Prerequisites

  • Bash basics
  • Understanding of file systems
  • Command line navigation

Core Concepts

1. Permission Management

# Numeric notation
chmod 755 script.sh       # rwxr-xr-x
chmod 644 file.txt        # rw-r--r--
chmod 600 secret.key      # rw-------

# Symbolic notation
chmod u+x script.sh       # Add execute for owner
chmod g-w file.txt        # Remove write for group
chmod a+r public.txt      # Add read for all

# Ownership
chown user:group file
chown -R user:group dir/

# Common patterns
chmod 600 ~/.ssh/id_rsa   # SSH private key
chmod 755 /var/www/html/  # Web directory

2. Find Command

# By name
find . -name "*.txt"
find . -iname "*.TXT"     # Case insensitive

# By type
find . -type f            # Files
find . -type d            # Directories
find . -type l            # Symlinks

# By size/time
find . -size +100M        # Larger than 100MB
find . -mtime -7          # Modified in 7 days

# Actions
find . -name "*.tmp" -delete
find . -type f -exec chmod 644 {} +

3. Archive Operations

# Create archives
tar -cvf archive.tar dir/
tar -czvf archive.tar.gz dir/   # gzip
tar -cjvf archive.tar.bz2 dir/  # bzip2

# Extract archives
tar -xvf archive.tar
tar -xzvf archive.tar.gz -C /dest/

# ZIP
zip -r archive.zip dir/
unzip archive.zip

4. Rsync

# Local sync
rsync -avz source/ dest/

# Remote sync
rsync -avz local/ user@host:/remote/

# With delete (mirror)
rsync -avz --delete source/ dest/

# Dry run
rsync -avzn source/ dest/

Common Patterns

Safe Delete Pattern

# With confirmation
rm -i file.txt

# With variable check
rm -rf "${DIR:?}/"   # Fails if DIR empty

Backup Pattern

# Timestamped backup
backup() {
    local src="$1"
    local timestamp=$(date +%Y%m%d_%H%M%S)
    cp -a "$src" "${src}.${timestamp}.bak"
}

Find and Process

# Fix permissions
find /var/www -type d -exec chmod 755 {} +
find /var/www -type f -exec chmod 644 {} +

# Delete old files
find /tmp -type f -mtime +7 -delete

Anti-Patterns

Don't Do Why
rm -rf $VAR/ rm -rf "${VAR:?}/" Empty VAR = delete /
find | xargs rm find -delete Handles spaces
cp -r for sync rsync -a rsync is smarter

Practice Exercises

  1. Permission Fixer: Script to fix web dir permissions
  2. Old File Cleaner: Remove files older than N days
  3. Backup Script: Timestamped backup with rotation
  4. Sync Tool: Two-way directory sync

Troubleshooting

Common Errors

Error Cause Fix
Permission denied Wrong permissions Check with ls -la
No such file Path typo Verify path exists
Directory not empty rm without -r Add -r flag
Cross-device link Hard link across fs Use symlink

Debug Techniques

# Check permissions
stat file.txt
ls -la file.txt

# Trace find
find . -name "*.txt" -print

# Dry-run rsync
rsync -avzn source/ dest/

Safety Guidelines

  1. Always dry-run rsync with --delete first
  2. Quote paths with spaces: "$path"
  3. Verify paths before rm -rf
  4. Use trash instead of rm when possible
  5. Backup before bulk operations

Resources