process-file

# Process File Skill

Generic file processing Skill supporting multiple file formats for parsing and intelligent archiving, fully integrated with the AkashicRecords governance system.

## When to use this Skill

- User says "read", "process"
- User says "archive", "import"
- User provides file path for processing
- User wants to integrate external files into knowledge base
- User provides email, PDF, Office documents, images, etc.

## Workflow

### 1. Initialization - Read Preferences

**Check claude.md**:
1. Read current project's claude.md
2. Look for `file-handling-preferences` related record
3. If path found, read preferences file

**If no preferences file exists**:
1. Ask user: "This is the first time using process-file skill in this project. Where would you like to create the file handling preferences?"
2. Suggest default location: `file-handling-preferences.md` in project root
3. After user confirmation, create file and record location in claude.md

**Preferences file structure**:
- Processing pattern records (by file type and content category)
- Auto processing settings (whether to allow saving without confirmation)
- Historical processing records

### 2. File Type Detection

**Detect file type**:
Determine processing method based on file extension:

| Type | Extension | Processing Tool |
|------|-----------|-----------------|
| Email | .eml | `mu view <filepath>` |
| PDF | .pdf | `markitdown <filepath>` |
| Word | .docx | `markitdown <filepath>` |
| PowerPoint | .pptx | `markitdown <filepath>` |
| Excel | .xlsx | `markitdown <filepath>` |
| Image | .jpg, .png, .gif, .webp, .bmp | Read tool (language model direct read) |
| Audio | .mp3, .wav, .m4a, .aac, .ogg | Ask user |
| Video | .mp4, .mov, .avi, .webm | Ask user |

**Tool availability check**:
- Check if required tools are installed before execution
- If `mu` not installed: Prompt `Please install maildir-utils: sudo apt install maildir-utils`
- If `markitdown` not installed: Prompt `Please install markit