folder-comparison

Compare two directories for content and structural identity using rclone and diff.

1|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/Baneeishaque/ai-agents --skill folder-comparison
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: folder-comparison
Source: https://github.com/Baneeishaque/ai-agents/tree/main/.agent/skills/folder-comparison
Command: npx skills add https://github.com/Baneeishaque/ai-agents --skill folder-comparison

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill guarantees that two directories are identical in content and structure, preventing data loss or corruption.

Core Features & Use Cases

  • Content Verification: Uses rclone to perform hash-based checks for identical file content.
  • Structural Verification: Employs diff for a byte-by-byte recursive comparison of directory structures.
  • Noise Filtering: Automatically ignores macOS .DS_Store files to avoid false positives.
  • Use Case: After backing up a critical project folder, use this Skill to confirm that the backup is a perfect replica of the original.

Quick Start

Compare the contents of the '/path/to/source/folder' and '/path/to/destination/folder' directories.

Frequently Asked Questions about folder-comparison

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

FAQPage Schema
How do I verify directory data integrity after a file synchronization?

You can verify directory data integrity by comparing two directories for content-level consistency and structural identity using rclone and diff. This checks data duplicity and integrity through hash-based and byte-by-byte checks.

What is the best way to compare two directories for content consistency?

The best way to compare directories for content consistency is using rclone for hash-based checks and diff for byte-by-byte recursive comparison. This provides literal, non-summarized reports of file deltas.

How do I run a byte-by-byte directory comparison without false positives from macOS?

To run a byte-by-byte directory comparison without false positives, the process automatically ignores macOS .DS_Store files. This noise filtering ensures structural verification focuses only on actual content differences.

Does rclone check for structural identity or just file content?

Rclone checks for identical file content using hash-based verification, while diff handles structural identity through a recursive byte-by-byte comparison. Together they ensure both directory structure and content match perfectly.

Why does my directory comparison show file deltas for identical backups?

Your directory comparison might show file deltas due to macOS system noise. The verification process handles this by excluding .DS_Store files, ensuring only literal, non-summarized reports of true content differences.

Can I get a literal report of file deltas instead of a summarized comparison?

Yes, this directory comparison process provides literal, non-summarized reports of file deltas. It verifies data duplicity and integrity through hash-based and byte-by-byte checks, giving you exact discrepancy details.