| name | document-organizer |
| description | Organizes mixed document files (PDF, PPTX, DOCX) into subject-based folders by analyzing content. Use this skill when sorting, categorizing, or organizing documents into topic folders. |
Document Organizer
Sorts documents of various formats into predefined subject folders based on content analysis.
Workflow
- Inventory all files in the source directory
- Extract text from each file format:
- PDF: use PyPDF2 to extract text from first pages
- DOCX: use python-docx to read paragraphs
- PPTX: use python-pptx to read slide text
- Classify each file using keyword-based scoring (see pdf-classifier skill)
- Move files to target folders using shutil.move()
- Verify all files are moved, none left behind
Target Folder Structure
papers/
├── LLM/
├── trapped_ion_and_qc/
├── black_hole/
├── DNA/
└── music_history/
Key Principles
- Never rename files — preserve original filenames
- Never modify file content
- Each file goes to exactly one folder
- If a file doesn't clearly match any of the first 4 categories, assign it to
music_history (the catch-all)
- Process all file types (PDF, DOCX, PPTX) with format-appropriate text extraction
Python Dependencies
PyPDF2 for PDFspython-docx for DOCX filespython-pptx for PPTX files- All available via pip if not already installed
