files-buddy
Installation
SKILL.md
Files Buddy
Safe filesystem organization and cleanup. Delegates to best-in-class CLI tools for deduplication, renaming, archiving, and analysis. Cloud drives (iCloud, Google Drive, Dropbox, OneDrive) are first-class citizens with auto-detection and adjusted safety.
Scope: File organization, cleanup, renaming, deduplication, archiving, and analysis. NOT for shell script generation (shell-scripter), CI/CD pipelines (devops-engineer), or database work (database-architect).
Canonical Vocabulary
| Term | Definition |
|---|---|
| dry-run | Preview via tool's native mode (fclones group, f2 default, organize sim, detox -n) |
| manifest | JSON log at ~/.files-buddy/manifests/ enabling undo and discovery |
| blast radius | Total file count and size affected by an operation |
| protected path | Hard-blocked (system) or escalated-confirmation directory |
| trash | Reversible deletion via gomi / OS trash / .files-buddy-trash/ |
Related skills