outlook-to-mdlisted
Install: claude install-skill dbhq-uk/outlook-skill
# Outlook Email to Markdown
Turn Outlook mail into an organised, integrity-verified archive of markdown files, raw email backups, and attachments. Reads a PST export, or a directory of `.eml` files - which is how live mail arrives, via the `outlook` skill's `export` verb. Supports full extraction and incremental append mode, so one archive can span both.
## Prerequisites
- Python virtual environment set up (run setup.sh if not done)
- `readpst` (system tool from pst-utils), to read a `.pst`. A directory of `.eml` files does not need it
### First-Time Setup
```bash
# Set up Python environment (one-time)
${CLAUDE_SKILL_DIR}/setup.sh
```
### System Dependency for PST Files
`readpst` is the only PST reader. If `setup.sh` reports it missing, ask the user to install it:
```bash
# Ubuntu/Debian
sudo apt install pst-utils
# macOS
brew install libpst
```
## Extraction Operations
### Full Extraction
Extract all emails from a PST file into markdown:
```bash
# Basic extraction
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/outlook_to_md.py /path/to/file.pst /path/to/output/
# Verbose output with progress
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/outlook_to_md.py /path/to/file.pst /path/to/output/ --verbose
# Include deleted items
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/outlook_to_md.py /path/to/file.pst /path/to/output/ --include-deleted --verbose
# Render every date in one zone (default: the offset each me