bel-open-file

This skill should be used when the user wants to open or preview a file that already exists on disk using the operating system's default application. Triggers on requests like "open this file", "show me the PDF", "preview the image", "view the document", or "display the spreadsheet". Works with all file types including PDFs, images, documents, emails, and spreadsheets.

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 20, 2025⬇️2downloads

When & Why to Use This Skill

The 'bel-open-file' skill enables Claude to seamlessly open or preview any local file using the operating system's default application. It acts as a bridge between AI-driven workflows and the user's desktop environment, supporting a wide range of formats including PDFs, spreadsheets, images, and emails across macOS, Windows, and Linux. This skill is essential for users who need to immediately inspect or interact with files generated or managed by an agent without manual navigation.

Use Cases

  • Instantly previewing generated business reports, such as Excel spreadsheets or PDF summaries, immediately after the agent creates them.
  • Opening legal contracts, Word documents, or technical specifications for review during a collaborative document editing session.
  • Viewing visual assets like PNG, JPG, or SVG files in the system's default image viewer to verify design outputs.
  • Accessing archived email files (.eml or .msg) in the native mail client to retrieve historical communication context or attachments.
  • Inspecting technical logs, markdown files, or configuration documents during development, debugging, or data analysis tasks.
namebel-open-file
descriptionThis skill should be used when the user wants to open or preview a file that already exists on disk using the operating system's default application. Triggers on requests like "open this file", "show me the PDF", "preview the image", "view the document", or "display the spreadsheet". Works with all file types including PDFs, images, documents, emails, and spreadsheets.

Open File with OS Default Application

Open any file on disk using the operating system's default application for viewing.

When to Use This Skill

Use this skill when the user wants to:

  • Open a file that already exists on disk
  • Preview a document, image, PDF, or spreadsheet
  • View a file with the default application
  • Display a file that has already been saved

Trigger phrases:

  • "Open the file contract.pdf"
  • "Show me the document in _RESULTS_FROM_AGENT/report.docx"
  • "Preview the image logo.png"
  • "View this spreadsheet"
  • "Display the PDF I downloaded earlier"
  • "Open the email attachment"

Do NOT use this skill if:

  • The file needs to be downloaded from the database first (use bel-download-file-from-crm-db instead)
  • The user wants to view a file from the database (use bel-show-crm-file instead)
  • The file doesn't exist on disk yet

How to Use This Skill

Quick Start

Simply execute the script with the file path:

python scripts/open_file.py <file_path>

Examples:

# Open a PDF
python scripts/open_file.py _RESULTS_FROM_AGENT/contract.pdf

# Open an image
python scripts/open_file.py _DATA_FROM_USER/logo.png

# Open a spreadsheet
python scripts/open_file.py _RESULTS_FROM_AGENT/report.xlsx

# Open an email file
python scripts/open_file.py _DOWNLOADS_FROM_AGENT/message.eml

# Quiet mode (suppress output)
python scripts/open_file.py document.pdf --quiet

Supported File Types

The script works with any file type that has a registered default application on the operating system:

Documents:

  • PDF: .pdf
  • Word: .docx, .doc
  • Text: .txt, .md, .log
  • Rich Text: .rtf

Spreadsheets:

  • Excel: .xlsx, .xls, .csv
  • Numbers: .numbers

Images:

  • Common formats: .png, .jpg, .jpeg, .gif, .bmp, .svg
  • Professional formats: .tif, .tiff, .webp

Emails:

  • Email messages: .eml, .msg
  • Outlook: .pst

Archives:

  • Compressed files: .zip, .tar, .gz, .7z

Presentations:

  • PowerPoint: .pptx, .ppt
  • Keynote: .key

And many more! If the OS has a default application registered, this skill will open it.

Cross-Platform Support

The script automatically detects the operating system and uses the appropriate command:

macOS:

  • Command: open <file>
  • Opens files with the default macOS application

Linux:

  • Command: xdg-open <file>
  • Opens files with the default Linux desktop application

Windows:

  • Command: os.startfile(<file>)
  • Opens files with the default Windows application

Technical Details

How It Works

  1. Validates that the file exists on disk
  2. Resolves to absolute path for reliability
  3. Detects the operating system
  4. Executes the appropriate OS command to open the file
  5. Returns success/error status

Error Handling

Common errors:

  • File not found: The specified file path doesn't exist
  • Permission denied: Insufficient permissions to access the file
  • No default application: No application registered for that file type
  • Command not found: xdg-open not available on Linux (rare)

Integration with Other Skills

This skill integrates with:

  • bel-download-file-from-crm-db: First download, then open
  • bel-show-crm-file: Orchestration skill that uses both download and open
  • Any skill that produces output files that need to be viewed

Example Workflows

Workflow 1: Open a specific file

User: "Open the contract.pdf file"

1. Verify file exists at specified path
2. Run: python scripts/open_file.py contract.pdf
3. File opens in default PDF viewer

Workflow 2: Preview downloaded results

User: "Show me the report I generated"

1. Identify the file path (e.g., _RESULTS_FROM_AGENT/report.xlsx)
2. Run: python scripts/open_file.py _RESULTS_FROM_AGENT/report.xlsx
3. File opens in default spreadsheet application

Workflow 3: View user-provided data

User: "Display the image I uploaded"

1. Find the image in _DATA_FROM_USER/
2. Run: python scripts/open_file.py _DATA_FROM_USER/logo.png
3. Image opens in default image viewer

Notes on Email Files

Email files (.eml, .msg) work well with this skill:

  • .eml files: Standard email format, opens in default mail client (Mail.app on macOS, Outlook on Windows, Thunderbird on Linux)
  • .msg files: Outlook format, opens in Outlook or compatible email client

The operating system handles the rendering and display automatically.