major-ai-skills/skills/dropover/gemini.md

Installable agentic skills / AI agent skills (SKILL.md) for Claude Code, Cursor, Codex CLI, Gemini CLI & Antigravity - 402+ professional app, token-efficiency, and common-sense skills. SEO/GEO ready.

---

title: "Dropover macOS Drag Shelf Utility AI Skill Guide (Gemini)"
description: "Comprehensive operational skill specification for Google Gemini to visually diagnose, automate, script, and troubleshoot Dropover floating shelves, multi-item stacks, Quick Look previews, and cloud upload menus."
category: "Temporary Floating Drag Shelf Utility"
tags: ["dropover", "macos", "floating-shelf", "gemini", "quick-look", "drag-drop-ui"]
---


# Dropover macOS Drag Shelf Utility AI Skill Guide (Gemini)

## Overview & Engine Architecture
Dropover introduces a floating shelf user interface designed for effortless drag-and-drop orchestration across macOS displays and applications. Gemini acts as an AI macOS Workflow Reviewer and UI Systems Auditor, specializing in **multimodal Dropover shelf inspection**, **multi-item stack visual validation**, **Quick Look inline preview diagnostics**, and **action menu workflow optimization**.

### Visual Analytics & Shelf Interface Stack

```
┌─────────────────────────────────────────────────────────────┐
│                 Dropover Visual Operations                  │
│                                                             │
│  Floating Shelf HUD & Stack Visualization                   │
│  ├── Floating Shelf Window (Translucent Frosted Glass HUD)  │
│  ├── Multi-Item Card Stack (Fan Out / Collapsed Carousel)   │
│  └── Quick Look Preview Overlay (Spacebar Instant View)     │
│                                                             │
│  Action Bar & Export Menus                                  │
│  ├── Shelf Action Hub (Copy, Compress, Convert, Share Link) │
│  ├── Cloud Upload Progress Indicator (Dropover Cloud)       │
│  └── Multi-Shelf Organization Grid (Dock / Side Pinning)    │
└─────────────────────────────────────────────────────────────┘
```

---


## Operational Capabilities & Agent Directives

1. **Multimodal Shelf UI Inspection**: Analyze screenshots of Dropover floating shelves to verify item count badges, thumbnail generation integrity, file size labels, and cloud upload status indicators.
2. **Stack Fan-Out Diagnostics**: Review multi-item shelf expansions to ensure individual file cards can be dragged out independently without disturbing the remaining collection.
3. **Drop Action Automation**: Advise users on quick contextual shelf actions (*e.g. Create Zip Archive, Convert to WebP/PNG, Extract Text via Live Text OCR*).
4. **Docking & Pinning Validation**: Troubleshoot floating shelf positioning, auto-collapse timers, and screen edge docking behaviors.

---


## Production Python Automation: Automated Dropover Preference Auditor (`.plist`)

Execute this script to verify that Dropover's floating shelf presentation and trigger settings are configured for maximum productivity:

```python
"""
Dropover macOS Settings & Preference Auditor
Inspects com.extendedmac.Dropover-mac.plist for recommended shelf parameters.
"""

import os
import plistlib

PREF_PATH = os.path.expanduser("~/Library/Preferences/com.extendedmac.Dropover-mac.plist")

def audit_dropover_settings():
    if not os.path.exists(PREF_PATH):
        print(f"Error: Dropover preferences '{PREF_PATH}' not found.")
        print("Note: Launch Dropover to generate configuration preferences.")
        return

    print("--- [AUDITING DROPOVER FLOATING SHELF SETTINGS] ---")
    try:
        with open(PREF_PATH, "rb") as f:
            prefs = plistlib.load(f)

        shake_trigger   = prefs.get("TriggerShakeEnabled", True)
        all_spaces      = prefs.get("KeepOnScreenAcrossAllSpaces", True)
        auto_collapse   = prefs.get("AutoCollapseShelves", False)
        sound_effects   = prefs.get("PlaySoundEffects", True)

        print(f"• Shake Cursor Trigger:       {'✅ ENABLED' if shake_trigger else '⚠️ DISABLED'}")
        print(f"• Display Across All Spaces:  {'✅ ENABLED' if all_spaces else '🚨 DISABLED (Shelves will hide on space switch)'}")
        print(f"• Auto-Collapse Shelves:      {'ENABLED' if auto_collapse else 'DISABLED'}")
        print(f"• Sound Feedback Effects:     {'ENABLED' if sound_effects else 'DISABLED'}")

    except Exception as e:
        print(f"Error reading plist: {e}")

if __name__ == "__main__":
    audit_dropover_settings()
```

---


## Technical Troubleshooting Matrix

| Issue & Visual Signature | Root Cause Analysis | Diagnostic & Resolution Pathway |
| :--- | :--- | :--- |
| **Dropover Shelf Overlaps Other Fullscreen Windows** | Floating window level set to `screenSaver` or `.statusBar` rather than `.floating`. | In Dropover Preferences $\rightarrow$ **Appearance**, ensure Window Level is set to **Standard Floating**. |
| **Thumbnails Show Generic Blank Icons** | macOS QuickLook thumbnail cache (`com.apple.quicklook.ThumbnailsAgent`) is corrupted. | In Terminal, run: `qlmanage -r cache && killall -9 quicklookd`. |
| **Shelf Auto-Dismisses Before Dropping** | Auto-close timer expired while user was navigating files in Finder. | In Dropover Preferences $\rightarrow$ **Shelves**, increase the **Auto-Dismiss Idle Shelves** timeout or set to **Never**. |
| **Cloud Upload Fails: `Upload Error` on Shelf** | File size exceeds Dropover Cloud upload tier limits or network proxy blocking connection. | In Shelf Actions $\rightarrow$ Select **Copy File Path** or save locally instead of cloud sharing. |

---


## Command Line Syntax & Server Control

```bash
# Launch Dropover from Terminal
open -a Dropover

# Reset macOS QuickLook Thumbnail Cache
qlmanage -r cache
```

### Key Configuration Locations
- **Preferences Plist**: `~/Library/Preferences/com.extendedmac.Dropover-mac.plist`
- **Application Support Cache**: `~/Library/Application Support/com.extendedmac.Dropover-mac`

---


## Agent Operational Directive
> **MANDATORY**: For multi-display setups, verify that "Keep shelves on screen across all Spaces" is enabled to prevent shelves from disappearing when switching Mission Control desktops.