File Master - Mac File Management Expert
Integrate the three skills of disk-cleaner, file-organizer, and doc-mindmap into a three-stage workflow of "Clean → Organize → Analyze" to handle Mac file management in one go.
When to Use
Use this skill only when users explicitly need a multi-stage combined process. If users only want to perform a single task (only disk cleaning, only file organization, only document analysis), please directly use the corresponding sub-skill (disk-cleaner / file-organizer / doc-mindmap) instead of file-master.
Use this skill when users:
- Explicitly request combined operations: "Clean first then organize", "After cleaning, help me categorize files"
- Say "Help me fully organize my computer", "Do a file deep clean" (emphasize comprehensiveness/completeness)
- Want to complete at least two stages of cleaning + organizing + archiving in one go
- Say "My disk is almost full and I have a bunch of unorganized files" (multiple demands exist)
Do NOT use this skill when users only say:
- "Clean disk" / "Free up space" → Use disk-cleaner
- "Organize files" / "Organize Downloads folder" → Use file-organizer
- "Analyze documents" / "Document conversion" → Use doc-mindmap
Trigger keywords: full computer organization, one-stop organization, file deep clean, clean first then organize, complete file management workflow
Features
- Three-stage workflow - Clean (free up space) → Organize (categorize files) → Analyze (intelligent document analysis)
- Flexible selection - Execute all three stages, or any combination of stages
- Preview first - Preview before executing each stage, giving users full control
- Stage linkage - The organization path from Phase 2 is automatically passed to Phase 3 for analysis
- Fault-tolerant design - Failure or skipping of a stage does not affect subsequent stages
- Final report - Summarize results of all three stages at a glance
Usage
Trigger with natural language, Claude will guide you through the entire process:
Help me fully organize my computer → Execute all three stages
Help me clean the disk then organize files → Phase 1 + Phase 2
Organize files then do document analysis → Phase 2 + Phase 3
Only help me do document analysis → Phase 3
Dependencies
Dependencies of the three sub-skills:
Phase 1 - disk-cleaner
- macOS, Homebrew
- Mole (
brew install tw93/tap/mole
- Python:
Phase 2 - file-organizer
Phase 3 - doc-mindmap
- Python 3.10+
- markitdown:
pip install 'markitdown[all]'
- Ollama: +
- requests:
Claude Workflow
When Claude uses this skill, strictly follow the steps below.
Step 0: Welcome + Stage Selection
Show users an overview of the three stages and ask which stages to execute:
Mac File Master - Three-stage Workflow
Phase 1 "Clean" - Disk cleaning to free up hard drive space (disk-cleaner)
Phase 2 "Organize" - File organization to categorize Downloads folder (file-organizer)
Phase 3 "Analyze" - Document analysis with batch conversion + summarization + classification (doc-mindmap)
Please select:
1. Execute all (recommended)
2. Select partial stages
3. Execute only one stage
If users select partial stages, record the list of stages to execute and skip the unselected ones.
Phase 1 "Clean" - Disk Cleaning
Use the disk-cleaner skill to free up hard drive space.
1.1 Preview Scan
bash
python disk-cleaner/scripts/mole_cleaner.py --check
python disk-cleaner/scripts/mole_cleaner.py --preview
Show users the scan results, including the amount of cleanable space and categories.
1.2 Select Cleaning Tier
Please select a cleaning tier:
1. Air - Safest, only clean browser cache and logs
2. Pro - Recommended, balance safety and space
3. Max - Maximize space release
4. Skip this stage
1.3 Execute Cleaning
Execute after user selects a tier:
bash
python disk-cleaner/scripts/mole_cleaner.py --clean --tier <air|pro|max> --confirm
1.4 Phase 1 Summary
Report how much space was freed, then proceed to Phase 2.
Phase 2 "Organize" - File Organization
Use the file-organizer skill to categorize files.
2.1 Preview Scan
bash
python file-organizer/scripts/file_organizer.py --status
Show users the status of files in the Downloads folder.
2.2 Select Organization Mode
Please select an organization mode:
1. Manual mode - Create smart folders, drag and drop to organize yourself
2. Auto mode - Automatically categorize by type into Desktop folders
3. Skip this stage
2.3 Execute Organization
Manual mode:
bash
python file-organizer/scripts/file_organizer.py --manual
Auto mode:
bash
# Preview first
python file-organizer/scripts/file_organizer.py --auto --dry-run
# Execute after user confirmation
python file-organizer/scripts/file_organizer.py --auto
After executing auto mode, the organization path is automatically written to the disk-cleaner whitelist to protect organized files.
2.4 Phase 2 Summary
Report how many files were organized and how many categories were created.
Record the output path (e.g.,
~/Desktop/Organized Files-YYYYMMDD/
) for use in Phase 3.
Phase 3 "Analyze" - Document Analysis
Use the doc-mindmap skill for intelligent document analysis.
3.0 Determine Target Directory
- If Phase 2 was executed: Automatically use the output path from Phase 2
- If Phase 2 was skipped: Ask user which directory to analyze
3.1 Preview Documents
bash
python doc-mindmap/scripts/doc_converter.py <target path> --preview
Show document list, type distribution, and duplicate file detection results.
3.2 Execute Conversion
bash
python doc-mindmap/scripts/doc_converter.py <target path> --convert --confirm
3.3 Generate Summaries
bash
python doc-mindmap/scripts/doc_converter.py <target path> --summarize
3.4 Three-Dimensional Classification
bash
# Show classification results first
python doc-mindmap/scripts/doc_converter.py <target path> --organize
Ask users whether to use AI-suggested filenames. If yes:
bash
python doc-mindmap/scripts/doc_converter.py <target path> --organize --rename
3.5 Finder Preview
Ask users whether to preview the categorized directory in Finder:
bash
cp -a <.summaries/schemes> ~/Desktop/Document Classification-$(date +%Y%m%d)
open ~/Desktop/Document Classification-$(date +%Y%m%d)
3.6 Phase 3 Summary
Report how many documents were converted, how many summaries were generated, and an overview of classification results.
Final Summary
Summarize results of all three stages and show users:
=== Mac File Master - Completion Report ===
Phase 1 "Clean": Freed X.XX GB of disk space
Phase 2 "Organize": Organized N files into M categories
Phase 3 "Analyze": Converted K documents, generated K summaries, three-dimensional classification completed
All stages executed!
Mark skipped stages as "Skipped", and failed stages with error reasons.
Error Handling
- When dependencies for a stage are not installed, prompt users with installation commands and ask whether to skip the stage and continue
- When a stage execution fails, record error information and ask users whether to proceed to the next stage
- Phase 3 depends on the Ollama local model; if not installed, skip the summarization and classification steps and only perform conversion
Credits
- disk-cleaner - Disk Cleaning
- file-organizer - File Organization
- doc-mindmap - Intelligent Document Analysis