bel-show-crm-file

name	bel-show-crm-file
description	This skill should be used when the user wants to view, display, or show a file stored in the CRM database. This is an orchestration skill that combines downloading from the database and opening with the OS default application. Triggers on requests like "show me the contract from CRM", "display the image from the database", "view the PDF for company X", or "open the attachment from the database".

Show File from CRM Database

View files stored in the CRM database by downloading them to disk and opening them in the default application. This is an orchestration skill that combines the download and open workflows.

When to Use This Skill

Use this skill when the user wants to:

• View a file from the CRM database
• Display a document/image/PDF from the database
• Show an attachment stored in the database
• Open a file that's currently in the database

Trigger phrases:

• "Show me the contract from the database"
• "Display the PDF for company Acme Corp"
• "View the image from CRM"
• "Open the attachment for event ID 5"
• "Let me see the file in the database"
• "Show the document stored for person ID 123"

Do NOT use this skill if:

• The user only wants to download (use bel-download-file-from-crm-db)
• The file is already on disk (use bel-open-file)
• The user explicitly says "download" but not "view/show/display"

How to Use This Skill

This skill orchestrates two other skills in sequence. Do NOT write a new script - instead, use the existing skills.

Workflow Overview

1. Download file from database → 2. Open file with OS default app
   (bel-download-file-from-crm-db)    (bel-open-file)

Step-by-Step Process

Step 1: Invoke the Download Skill

Use the bel-download-file-from-crm-db skill to download the file from the database:

1. Use bel-crm-db to query and find the file_id
2. Execute: python scripts/download_file_from_db.py <file_id>
3. Capture the saved file path from the output

Step 2: Invoke the Open Skill

Use the bel-open-file skill to open the downloaded file:

1. Take the file path from Step 1
2. Execute: python scripts/open_file.py <file_path>
3. The file opens in the default application

Complete Example

# User: "Show me the contract for company ID 42"

# Step 1: Download from database
python /path/to/bel-download-file-from-crm-db/scripts/download_file_from_db.py 789 --quiet
# Output: _RESULTS_FROM_AGENT/contract.pdf

# Step 2: Open the file
python /path/to/bel-open-file/scripts/open_file.py _RESULTS_FROM_AGENT/contract.pdf
# File opens in default PDF viewer

Integration Strategy

This skill does not have its own scripts - it coordinates existing skills:

Required skills:

1. bel-crm-db - For database schema and querying
2. bel-download-file-from-crm-db - For downloading files
3. bel-open-file - For opening files

Coordination pattern:

# Pseudo-code for the workflow
file_id = query_database_for_file_id(entity_identifier)
file_path = download_file_from_db(file_id)
open_file(file_path)

Example Workflows

Workflow 1: Show a specific file by ID

User: "Show me file ID 789 from the database"

1. Invoke: bel-download-file-from-crm-db
   - python scripts/download_file_from_db.py 789 --quiet
   - Result: _RESULTS_FROM_AGENT/document.pdf

2. Invoke: bel-open-file
   - python scripts/open_file.py _RESULTS_FROM_AGENT/document.pdf
   - File opens in PDF viewer

3. Report to user: "✅ Opened document.pdf"

Workflow 2: Show a company's contract

User: "Show me the contract for Acme Corp"

1. Use bel-crm-db to query:
   - Find company_site_id for "Acme Corp"
   - Find file_id via company_site_file junction table
   - Result: file_id = 456

2. Invoke: bel-download-file-from-crm-db
   - python scripts/download_file_from_db.py 456 --quiet
   - Result: _RESULTS_FROM_AGENT/acme_contract.pdf

3. Invoke: bel-open-file
   - python scripts/open_file.py _RESULTS_FROM_AGENT/acme_contract.pdf
   - Contract opens in PDF viewer

4. Report to user: "✅ Opened acme_contract.pdf for Acme Corp"

Workflow 3: Show an event image

User: "Display the image from event 5"

1. Use bel-crm-db to query:
   - Find file_id via event_file where event_id = 5
   - Result: file_id = 234

2. Invoke: bel-download-file-from-crm-db
   - python scripts/download_file_from_db.py 234 --quiet
   - Result: _RESULTS_FROM_AGENT/event_photo.jpg

3. Invoke: bel-open-file
   - python scripts/open_file.py _RESULTS_FROM_AGENT/event_photo.jpg
   - Image opens in default viewer

4. Report to user: "✅ Opened event_photo.jpg"

Error Handling

Handle errors at each step:

Step 1 - Download errors:

• File ID not found in database
• Database connection failure
• Disk space issues

Step 2 - Open errors:

• File not found (download failed silently)
• No default application for file type
• Permission denied

Recovery strategy:

• If download fails, report error and stop
• If open fails, inform user where file was saved so they can open manually

When to Use Each Skill

Decision tree for file operations:

User wants to work with a file
    │
    ├─ File is in database?
    │   ├─ Yes: User wants to view/show/display?
    │   │   ├─ Yes → Use bel-show-crm-file (this skill)
    │   │   └─ No (just download) → Use bel-download-file-from-crm-db
    │   │
    │   └─ No: File already on disk
    │       └─ User wants to open? → Use bel-open-file

Technical Notes

This skill is orchestration only:

• No custom scripts needed
• Chains existing skills together
• Provides a user-friendly workflow for common use case
• Simplifies the "view database file" operation

Benefits of this approach:

• Single skill for the most common scenario
• Reuses existing, tested scripts
• Clear separation of concerns
• Easy to maintain and extend